OCT транзакции

Общая информация об OCT

OCT (Original Credit Transaction) – особый вид транзакций по зачислению денежных средств получателю в режиме реального времени.

Для всех OCT транзакций действуют правила:

• В запросе регистрации заказа необходимо передать параметр features со значением WITHOUT_FROM_CARD.
• В запросе оплаты указываются данные карты зачисления, т.е. toCard.

Кроме того, если выполняется перевод со счета физического лица на карту "МИР" физического лица (A2C, Account-to-Card):

• В запросе регистрации заказа необходимо передать параметр transactionTypeIndicator == A (если для мерчанта не задана соответствующая настройка).

• В запросе оплаты:

  • В блоке fromCard необходимо указать блок replacementData, который должен содержать параметр account – номер счета отправителя. См. описание здесь.
  • В блоке params необходимо указать параметр bic_number – номер БИК банка отправителя (если в настройках мерчанта не указан БИК).

Пример запроса регистрации заказа

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username": "test_user",
  "password": "test_user_password",
  "amount": "1000",
  "returnUrl": "https://mybestmerchantreturnurl.com",
  "failUrl": "https://failurl.com",
  "orderNumber": "353453",
  "currency": "643",
  "transactionTypeIndicator": "A",
  "features": {
    "feature": [
      "WITHOUT_FROM_CARD"
    ]
  }
}'

Пример оплаты заказа

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username": "test_user",
  "password": "test_user_password",
  "orderId": "27c138a9-5075-7b8d-81c0-f01300f69cd0",
  "params": [
    {
      "name": "bic_number",
      "value": "123456789"
    }
  ],
  "fromCard": {
    "replacementData": {
      "account": "12345678901234567890"
    }
  },
  "toCard": {
    "pan": "2201382000000013"
  }
}'

Сценарий проведения OCT транзакции

1. Держатель карты (клиент) взаимодействует с интернет-магазином для создания заказа.
2. Система интернет-магазина регистрирует заказ в Платежном шлюзе через registerP2P.do. Используемые параметры регистрации включают сумму перевода, валюту, номер заказа в системе продавца и URL возврата для клиента.
3. Платежный шлюз в ответ на запрос регистрации возвращает уникальный идентификатор заказа в платежной системе и URL для перенаправления клиента на форму сбора карточных данных.
4. Система интернет-магазина передает URL-адрес перенаправления, полученный на Шаге 3, браузеру клиента.
5. Клиент заполняет форму, и данные отправляются на сервер платежного шлюза.
6. Платежный шлюз осуществляет перевод средств через performP2P.do.
7. Когда деньги переведены, платежный шлюз отправляет обратный URL-адрес в веб-браузер клиента (URL-адрес был указан при регистрации заказа интернет-магазином на Шаге 2).
8. Веб-браузер клиента запрашивает результаты перевода денег из интернет-магазина.
9. Система интернет-магазина запрашивает информацию о статусе заказа у платежного шлюза – getP2PStatus.do.
10. Платежный шлюз возвращает статус заказа.
11. Система интернет-магазина показывает клиенту результат оплаты.

API-вызовы

Для OCT интеграций необходимо, чтобы вызовы API были подписаны. Информацию о подписи запросов можно найти в нашем Руководстве по API.

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

Для оформления заказа на перевод денег с карты на карту используйте запрос https://sandbox.rbsuat.com/payment/rest/api/p2p/registerP2P.do.

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

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

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

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

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

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

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

Примеры

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

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "643",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "12",
  "clientId": "122313",
  "transactionTypeIndicator": "A",
  "features":{
      "feature":["WITHOUT_FROM_CARD"]
   }
}'

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

{
  "errorCode": 0,
  "errorMessage": "Successful",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "formUrl": "https://sandbox.rbsuat.com/payment/merchants/ecom/payment.html?mdOrder=0a4eaae8-653a-71a9-8259-46fc00a8ea58&language=en",
  "orderNumber": "2009"
}

Сумма комиссии

Для получения суммы комиссии за денежный перевод используйте запрос https://sandbox.rbsuat.com/payment/rest/api/p2p/verifyP2P.do.

Структура запроса предполагает наличие блока toCard для передачи атрибутов карты для зачисления.

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

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

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

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

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

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

Примеры

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

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/verifyP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "toCard": {
    "pan": "4000001111111118"
  },
  "amount" : 50000
}'

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

{
  "errorCode": 0,
  "errorMessage": "Successful",
  "feeDescriptionList: [ {
    "feeAmount": 500,
	"feeCurrency": "643",
	"feeDescription": "Acquirer fee"
  } ]
}

Комиссия за P2P перевод по связке

Для получения суммы комиссии при переводе средств по связке используйте запрос https://sandbox.rbsuat.com/payment/rest/api/p2p/verifyP2PByBinding.do.

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

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

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

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

Примеры

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

curl --location --request POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/verifyP2PByBinding.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "test_user",
    "password": "test_user_password",
    "orderId": "fa71bf70-7c81-484e-a6fc-7db7e4283b2a",
    "bindingId": "4d792471-cee0-742c-922d-a265072e6148",
	"toCard": {
        "cardholderName": "IVAN IVANOV",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2024,
        "pan": "5555555555555599"
    },
	"amount": 1000,
    "currency": "643",
    "clientId": "123"
    }
}'

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

{
  "errorCode" : 0,
  "errorMessage" : "Successful",
  "feeDescriptionList" : [ {
    "feeAmount" : 10,
    "feeCurrency" : "643",
    "feeDescription" : "Acquirer fee"
  } ]
}

P2P перевод

Для осуществления денежного перевода с карты на карту используйте запрос https://sandbox.rbsuat.com/payment/rest/api/p2p/performP2P.do.

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

Структура запроса performP2P.do предполагает наличие блока toCard для передачи атрибутов карты для зачисления.

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

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

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

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

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

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

Данные для замены отправителя OCT перевода

В некоторых случаях для OCT транзакций по карте "МИР" запрос включает в себя блок fromCard с вложенным блоком replacementData с данными для замены отправителя перевода. Он содержит номер счета и номер карты отправителя. Платежная система "МИР" требует передачи этих данных в OCT транзакциях.
Для использования этого блока мерчанту необходимо иметь специальное разрешение (уточните у команды поддержки).

Ниже перечислены параметры блока replacementData (данные для замены отправителя в OCT транзакциях):

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

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

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

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

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

Для завершения транзакции используйте метод /p2p/finishThreeDsVer2.do.

Примеры

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

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "amount" : "50000",
  "toCard" : {
    "pan" : "4111111111111111"
  }
}'

Пример ответа на запрос

{
  "errorCode": 0,
  "info": "Your order is proceeded, redirecting...",
  "acsUrl": "https://example.com/acs2/acs/creq",
  "is3DSVer2": true,
  "packedCReq": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjNhZmMxNjhhLTk0YjQtNGViMy04ZTJlLTgwZjZjMTg2NjY5ZCIsIm1lc3NhZ2VUeXBlIjoiQ1JlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJhY3NUcmFuc0lEIjoiOWM3NTkxMmEtZTg0NC00ODgyLWI5YzctYzZmYmMzNjIyNGQ3IiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA1In0"
}

P2P перевод по связке

Чтобы выполнить перевод с карты на карту с помощью связки, используйте запрос https://sandbox.rbsuat.com/payment/rest/api/p2p/performP2PByBinding.do.

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{
  "amountInput" : 1000,
  "toCard": {
        "cardholderName": "TEST CARDHOLDER",
        "expirationMonth": 12,
        "expirationYear": 2029,
        "pan": "5555555555555599"
  },
  "orderId" : "3dbaf8bb-1d68-76b3-b4e6-784700f26b04",
  "password" : "test_user_password",
  "type" : "WITHOUT_FROM_CARD",
  "username" : "test_user"
}'

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

{
  "errorCode" : 0,
  "errorMessage" : "Successful",
  "info" : "Your order is proceeded, redirecting...",
  "redirect" : "https://example.com/?orderId=47743354-be15-7c70-b9ef-4bfc482e68dc&lang=en",
  "is3DSVer2" : false
}

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

Чтобы получить статус зарегистрированного заказа P2P, используйте запрос https://sandbox.rbsuat.com/payment/rest/api/p2p/getP2PStatus.do.

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

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

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

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

Примеры

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

curl -X POST 'https://sandbox.rbsuat.com/payment/rest/api/p2p/getP2PStatus.do'
-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": "643",
  "creationDate": 1674137044330,
  "orderParams": [],
  "operationList": [],
  "resultCode": 0
}

Завершение P2P-транзакции 3DS2 через API

Чтобы завершить P2P-транзакцию, продавец отправляет идентификатор транзакции на шлюз, используя метод https://sandbox.rbsuat.com/payment/rest/api/p2p/finishThreeDsVer2.do.

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

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

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

Ответ на этот запрос не содержит никаких параметров JSON. Вместо этого он перенаправляет клиента на один из следующих URL-адресов:

• Если обработка запроса прошла успешно, платежный шлюз перенаправляет клиента на URL-адрес, указанный в параметре returnUrl при регистрации заказа, с добавленными параметрами orderId и lang;
• Если обработка запроса прошла неуспешно, платежный шлюз перенаправляет клиента на URL-адрес, указанный в параметре failUrl при регистрации заказа, с добавленными параметрами orderId и lang.

Примеры

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

curl --request POST \
  --url https://sandbox.rbsuat.com/payment/rest/api/p2p/finishThreeDsVer2.do \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{
    "username": "test_user",
    "password": "test_user_password",
    "threeDSServerTransId": "65020d0c-2627-4a45-8eab-b93b58fc52ae"
}'

Пример URL редиректа

https://mybestmerchantreturnurl.com/finish.html?orderId=906bf262-bd53-4ac7-983c-07127954681b&lang=en