Переводы криптовалюты и ликвидных активов

В Платежном шлюзе разработан специальный сервис "Маршрутизатор платежей" для обработки операций покупки и продажи клиентами криптовалюты и прочих ликвидных активов.

В этих случаях используются P2P переводы со следующими особенностями:

1. При регистрации заказа:
   • передается параметр transactionTypeIndicator со значением C (криптовалюта) илиY (ликвидные активы, отличные от криптовалюты).
   • При передаче transactionTypeIndicator=C/Y необходимо передавать направление перевода: TO_MERCHANT – деньги переводятся от клиента продавцу (покупка) или FROM_MERCHANT – деньги переводятся от продавца к клиенту (продажа).
2. В зависимости от направления перевода в запросе оплаты указываются данные карты списания или карты зачисления:
   • Если направление TO_MERCHANT – указываются данные карты списания (fromCard).
   • Если направление FROM_MERCHANT – указываются данные карты зачисления (toCard).
3. Операции продажи клиенту активов (TO_MERCHANT) со списанием средств с карт MasterCard, отличных от Белкарт (т.е. не находящимися под санкциями), автоматически маршрутизируются как eComm транзакции (тип заказа изменяется автоматически).

Ограничения

1. Операции покупки у клиента активов (FROM_MERCHANT) с выводом средств на карты системы MasterCard, отличных от Белкарт (т.е. не находящихся под санкциями), запрещены.
2. Запрещены все платёжные системы, кроме MasterCard, Белкарт и Visa.

Методы API

Базовый URL-адрес

Для отправки запросов в сервис "Маршрутизатор платежей" используется базовый URL-адрес: https://abby.rbsuat.com/p2p-transfer/router/merchant.

Формат данных

• Формат запросов: application/json
• Формат ответов: application/json (возвращается как byte[])
• Кодировка: UTF-8

Аутентификация

Для аутентификации используются параметры:

• userName - имя пользователя API Мерчанта
• password - пароль Мерчанта

Регистрация заказа

Для регистрации заказа используется запрос https://abby.rbsuat.com/p2p-transfer/router/merchant/register.

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

Описание параметров объекта shippingPayerData:

Описание параметров объекта preOrderPayerData:

Описание параметров объекта orderPayerData.

Ниже приведены параметры блока billingPayerData (данные об адресе регистрации клиента).

Параметры ответа

Примеры

Пример запроса

curl -X POST \
  https://api.example.com/p2p-transfer/router/merchant/register \
  -H 'Content-Type: application/json' \
  -d '{
    "orderNumber": "ORDER123456",
    "amount": 10000,
    "currency": "933",
    "description": "Money transfer",
    "transactionTypeIndicator": "Y",
    "transferDirection": "FROM_MERCHANT",
    "returnUrl": "https://merchant.com/return",
    "username": "test_user",
    "password": "test_user-password",
    "language": "ru"
  }'

Пример успешного ответа

{
  "errorCode": 0,
  "errorMessage": "Успешно",
  "orderId": "2d37e3be-9d8f-4ddb-9e0a-3a3c52c8d79a",
  "formUrl": "https://payment.example.com/form/2d37e3be-9d8f-4ddb-9e0a-3a3c52c8d79a"
}

Пример неуспешного ответа

{
  "errorCode": 14,
  "errorMessage": "Incorrect parameter value"
}

Проверка суммы комиссии

Для получения суммы комиссии за денежный перевод используйте запрос https://abby.rbsuat.com/p2p-transfer/router/merchant/verify.

Структура запроса предполагает наличие блока fromCard для передачи атрибутов карты для списания (если при регистрации передано направление TO_MERCHANT) или блока toCard для передачи атрибутов карты для зачисления (если при регистрации передано направление FROM_MERCHANT).

Для карт системы MasterCard, отличных от Белкарт, операции TO_MERCHANT автоматически маршрутизируются как eComm транзакции. Для таких транзакций запрос всегда возвращает успех и нулевую комиссию.

При выполнении запроса необходимо использовать заголовок: Content-Type: application/json

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

Блок fromCard включает в себя следующие параметры:

Блок toCard включает в себя следующие параметры:

Ниже приведены параметры блока billingPayerData (данные об адресе регистрации клиента).

Параметры ответа

Блок feeDescriptionList включает в себя следующие параметры:

Примеры

Пример запроса

curl -X POST \
  https://abby.rbsuat.com/p2p-transfer/router/merchant/verify \
  -H 'Content-Type: application/json' \
  -d '{
    "orderId": "2d37e3be-9d8f-4ddb-9e0a-3a3c52c8d79a",
    "fromCard": {
      "pan": "5555555555554444",
      "cvc": "123",
      "expirationYear": 2029,
      "expiryMonth": 12,
      "cardholderName": "IVAN IVANOV"
    },
    "toCard": {
      "bindingId": "binding-uuid-goes-here"
    },
    "username": "api-user",
    "password": "api-password",
    "language": "ru"
  }'

Пример успешного ответа

{
  "errorCode": 0,
  "errorMessage": "Успешно",
  "feeDescriptionList": [{
    "feeAmount": 100,
    "feeCurrency": "933",
    "feeDescription": "Acquirer fee"
  }],
}

Пример ответа с ошибкой

{
  "errorCode": 5,
  "errorMessage": "Доступ запрещён"
}

P2P перевод

Для осуществления денежного перевода с карты на карту используйте запрос https://abby.rbsuat.com/p2p-transfer/router/merchant/perform.

При выполнении запроса необходимо использовать заголовок: Content-Type: application/json

Структура запроса предполагает наличие блока fromCard для передачи атрибутов карты для списания (если при регистрации передано направление TO_MERCHANT) или блока toCard для передачи атрибутов карты для зачисления (если при регистрации передано направление FROM_MERCHANT).

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

Возможные значения параметры tii:

Описание параметров объекта shippingPayerData:

Описание параметров объекта preOrderPayerData:

Описание параметров объекта orderPayerData.

Ниже приведены параметры блока billingPayerData (данные об адресе регистрации клиента).

Блок fromCard включает в себя следующие параметры:

При платежах с использованием токенов (APPLE, SAMSUNG, GOOGLE) вместо данных карты в блоке fromCard передается:

Ниже перечислены параметры блока threeDsAuthResult (данные о результате аутентификации 3 DS).

Блок toCard включает в себя следующие параметры:

При аутентификации по протоколу 3DS2 также передаются следующие параметры:

Параметры ответа

При аутентификации по протоколу 3DS2 в ответ на первый запрос приходят следующие параметры:

Ниже приведены параметры, которые должны присутствовать в ответе, после повторного запроса платежа и необходимости перенаправления клиента в ACS при аутентификации по протоколу 3DS2:

Параметры блока statusResponse:

Примеры

Пример запроса

curl -X POST \
  https://abby.rbsuat.com/p2p-transfer/router/merchant/perform \
  -H 'Content-Type: application/json' \
  -d '{
    "orderId": "2d37e3be-9d8f-4ddb-9e0a-3a3c52c8d79a",
    "fromCard": {
      "pan": "5555555555554444",
      "cvc": "123",
      "expirationYear": 2029,
      "expiryMonth": 12,
      "cardholderName": "IVAN IVANOV"
    },
    "toCard": {
      "pan": "4111111111111111"
    },
    "email": "user@example.com",
    "ip": "x.x.x.x",
    "username": "api-user",
    "password": "api-password"
  }'

Пример успешного ответа

{
  "info": "Перенаправление...",
  "acsUrl": "https://acs.com",
  "paReq": "base64 pareq data",
  "termUrl": "finish 3ds url"
}

Пример ответа с ошибкой

{
  "errorCode": 19,
  "errorMessage": "Merchant is not configured properly"
}

Статус P2P перевода

Чтобы получить статус зарегистрированного заказа P2P, используйте запрос https://abby.rbsuat.com/p2p-transfer/router/merchant/status.

При выполнении запроса необходимо использовать заголовок: Content-Type: application/json

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

Параметры ответа

Ниже приведены возможные параметры блока operationList.

Примеры

Пример запроса

curl -X POST 'https://abby.rbsuat.com/p2p-transfer/router/merchant/status'
-H 'Content-Type: application/json'
--data-raw '{ 
  "username": "test_user",
  "password": "test_user_password",
  "orderId" : "0a4eaae8-653a-71a9-8259-46fc00a8ea58"
}'

Пример ответа

{
  "orderStatus": 0,
  "errorCode": 0,
  "errorMessage": "Successful",
  "orderNumber": "2009",
  "amount": 50000,
  "currency": "933",
  "creationDate": 1674137044330,
  "orderParams": [],
  "operationList": [],
  "resultCode": 0
}

Коды ошибок

Системные ошибки (код 7)

Ошибки валидации (код 14)

Специфические ошибки (коды 15+)