API v1.0 — bemorepay

Общие требования

Base URL https://api.bemorepay.ru Production

При обращениях к API необходимо обеспечить следующие заголовки в каждом запросе:

Во всех запросах передавать заголовок Content-Type: application/json
В методах, требующих аутентификацию, передавать идентификатор терминала ТСП в заголовке Authorization: Bearer {terminal_token}

Токен терминала

Токен представляет собой уникальный статический ключ доступа длиной 44 символа, состоящий из букв латинского алфавита и цифр. Выдаётся однократно при регистрации терминала и действует на всё время его работы — замена не предусмотрена. Используется как Bearer-токен в заголовке Authorization во всех методах, требующих аутентификацию.

Способы интеграции

Мерчант создаёт POST запрос к API bemorepay для формирования ссылки на форму оплаты. В ответ возвращается JSON-объект с результатом выполнения запроса.

Если запрос выполнен успешно, в поле formUrl будет возвращён URL страницы оплаты. Далее мерчант загружает этот URL в iframe или редиректит / открывает новую страницу.

Последовательность для рекуррентных платежей

form создать форму

→

transactions получить token по uuid

→

recurrent платёж по token

→

transactions статус платежа

Метод: form

POST https://api.bemorepay.ru/api/form/ Запрос на создание страницы оплаты

Параметры запроса

Поле	Тип		Описание
orderNumber	int	обязательное	ID транзакции на стороне мерчанта
amount	float	обязательное	Сумма платежа
successUrl	url	обязательное	HTTPS-редирект при успешной оплате
failUrl	url	обязательное	HTTPS-редирект при неуспешной оплате
param1	str100	опциональное	Метка мерчанта
param2	str100	опциональное	Метка мерчанта
param3	str100	опциональное	Метка мерчанта
jsonParams	JSON	опциональное	Дополнительные параметры, если не хватает param1–param3

Запрос

curl -X POST -k \
  -H 'Authorization: Bearer 4VKye****92a19' \
  -H 'Content-Type: application/json' \
  -i 'https://api.bemorepay.ru/api/form/' \
  --data '{
    "orderNumber": "1010020",
    "amount":      "999.00",
    "param1":      "1",
    "param2":      "2",
    "param3":      "3",
    "jsonParams":  "{\"json1\":\"json1\"}",
    "successUrl":  "https://success.io",
    "failUrl":     "https://fail.io"
  }'

Успешный ответ

{
  "status":  true,
  "formUrl": "https://api.bemorepay.ru/api/terminal/019c4d2c-2bf5-70e9-bf8c-69c60cee0bf5",
  "data": {
    "orderNumber": "1010020",
    "amount":      "1.00",
    "successUrl":  "https://success.io",
    "failUrl":     "https://fail.io"
  },
  "runTime": 0.11879205703735352
}

Ответ с ошибкой

{
  "status": false,
  "errors": {
    "orderNumber": ["validation.required"],
    "amount":      ["validation.required"]
  }
}

Метод: payments/recurrent

POST https://api.bemorepay.ru/api/payments/recurrent/ Запрос на создание рекуррентного платежа

Параметры запроса

Поле	Тип		Описание
orderNumber	int	обязательное	ID транзакции на стороне мерчанта
amount	float	обязательное	Сумма платежа
token	uuid	обязательное	Выдаётся после запроса метода `transactions` после привязки карты
description	str100	опциональное	Описание транзакции
param1	str100	опциональное	Метка мерчанта
param2	str100	опциональное	Метка мерчанта
param3	str100	опциональное	Метка мерчанта
jsonParams	JSON	опциональное	Дополнительные параметры, если не хватает param1–param3

Запрос

curl -X POST -k \
  -H 'Authorization: Bearer 4VKye6z*****92a19a3c3' \
  -H 'Content-Type: application/json' \
  -i 'https://api.bemorepay.ru/api/payments/recurrent/' \
  --data '{
    "orderId":     "1010020",
    "amount":      "999.00",
    "token":       "019a256c-3865-721e-b04a-0bd2bdf60db6",
    "description": "description",
    "param1":      "1",
    "param2":      "2",
    "param3":      "3",
    "jsonParams":  "{\"1\":\"1\"}"
  }'

Успешный ответ

{
  "status": true,
  "uuid":   "019c4d2f-0f29-7045-95f0-70b52f2adf06"
}

Ответ с ошибкой

{
  "status":  false,
  "orderId": null,
  "errors":  { "token": ["validation.uuid"] }
}

Метод: transactions

POST https://api.bemorepay.ru/api/transactions/ Запрос на получение статуса привязки или платежа

Параметры запроса

Поле	Тип		Описание
uuid	uuid	обязательное	UUID транзакции или привязки карты

Запрос

curl -X POST -k \
  -H 'Authorization: Bearer 4VKye6zj*****2a19a3c3' \
  -H 'Content-Type: application/json' \
  -i 'https://api.bemorepay.ru/api/transactions/' \
  --data '{"uuid":"01995770-0550-72ba-a2da-95a6cf591b61"}'

Успешный ответ — привязка карты

{
  "status": true,
  "uuid": "019c568d-55cd-7026-951d-e52bf5339123",
  "transactions": [{
    "uuid":                     "019c568d-55cd-7026-951d-e52bf5459123",
    "order_id":                 "2602131",
    "rrn":                      null,
    "status_code":              1,
    "status_description":       "STATUS_SUCCESS",
    "currency":                 "RUB",
    "amount":                   "1.00",
    "card_number_first_six":    "110070",
    "card_number_last_four":    "0333",
    "card_expiration_date_month": "10",
    "card_expiration_date_year":  "33",
    "card_holder_name":          "USER NAME",
    "created_at":               "2025-01-14 12:22:51",
    "transactionData": {
      "param1": "param1",
      "param2": "param2",
      "param3": "param3",
      "data":   "{}"
    },
    "subscriber": {
      "card_number_first_six":    "210223",
      "card_number_last_four":    "0123",
      "card_expiration_date_month": "12",
      "card_expiration_date_year":  "31",
      "card_holder_name":          "USER NAME",
      "card_issuer_name":          "",
      "issuer_bank_country_code":  "",
      "currency":                 "",
      "card_type":                "",
      "token":                    "019c568d-f157-735f-a342-d6b5fa6c0d5f",
      "status_code":              1,
      "created_at":               "2026-11-13 12:31:08"
    }
  }]
}

Успешный ответ — рекуррентный платёж

{
  "status": true,
  "uuid":   "019c4d2f-c46f-7194-913c-24f289c7a2c3",
  "transactions": [{
    "uuid":                     "019c4d2f-c46f-7194-913c-24f289c7a2c3",
    "order_id":                 "3945495_20260211145137",
    "rrn":                      "604214032713",
    "status_code":              1,
    "status_description":       "STATUS_SUCCESS",
    "currency":                 "RUB",
    "amount":                   "496.00",
    "card_number_first_six":    null,
    "card_number_last_four":    null,
    "card_expiration_date_month": null,
    "card_expiration_date_year":  null,
    "card_holder_name":          null,
    "created_at":               "2026-02-11 14:52:43"
  }]
}

Ответ с ошибкой

{
  "status": false,
  "error":  "Authentication error"
}

Документация API

Параметры запроса

Параметры запроса

Параметры запроса