OCT транзакции

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

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

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

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

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

sequenceDiagram participant C as Клиент participant OS as Интернет-магазин participant PG as Платежный шлюз C ->> OS: 1. Формирование заказа OS ->> PG: 2. Регистрация заказа PG -->> OS: 3. orderId, formUrl OS -->> C: 4. Перенаправление на форму сбора карточных данных C ->> PG: 5. Отправка данных в заполненной форме PG ->> PG: 6. Перевод средств PG -->> C: 7. Перенаправление клиента в интернет-магазин C ->> OS: 8. Получение страницы с результатом OS ->> PG: 9. Проверка статуса PG -->> OS: 10. Статус заказа OS -->> C: 11. Отображение результата

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

API-вызовы

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

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

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

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

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Обязательно	`orderNumber`	String [1..36]	Номер заказа (ID) в системе мерчанта; должен быть уникальным для каждого заказа.
Обязательно	`amount`	Integer [0..12]	Сумма платежа в минимальных единицах валюты (например, в копейках).
Обязательно	`currency`	String [3]	Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию. Допускаются только цифры.
Обязательно	`returnUrl`	String [1..512]	Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Адрес должен быть указан полностью, включая используемый протокол (например, `https://mybestmerchantreturnurl.com` вместо `mybestmerchantreturnurl.com`). В противном случае пользователь будет перенаправлен по адресу следующего вида: `https://abby.rbsuat.com/payment/<merchant_address>`. Адрес не должен быть относительным путем, т.е. он не должен начинаться с "." и "/". В противном случае будет возвращена ошибка 4: "URL возврата некорректен". Например: ../test.html, /test.html — неверные URL-адреса.
Необязательно	`failUrl`	String [1..512]	Адрес, на который требуется перенаправить пользователя в случае неуспешной оплаты. Адрес должен быть указан полностью, включая используемый протокол (например, `https://mybestmerchantreturnurl.com` вместо `mybestmerchantreturnurl.com`). В противном случае пользователь будет перенаправлен по адресу следующего вида: `https://abby.rbsuat.com/payment/<merchant_address>`. Адрес не должен быть относительным путем, т.е. он не должен начинаться с "." и "/". В противном случае будет возвращена ошибка 4: "URL возврата некорректен". Например: ../test.html, /test.html — неверные URL-адреса.
Необязательно	`orderDescription`	String [1..600]	Описание заказа передаваемое платежному шлюзу при регистрации. В этом поле недопустимо передавать персональные данные или платежные данные (номера карт т.п.). Данное требование связано с тем, что описание заказа нигде не маскируется.
Необязательно	`language`	String [2]	Ключ языка по ISO 639-1. Если язык не указан, используется язык по умолчанию, указанный в настройках магазина. Поддерживаемые языки: ru,en,by,pl.
Необязательно	`clientId`	String [0..255]	Номер клиента (ID) в системе мерчанта — до 255 символов. Используется для реализации функциональности связок. Может возвращаться в ответе, если мерчанту разрешено создавать связки. Указание этого параметра при обработке платежей по связке обязательно. В противном случае платеж будет невозможен.
Необязательно	`merchantLogin`	String [1..255]	Чтобы зарегистрировать заказ от имени другого мерчанта, укажите его логин (для API-аккаунта) в этом параметре. Можно использовать, только если у вас есть разрешение на просмотр транзакций других продавцов или если указанный продавец является вашим дочерним продавцом.
Необязательно	`dynamicCallbackUrl`	String [1..512]	Параметр для передачи динамического адреса для получения "платежных" callback-уведомлений по заказу, активированных для мерчанта (успешная авторизация, успешное списание, возврат, отмена, отклонение платежа по таймауту, отклонение card present платежа). "Не платежные" callback-уведомления (включение/выключение связки, создание связки), будут отправляться на статический callback адрес.
Необязательно	`sessionTimeoutSecs`	Integer [1..9]	Продолжительность жизни заказа в секундах. В случае если параметр не задан, будет использовано значение, указанное в настройках мерчанта, или время по умолчанию (1200 секунд = 20 минут). Если в запросе присутствует параметр `expirationDate`, то значение параметра `sessionTimeoutSecs` не учитывается.
Необязательно	`sessionExpiredDate`	String	Дата и время истечения срока действия заказа. Формат: `yyyy-MM-ddTHH:mm:ss`. Если этот параметр не передается в запросе, то для определения времени истечения срока действия заказа используется параметр `sessionTimeoutSecs`.
Необязательно	`bindingId`	String [1..255]	Идентификатор уже существующей связки (идентификатор карты, токенизированной шлюзом). Его можно использовать, только если у мерчанта есть разрешение на работу со связками. Если этот параметр передается в этом запросе, это означает, что: Этот заказ можно оплатить только с помощью связки; Плательщик будет перенаправлен на страницу оплаты, где требуется только ввод CVC. В запросе необходимо передать или `bindingId`, или `seToken`.
Необязательно	`creditBindingId`	String [0..255]	Идентификатор связки карты для зачисления. Используется при переводах с карты на карту, когда заранее известна карта получателя. Этот параметр нужно сначала передать в запросе на регистрацию платежа (`registerP2P.do` - здесь же должен быть передан параметр `clientId`), затем в запросе на перевод средств по cвязке (`performP2PByBinding.do` - значение параметра `creditBindingId`, переданного в `registerP2P.do`, должно быть передано в параметре `bindingId` в блоке `toCard`).
Обязательно	`transactionTypeIndicator`	String	Используется в однонаправленных типах транзакций. Возможны такие значения: `A` – Перевод с карты на карту одного владельца (со счета на счет) `B` – Перевод с целью приобретения криптовалюты `C` – Перевод для целей покупки криптовалюты `D` – Выплата средств `F` – Перевод для ставок по азартным играм `G` – Выплата в азартных играх онлайн `H` – Вывод средств (Cash Out). Вывод средств агентом. `I` – Государственные выплаты `J` – Денежный перевод, инициированный банком `L` – Перевод для целей погашения счетов по кредитной карте `O` – Перевод для целей оплаты задолженности `P` – Перевод с карты на карту разных владельцев `W` – Перевод на собственный счет поэтапного цифрового кошелька для оплаты При использовании этого параметра вы должны передать блок `features`, который включает параметр, соответствующий типу операции.
Обязательно	`features`	Object	Контейнер для параметра `feature`, обязателен для однонаправленных операций. Если выполняется операция OCT (перевод со счета на карту) - в параметре `feature` должно быть передано `WITHOUT_FROM_CARD`. Пример: `"features" : { "feature" : ["WITHOUT_FROM_CARD"] }`
Необязательно	`params`	Object	Поля дополнительной информации для последующего хранения, передаются в следующем виде: `"params": [ {"name": "param1", "value": "value1"}, {"name": "param2", "value": "value2"} ]`. Данные поля могут быть переданы в процессинг банка для последующего отображения в реестрах банка.
Необязательно	`shippingPayerData`	Object	Объект, содержащий данные о доставке клиенту. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`preOrderPayerData`	Object	Объект, содержащий данные предварительного заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`orderPayerData`	Object	Объект, содержащий данные о плательщике заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`billingAndShippingAddressMatchIndicator`	String [1]	Индикатор соответствия платежного адреса владельца карты и адреса доставки. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. Возможные значения: `Y` - совпадение платежного адреса держателя карты и адреса доставки; `N` - платежный адрес владельца карты и адрес доставки не совпадают.
Условие	`billingPayerData`	Object	Блок с регистрационными данными клиента (адрес, почтовый индекс), необходимый для прохождения проверки адреса в рамках сервисов AVS/AVV. Обязателен, если функция включена для продавца на стороне Платежного шлюза. Должен был включен либо в запрос registerP2P.do, либо в запрос performP2P.do. См. вложенные параметры.
Необязательно	`debitMdOrder`	String [1..36]	Уникальный номер заказа, для которого был выполнен перевод AFT в iPay. Этот параметр используется для операций OCT при P2P-переводах (AFT+OCT).

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

Обязательность	Название	Тип	Описание
Необязательно	`shippingCity`	String [1..50]	Город заказчика (из адреса доставки)
Необязательно	`shippingCountry`	String [1..50]	Страна заказчика
Необязательно	`shippingAddressLine1`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine2`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine3`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingPostalCode`	String [1..16]	Почтовый индекс клиента для доставки
Необязательно	`shippingState`	String [1..50]	Штат/регион покупателя (из адреса доставки)
Необязательно	`shippingMethodIndicator`	Integer [2]	Индикатор способа доставки. Возможные значения: `01` - доставка на платежный адрес держателя карты. `02` - доставка на другой адрес, проверенный Мерчантом. `03` - доставка по адресу, отличному от основного адреса держателя карты. `04` - отправка в магазин/самовывоз (адрес магазина должен быть указан в соответствующих параметрах доставки) `05` - Цифровое распространение (включает онлайн-сервисы и электронные подарочные карты) `06` - билеты на путешествия и мероприятия, которые нельзя доставить. `07` - Прочее (например, игры, цифровые товары, не подлежащие доставке, цифровые подписки и т. д.)
Необязательно	`deliveryTimeframe`	Integer [2]	Срок поставки товара. Возможные значения: `01` - цифровая дистрибуция `02` - доставка в тот же день `03` - доставка на следующий день `04` - доставка в течение 2-х дней после оплаты и позже.
Необязательно	`deliveryEmail`	String [1..254]	Целевой адрес электронной почты для доставки цифрового распространения. Предпочтительно передавать электронную почту в самостоятельном параметре запроса `email` (но если вы передадите его в этом блоке, к нему применятся те же правила).

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

Обязательность	Название	Тип	Описание
Необязательно	`preOrderDate`	String [10]	Ожидаемая дата доставки (для предзаказанных покупок) в формате ГГГГММДД.
Необязательно	`preOrderPurchaseInd`	Integer [2]	Индикатор размещения клиентом заказа на доступную или будущую доставку. Возможные значения: `01` - возможна доставка; `02` - будущая доставка
Необязательно	`reorderItemsInd`	Integer [2]	Индикатор того, что клиент перебронирует ранее оплаченную доставку в составе нового заказа. Возможные значения: `01` - заказ размещается впервые; `02` - повторный заказ

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

Обязательность	Название	Тип	Описание
Необязательно	`homePhone`	String [7..15]	Домашний телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`workPhone`	String [7..15]	Рабочий телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`mobilePhone`	String [7..15]	Номер мобильного телефона владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.` Для платежей по VISA с 3DS авторизацией необходимо указать либо электронную почту, либо номер телефона владельца карты. Если у вас настроено отображение номера телефона на платежной странице и вы указали неверный номер телефона, клиент сможет исправить его на платежной странице.

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

Обязательность	Название	Тип	Описание
Необязательно	`billingCity`	String [0..50]	Город, зарегистрированный по конкретной карте у Банка Эмитента.
Необязательно	`billingCountry`	String [0..50]	Страна, зарегистрированная по конкретной карте банка-эмитента. Формат: ISO 3166-1 (Alpha 2 / Alpha 3 / Number-3) или наименование страны. Рекомендуем передавать двух/трехбуквенный ISO код страны.
Необязательно	`billingAddressLine1`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента (адрес плательщика). Строка 1. Обязательно к передаче для AVS-проверки.
Необязательно	`billingAddressLine2`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 2.
Необязательно	`billingAddressLine3`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 3.
Необязательно	`billingPostalCode`	String [0..9]	Почтовый индекс, зарегистрированный по конкретной карте у Банка Эмитента. Обязательно к передаче для AVS-проверки.
Необязательно	`billingState`	String [0..50]	Штат, зарегистрированный по конкретной карте у Банка Эмитента. Формат: полное значение кода ISO 3166-2, его часть или наименование штата/региона. Может содержать буквы только латинского алфавита. Рекомендуем передавать двухбуквенный ISO код штата/региона.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`formUrl`	String [1..512]	URL платежной формы, на которую будет перенаправлен покупатель. URL не возвращается, если регистрация заказа не прошла из-за ошибки, указанной в `errorCode`.
Необязательно	`orderId`	String [1..36]	Номер заказа в платежном шлюзе. Уникален в пределах платежного шлюза.
Необязательно	`orderNumber`	String [1..36]	Номер заказа (ID) в системе мерчанта; должен быть уникальным для каждого заказа.

Примеры

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

curl -X POST 'https://abby.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" : "933",
  "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://abby.rbsuat.com/payment/merchants/ecom/payment.html?mdOrder=0a4eaae8-653a-71a9-8259-46fc00a8ea58&language=en",
  "orderNumber": "2009"
}

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

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

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

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

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Обязательно	`orderId`	String [1..36]	Номер заказа в платежном шлюзе. Уникален в пределах платежного шлюза.
Необязательно	`language`	String [2]	Ключ языка по ISO 639-1. Если язык не указан, используется язык по умолчанию, указанный в настройках магазина. Поддерживаемые языки: ru,en,by,pl.
Необязательно	`amount`	String [0..12]	Сумма перевода в минимальных единицах валюты (например, в копейках). Этот параметр передается, если плательщик решит изменить сумму перевода при осуществлении денежного перевода.
Необязательно	`billingPayerData`	Object	Блок с регистрационными данными клиента (адрес, почтовый индекс), необходимый для прохождения проверки адреса в рамках сервисов AVS/AVV. Обязателен, если функция включена для продавца на стороне Платежного шлюза. См. вложенные параметры.
Обязательно	`toCard`	Object	Блок с атриубутами карты начисления. См. вложенные параметры.

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

Обязательность	Название	Тип	Описание
Условие	`pan`	String [1..19]	Номер карты для зачисления денежных средств.
Необязательно	`expirationYear`	Integer [4]	Год истечения действия карты зачисления. Принимаются значения от 2000 до 2200.
Необязательно	`expirationMonth`	Integer [2]	Месяц истечения действия карты зачисления. Доступные значения: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12.
Необязательно	`cardholderName`	String [1..26]	Имя держателя карты зачисления.
Условие	`seToken`	String	Зашифрованные данные карты. Обязательно, если используется вместо данных карты. Обязательные параметры для строки seToken: `timestamp`, `UUID`, `PAN`, `EXPDATE`, `MDORDER`. Подробнее о генерации seToken см. здесь.

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

Обязательность	Название	Тип	Описание
Необязательно	`billingCity`	String [0..50]	Город, зарегистрированный по конкретной карте у Банка Эмитента.
Необязательно	`billingCountry`	String [0..50]	Страна, зарегистрированная по конкретной карте банка-эмитента. Формат: ISO 3166-1 (Alpha 2 / Alpha 3 / Number-3) или наименование страны. Рекомендуем передавать двух/трехбуквенный ISO код страны.
Необязательно	`billingAddressLine1`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента (адрес плательщика). Строка 1. Обязательно к передаче для AVS-проверки.
Необязательно	`billingAddressLine2`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 2.
Необязательно	`billingAddressLine3`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 3.
Необязательно	`billingPostalCode`	String [0..9]	Почтовый индекс, зарегистрированный по конкретной карте у Банка Эмитента. Обязательно к передаче для AVS-проверки.
Необязательно	`billingState`	String [0..50]	Штат, зарегистрированный по конкретной карте у Банка Эмитента. Формат: полное значение кода ISO 3166-2, его часть или наименование штата/региона. Может содержать буквы только латинского алфавита. Рекомендуем передавать двухбуквенный ISO код штата/региона.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.

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

Обязательность	Название	Тип	Описание
Необязательно	`feeAmount`	Integer [1..12]	Сумма комиссии.
Необязательно	`feeCurrency`	String [3]	Код валюты платежа ISO 4217.
Необязательно	`feeDescription`	String [1..512]	Описание комиссии.

Примеры

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

curl -X POST 'https://abby.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": "933",
	"feeDescription": "Acquirer fee"
  } ]
}

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

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

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

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Необязательно	`language`	String [2]	Ключ языка по ISO 639-1. Если язык не указан, используется язык по умолчанию, указанный в настройках магазина. Поддерживаемые языки: ru,en,by,pl.
Обязательно	`orderId`	String [1..36]	Номер заказа в платежном шлюзе. Уникален в пределах платежного шлюза.
Обязательно	`toCard`	Object	Блок с атрибутами карты начисления. См. вложенные параметры.

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

Обязательность	Название	Тип	Описание
Условие	`bindingId`	String [1..255]	Идентификатор связки, созданной при оплате заказа или использованной для оплаты. Доступно, только если продавцу разрешено создавать связки.
Условие	`pan`	String [1..19]	Номер карты для зачисления денежных средств.
Необязательно	`expirationYear`	Integer [4]	Год истечения действия карты зачисления. Принимаются значения от 2000 до 2200.
Необязательно	`expirationMonth`	Integer [2]	Месяц истечения действия карты зачисления. Доступные значения: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12.
Необязательно	`cardholderName`	String [1..26]	Имя держателя карты зачисления.
Условие	`seToken`	String	Зашифрованные данные карты. Обязательно, если используется вместо данных карты. Обязательные параметры для строки seToken: `timestamp`, `UUID`, `PAN`, `EXPDATE`, `MDORDER`. Подробнее о генерации seToken см. здесь.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`feeAmount`	Integer [1..12]	Сумма комиссии.
Необязательно	`feeCurrency`	String [3]	Код валюты платежа ISO 4217.
Необязательно	`feeDescription`	String [1..512]	Описание комиссии.

Примеры

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

curl --location --request POST 'https://abby.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": "933",
    "clientId": "123"
    }
}'

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

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

P2P перевод

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

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

Структура запроса performP2P.do предполагает наличие блока fromCard для передачи атрибутов карты для списания и блока toCard для передачи атрибутов карты для зачисления. В зависимости от бизнес-процессов, определённых для банка и магазина, при проведение перевода с карты на карту могут быть возможны следующие варианты.

Магазин передаёт в шлюз данные карты списания и данные карты зачисления денежных средств. В этом случае в запросе должны присутствовать оба блока параметров — fromCard и toCard.
Если зачисление на карту производится сторонней системой (AFT операция), то магазин передаёт в шлюз только данные карты списания. В этом случае должен быть только один блок параметров – fromCard
Если списание с карты производится сторонней системой (OCT операция), то магазин передаёт в шлюз только данные карты зачисления. В этом случае должен быть только один блок параметров – toCard

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Необязательно	`language`	String [2]	Ключ языка по ISO 639-1. Если язык не указан, используется язык по умолчанию, указанный в настройках магазина. Поддерживаемые языки: ru,en,by,pl.
Обязательно	`orderId`	String [1..36]	Номер заказа в платежном шлюзе. Уникален в пределах платежного шлюза.
Необязательно	`ip`	String [1..39]	IP адрес плательщика. IPv6 поддерживается во всех запросах (до 39 символов). При использовании аутентификации 3DS 2 рекомендуем вам передавать в этом параметре реальный IP адрес клиента. Это позволит повысить конверсию в оплату на стороне ACS.
Необязательно	`email`	String [1..64]	Электронная почта плательщика.
Необязательно	`amount`	String [0..12]	Сумма перевода в минимальных единицах валюты (например, в копейках). Этот параметр передается, если плательщик решит изменить сумму перевода при осуществлении денежного перевода.
Необязательно	`type`	String	В случае денежного перевода с данными только по одной карте необходимо передать в этом параметре соответствующее значение:
Необязательно	`amountInput`	Integer [0..12]	Сумма перевода в минимальных единицах валюты (например, в копейках). Если в этом параметре указана сумма, перевод будет осуществлен на эту сумму (независимо от суммы, переданной в запросе на оформление заказа).
Необязательно	`captcha`	String	CAPTCHA (текст, предназначенный для того, чтобы отличать человеческий ввод от машинного)
Необязательно	`threeDSSDK`	Boolean	Возможные значения: `true` или `false` Флаг, показывающий, что платеж поступает из 3DS SDK.
Необязательно	`threeDSSDKEncData`	String	Зашифрованные данные об устройстве. Параметр является обязательным для SDK.
Необязательно	`threeDSSDKReferenceNumber`	String	Официальный идентификатор 3DS2 SDK
Необязательно	`threeDSSDKEphemPubKey`	String	Публичная часть эфемерного ключа. Требуется для установки сеанса с ACS. Параметр является обязательным для SDK.
Необязательно	`threeDSSDKAppId`	String	Уникальный идентификатор SDK. Параметр является обязательным для SDK.
Необязательно	`threeDSSDKTransId`	String	Уникальный идентификатор транзакции в SDK. Параметр является обязательным для SDK.
Необязательно	`threeDSMethodNotificationUrl`	String [1..512]	URL-адрес для отправки уведомления о прохождении проверки на ACS.
Условие	`threeDSServerTransId`	String [1..36]	Идентификатор транзакции, созданный на сервере 3DS. Обязателен для аутентификации 3DS.
Необязательно	`threeDSVer2FinishUrl`	String [1..512]	URL-адрес, по которому клиент должен быть перенаправлен после аутентификации на сервере ACS.
Условие	`threeDSVer2MdOrder`	String [1..36]	Номер заказа, который был зарегистрирован в первой части запроса в рамках 3DS2 операции. Обязателен для аутентификации 3DS. Если данный параметр присутствует в запросе, то используется `mdOrder`, который передается в настоящем параметре. В таком случае регистрация заказа не происходит, а происходит сразу оплата заказа. Этот параметр передается только при использовании методов мгновенной оплаты, т.е., когда заказ регистрируется и оплачивается в рамках одного запроса.
Необязательно	`bindingNotNeeded`	Boolean	Допустимые значения: `true`- создание связки после совершения платежа отключено (связка – это идентификатор клиента, переданный в запросе на регистрацию заказа, который после запроса оплаты будет удален из деталей заказа); `false` – в случае успешной оплаты может быть создана связка (при соблюдении необходимых условий). Это значение по умолчанию.
Условие	`originalPaymentNetRefNum`	String	Идентификатор оригинальной или предыдущей успешной транзакции в платежной системе по отношению к выполняемой операции по связке - TRN ID. Передается, если значение параметра `tii` = `R`,`U` или `F`. Обязателен при использовании связок мерчанта в переводах по связке.
Условие	`tii`	String	Идентификатор инициатора транзакции. Параметр, указывающий, какой тип операции будет выполнять инициатор (Клиент или Мерчант). Обязательно для операций AFT и перевода с использованием связки в блоке `fromCard` или собственной связки мерчанта. Для операций OCT этот параметр не передается. Возможные значения
Обязательно	`params`	Object	Поля дополнительной информации для последующего хранения, передаются в следующем виде: `{"param":"value","param2":"value2"}`. Данные поля могут быть переданы в процессинг банка для последующего отображения в реестрах банка. По умолчанию передаются `orderNumber` (номер заказа) и `orderDescription` (описание заказа).`orderDescription` не должно превышать 99 символов, не используйте следующие символы: `%`, `+`, возврат каретки `\r` и перевод строки `\n`). Чтобы включить эту функциональность, обратитесь в банк. В объекте `params` запроса на перевод денег с карты на карту могут быть переданы следующие данные клиента (формат значений зависит от используемого метода обработки данных): В параметре `payerName` - имя отправителя денег. В параметре `payerAddress` - адрес отправителя. В параметре `payerCity` - город отправителя. В параметре `payerCountry` - страна отправителя в виде кода ISO 3166-1 alpha-3 (трехбуквенный код). В параметре `payerPostalCode` - почтовый индекс отправителя. В параметре `payerState` - регион отправителя. Для платежной системы Visa в запросе на перевод денег с карты на карту также необходимо передать в параметре `params` следующую информацию (формат значений определяется используемым методом обработки данных): В параметре `recipientName` - имя получателя денег. При необходимости обратитесь в команду поддержки для указания постоянных значений параметров `payer*` и `recipientName`, чтобы не передавать их каждый раз во всех запросах.
Необязательно	`shippingPayerData`	Object	Объект, содержащий данные о доставке клиенту. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`preOrderPayerData`	Object	Объект, содержащий данные предварительного заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`orderPayerData`	Object	Объект, содержащий данные о плательщике заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Условие	`billingPayerData`	Object	Блок с регистрационными данными клиента (адрес, почтовый индекс), необходимый для прохождения проверки адреса в рамках сервисов AVS/AVV. Обязателен, если функция включена для продавца на стороне Платежного шлюза. Должен был включен либо в запрос registerP2P.do, либо в запрос performP2P.do. См. вложенные параметры.
Обязательно	`toCard`	Object	Блок с атрибутами карты начисления. См. вложенные параметры.
Условие	`debitTransactionReference`	String [1..19]	Ссылка на операцию AFT. Этот параметр используется для операций OCT для P2P-переводов (AFT+OCT) с использованием Mastercard. Он заполняется параметром `statusResponse.debitTransactionReference` из соответствующей транзакции AFT. Обязательно, если ранее был выполнен Mastercard Money Funding Payment и был сформирован и отправлен Unique Transaction Reference.
Необязательно	`transactionPurpose`	String	Цель транзакции (используется для транзакций OCT с использованием Mastercard). Возможные значения: `FAMILY_SUPPORT` или `0` `REGULAR_LABOR_TRA` или `1` `TRAVEL_AND_TOURISM` или `2` `EDUCATION` или `3` `HOSPITALIZATION` или `4` `EMERGENCY_NEED` или `5` `SAVING` или `6` `GIFTS` или `7` `OTHER` или `8` `SALARY` или `9` `CROWD_LENDING` или `10` `CRYPTO_CURRENCY` или `11` `REFUND_ORIGINAL` или `12` `REFUND_NEW_CARD` или `13` `TRANSFER_SAME_WAL` или `14` `BOLETO_PAYMENT` или `15` `HIGH_RISK_SECURITY` или `16` `RECYCLING_DEPOSIT_RETURN` или `17` `VALUE_ADDED_TAX` или `18`
Необязательно	`serviceProcessingType`	String	Тип сервиса процессинга (используется для транзакций OCT с использованием Visa). Сервисный флаг, который указывает системе Visa, как обрабатывать транзакцию на уровне процессинга. Возможные значения: `NORMAL` или `00` `ORIG_HOLD` или `01` `VISA_DEFERRED_DEFAULT` или `02` `VISA_DEFERRED_CUSTOM` или `03` `CANCEL_DEFERRED` или `09` `VISA_DIRECT_CUSTOM` или `0I` `DEFERRED_OCT_QUERY` или `0Q` `REC_PAYOUT` или `0R` `ALIAS_DIRECTORY` или `A0`

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

Значение `tii`	Описание	Тип транзакции	Инициатор транзакции	Данные карты для транзакции	Данные карты сохраняются после транзакции	Комментарий
CI	Инициирующий - Обычный (CIT)	Инициирующая	Покупатель	Вводится покупателем	Да	Транзакция электронной коммерции с сохранением связки.
F	Внеплановый платеж (CIT)	Последующая	Покупатель	Клиент выбирает карту вместо ручного ввода	Нет	Транзакция электронной коммерции, использующая ранее сохраненную обычную связку.

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

Обязательность	Название	Тип	Описание
Необязательно	`shippingCity`	String [1..50]	Город заказчика (из адреса доставки)
Необязательно	`shippingCountry`	String [1..50]	Страна заказчика
Необязательно	`shippingAddressLine1`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine2`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine3`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingPostalCode`	String [1..16]	Почтовый индекс клиента для доставки
Необязательно	`shippingState`	String [1..50]	Штат/регион покупателя (из адреса доставки)
Необязательно	`shippingMethodIndicator`	Integer [2]	Индикатор способа доставки. Возможные значения: `01` - доставка на платежный адрес держателя карты. `02` - доставка на другой адрес, проверенный Мерчантом. `03` - доставка по адресу, отличному от основного адреса держателя карты. `04` - отправка в магазин/самовывоз (адрес магазина должен быть указан в соответствующих параметрах доставки) `05` - Цифровое распространение (включает онлайн-сервисы и электронные подарочные карты) `06` - билеты на путешествия и мероприятия, которые нельзя доставить. `07` - Прочее (например, игры, цифровые товары, не подлежащие доставке, цифровые подписки и т. д.)
Необязательно	`deliveryTimeframe`	Integer [2]	Срок поставки товара. Возможные значения: `01` - цифровая дистрибуция `02` - доставка в тот же день `03` - доставка на следующий день `04` - доставка в течение 2-х дней после оплаты и позже.
Необязательно	`deliveryEmail`	String [1..254]	Целевой адрес электронной почты для доставки цифрового распространения. Предпочтительно передавать электронную почту в самостоятельном параметре запроса `email` (но если вы передадите его в этом блоке, к нему применятся те же правила).

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

Обязательность	Название	Тип	Описание
Необязательно	`preOrderDate`	String [10]	Ожидаемая дата доставки (для предзаказанных покупок) в формате ГГГГММДД.
Необязательно	`preOrderPurchaseInd`	Integer [2]	Индикатор размещения клиентом заказа на доступную или будущую доставку. Возможные значения: `01` - возможна доставка; `02` - будущая доставка
Необязательно	`reorderItemsInd`	Integer [2]	Индикатор того, что клиент перебронирует ранее оплаченную доставку в составе нового заказа. Возможные значения: `01` - заказ размещается впервые; `02` - повторный заказ

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

Обязательность	Название	Тип	Описание
Необязательно	`homePhone`	String [7..15]	Домашний телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`workPhone`	String [7..15]	Рабочий телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`mobilePhone`	String [7..15]	Номер мобильного телефона владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.` Для платежей по VISA с 3DS авторизацией необходимо указать либо электронную почту, либо номер телефона владельца карты. Если у вас настроено отображение номера телефона на платежной странице и вы указали неверный номер телефона, клиент сможет исправить его на платежной странице.

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

Обязательность	Название	Тип	Описание
Необязательно	`billingCity`	String [0..50]	Город, зарегистрированный по конкретной карте у Банка Эмитента.
Необязательно	`billingCountry`	String [0..50]	Страна, зарегистрированная по конкретной карте банка-эмитента. Формат: ISO 3166-1 (Alpha 2 / Alpha 3 / Number-3) или наименование страны. Рекомендуем передавать двух/трехбуквенный ISO код страны.
Необязательно	`billingAddressLine1`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента (адрес плательщика). Строка 1. Обязательно к передаче для AVS-проверки.
Необязательно	`billingAddressLine2`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 2.
Необязательно	`billingAddressLine3`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 3.
Необязательно	`billingPostalCode`	String [0..9]	Почтовый индекс, зарегистрированный по конкретной карте у Банка Эмитента. Обязательно к передаче для AVS-проверки.
Необязательно	`billingState`	String [0..50]	Штат, зарегистрированный по конкретной карте у Банка Эмитента. Формат: полное значение кода ISO 3166-2, его часть или наименование штата/региона. Может содержать буквы только латинского алфавита. Рекомендуем передавать двухбуквенный ISO код штата/региона.

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

Обязательность	Название	Тип	Описание
Условие	`pan`	String [1..19]	Номер карты для зачисления денежных средств.
Необязательно	`expirationYear`	Integer [4]	Год истечения действия карты зачисления. Принимаются значения от 2000 до 2200.
Необязательно	`expirationMonth`	Integer [2]	Месяц истечения действия карты зачисления. Доступные значения: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12.
Необязательно	`cardholderName`	String [1..26]	Имя держателя карты зачисления.
Условие	`seToken`	String	Зашифрованные данные карты. Обязательно, если используется вместо данных карты. Обязательные параметры для строки seToken: `timestamp`, `UUID`, `PAN`, `EXPDATE`, `MDORDER`. Подробнее о генерации seToken см. здесь.

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

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

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

Обязательность	Название	Тип	Описание
Необязательно	`card`	String [1..19]	Номер карты отправителя.
Условие	`account`	String [1..20]	Номер счета отправителя. Обязательно при переводе со счета физического лица на карту "МИР" физического лица (A2C, Account-to-Card).

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

Обязательность	Название	Тип	Описание
Необязательно	`threeDSServerTransId`	String [1..36]	Идентификатор транзакции, созданный на сервере 3DS. Обязателен для аутентификации 3DS.
Необязательно	`threeDSVer2FinishUrl`	String [1..512]	URL-адрес, по которому клиент должен быть перенаправлен после аутентификации на сервере ACS.
Необязательно	`threeDSMethodNotificationUrl`	String [1..512]	URL-адрес для отправки уведомления о прохождении проверки на ACS.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Необязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`info`	String	Результат попытки перевода средств. Значение в случае успешного перевода: "Ваш платеж обработан, происходит переадресация..." Значение в случае ошибки: "Происходит переадресация..."
Условие	`acsUrl`	String [1..512]	URL-адрес для редиректа на ACS. Возвращается при успешном ответе в случае оплаты 3D-Secure, если требуется редирект на ACS. Подробнее см. Редирект на ACS.
Условие	`paReq`	String [1..255]	PAReq (Payment Authentication Request) — сообщение, которое необходимо отправить в ACS вместе с редиректом. Возвращается при успешном ответе в случае оплаты 3D-Secure, если необходим редирект на ACS. Это сообщение содержит данные в кодировке Base64, необходимые для аутентификации держателя карты. Подробнее см. Редирект на ACS.
Необязательно	`termUrl`	String [1..512]	При успешном ответе в случае оплаты 3D-Secure. URL-адрес для перенаправления клиента после взаимодействия с ACS для завершения платежа.
Необязательно	`originalPaymentNetRefNum`	String	Идентификатор оригинальной или предыдущей успешной транзакции в платежной системе по отношению к выполняемой операции по связке - TRN ID. Передается, если значение параметра `tii` = `R`,`U` или `F`. Обязателен при использовании связок мерчанта в переводах по связке.
Условие	`mcTransactionReference`	String [1..19]	Идентификатор AFT транзакции по карте Mastercard. Применимо (и обязательно) только для Mastercard.
Условие	`statusResponse`	Object	Параметры статуса ответа. Этот блок возвращается, только если у вас включена соответствующая настройка. Для включения этой функциональности, обратитесь в техническую поддержку. См. вложенные параметры.
Необязательно	`debitTransactionReference`	String [1..19]	Ссылка на операцию AFT. Этот параметр используется для операций OCT для P2P-переводов (AFT+OCT) с использованием Mastercard. Он автоматически заполняется параметром `statusResponse.debitTransactionReference` из соответствующей транзакции AFT (автоматически сгенерированной платежным шлюзом) или соответствующим параметром, полученным в запросе OCT.

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

Обязательность	Название	Тип	Описание
Обязательно	`is3DSVer2`	Boolean	Возможные значения: `true` или `false` Флаг, показывающий, что платеж поступает из 3DS2.
Обязательно	`threeDSServerTransId`	String [1..36]	Идентификатор транзакции, созданный на сервере 3DS. Обязателен для аутентификации 3DS.
Необязательно	`threeDSMethodUrl`	String [1..512]	URL-адрес сервера ACS для сбора данных браузера.
Обязательно	`threeDSMethodUrlServer`	String [1..512]	URL-адрес сервера 3DS для сбора данных браузера, которые будут включены в AReq (Authentication Request) с сервера 3DS на сервер ACS.
Необязательно	`threeDSMethodDataPacked`	String [1..1024]	Данные CReq (Challenge Response) в кодировке Base-64 для отправки на сервер ACS.
Необязательно	`threeDSMethodURLServerDirect`	String [1..512]	URL-адрес `3dsmethod.do` для выполнения метода 3DS на сервере 3DS через платежный шлюз (при наличии соответствующего разрешения на уровне продавца).

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

Обязательность	Название	Тип	Описание
Условие	`acsUrl`	String [1..512]	URL-адрес для редиректа на ACS. Возвращается при успешном ответе в случае оплаты 3D-Secure, если требуется редирект на ACS. Подробнее см. Редирект на ACS.
Условие	`packedCReq`	String	Запакованные данные challenge request. Возвращается при успешном ответе в случае оплаты 3D-Secure, если требуется редирект на ACS. Это значение следует использовать как значение параметра `creq` ссылки на ACS (`acsUrl`), для перенаправления клиента на ACS. Подробнее см. Редирект на ACS.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`orderStatus`	Integer	Значение этого параметра указывает статус заказа в платежном шлюзе. Отсутствует, если заказ не был найден. Ниже приведен список доступных значений: `0` - заказ зарегистрирован, но не оплачен; `2` - проведена полная авторизация суммы заказа; `3` - авторизация отменена; `5` - инициирована авторизация через ACS банка-эмитента; `6` - авторизация отклонена;
Необязательно	`orderNumber`	String [1..36]	Номер заказа (ID) в системе мерчанта; должен быть уникальным для каждого заказа.
Необязательно	`panMaskedFrom`	String [1..19]	Маскированный номер карты для списания средств.
Необязательно	`panMaskedTo`	String [1..19]	Маскированный номер карты для зачисления средств.
Необязательно	`amount`	Integer [0..12]	Сумма платежа в минимальных единицах валюты (например, в копейках).
Необязательно	`currency`	String [3]	Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию. Допускаются только цифры.
Необязательно	`creationDate`	Integer	Дата регистрации заказа.
Необязательно	`orderDescription`	String [1..600]	Описание заказа передаваемое платежному шлюзу при регистрации. В этом поле недопустимо передавать персональные данные или платежные данные (номера карт т.п.). Данное требование связано с тем, что описание заказа нигде не маскируется.
Необязательно	`ip`	String [1..39]	IP адрес плательщика. IPv6 поддерживается во всех запросах (до 39 символов). При использовании аутентификации 3DS 2 рекомендуем вам передавать в этом параметре реальный IP адрес клиента. Это позволит повысить конверсию в оплату на стороне ACS.
Обязательно	`resultCode`	Integer	Код ошибки при выполнении запроса. Возможные значения: `0` - в случае успеха; `1` - в случае ошибки.
Необязательно	`orderParams`	Object	Объект с мерчантскими атрибутами заказа. В ответе может быть представлено более одного блока `orderParams`. Объект должен передаваться следующим образом: `{"param":"value","param2":"value2"}`.
Необязательно	`operationList`	Object	Объект, содержащий информацию о транзакциях, завершенных в заказе. В ответе может присутствовать более одного блока `operationList`. Параметры, которые можно передать, описаны ниже.
Необязательно	`binding`	String	Идентификатор связки (если она уже была создана). Этот параметр возвращается, только если версия `getP2PStatus` равна 3 или выше.

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

Примеры

Пример первого запроса в случае аутентификации по протоколу 3DS2

curl -X POST 'https://abby.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",
  "fromCard": {
    "vendor": "APPLE",
    "paymentToken": "eyJtZXJjaGFudCI6ICJ...FnXCJ9In0=",
    "decryptedToken":true,
    "protocolVersion":"ECv1"
  },
  "toCard" : {
    "pan" : "4111111111111111"
  },
  "params" : [
        {"name" : "recipientName", "Name" : "Surname"},
        {"name" : "payerName", "value" : "Name1 Surname1"},
        {"name" : "payerCity", "value" : "City"},
        {"name" : "payerCountry", "value" : "Country"},
        {"name" : "payerPostalCode", "value" : "777777"},
        {"name" : "payerState", "value" : "State"},
        {"name" : "payerAddress", "value" : "street, 18"]
  },		
  
}'

Пример второго запроса в случае аутентификации по протоколу 3DS2

curl -X POST 'https://abby.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",
  "fromCard": {
    "cardholderName": "TEST CARDHOLDER",
	"cvc": "123",
	"expirationMonth": 12,
	"expirationYear": 2030,
	"pan": "5000001111111115"
  },
  "toCard": {
    "pan": "4000001111111118"
  },	
  "amount" : 50000,
  "params" : [
        {"name" : "recipientName", "Name" : "Surname"},
        {"name" : "payerName", "value" : "Name1 Surname1"},
        {"name" : "payerCity", "value" : "City"},
        {"name" : "payerCountry", "value" : "Country"},
        {"name" : "payerPostalCode", "value" : "777777"},
        {"name" : "payerState", "value" : "State"},
        {"name" : "payerAddress", "value" : "street, 18"
  "threeDSServerTransId" : "3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSVer2FinishUrl" : "https://example.com/acs2/acs/3dsMethod"
}'

Пример запроса AFT перевода

curl -X POST 'https://abby.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",
    "fromCard": {
        "cardholderName": "TEST CARDHOLDER",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2030,
        "pan": "5000001111111115"
    },
    "amountInput": "1000025",
    "type": "STANDARD"
}'

Пример ответа на первый запрос в случае аутентификации по протоколу 3DS2

{
  "errorCode": 0,
  "is3DSVer2": true,
  "threeDSServerTransId": "3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSMethodURL": "https://example.com/acs2/acs/3dsMethod",
  "threeDSMethodURLServer": "https://example.com/3dsserver/api/v1/client/gather?threeDSServerTransID=3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSMethodDataPacked": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9hY3F1aXJlci5jb20vM2Rzc2VydmVyL2FwaS92MS9hY3Mvbm90aWZpY2F0aW9uP3RocmVlRFNTZXJ2ZXJUcmFuc0lEPTNhZmMxNjhhLTk0YjQtNGViMy04ZTJlLTgwZjZjMTg2NjY5ZCIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiM2FmYzE2OGEtOTRiNC00ZWIzLThlMmUtODBmNmMxODY2NjlkIn0="
}

Пример ответа на второй запрос в случае аутентификации по протоколу 3DS2

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

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

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

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

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Необязательно	`language`	String [2]	Ключ языка по ISO 639-1. Если язык не указан, используется язык по умолчанию, указанный в настройках магазина. Поддерживаемые языки: ru,en,by,pl.
Необязательно	`ip`	String [1..39]	IP адрес плательщика. IPv6 поддерживается во всех запросах (до 39 символов). При использовании аутентификации 3DS 2 рекомендуем вам передавать в этом параметре реальный IP адрес клиента. Это позволит повысить конверсию в оплату на стороне ACS.
Необязательно	`email`	String [1..64]	Электронная почта для отображения на платежной странице. Если для продавца настроены уведомления клиента, электронную почту необходимо указать. Пример: `client_mail@email.com`. Для платежей по VISA с 3DS авторизацией необходимо указать либо электронную почту, либо номер телефона владельца карты.
Необязательно	`type`	String	В случае денежного перевода с данными только по одной карте необходимо передать в этом параметре соответствующее значение: `WITHOUT_FROM_CARD` - без указания карты для списания средств.
Обязательно	`orderId`	String [1..36]	Номер заказа в платежном шлюзе. Уникален в пределах платежного шлюза.
Необязательно	`amountInput`	Integer [0..12]	Сумма перевода в минимальных единицах валюты (например, в копейках). Если в этом параметре указана сумма, перевод будет осуществлен на эту сумму (независимо от суммы, переданной в запросе на оформление заказа).
Необязательно	`amountInput`	Integer [0..12]	Сумма перевода в минимальных единицах валюты (например, в копейках). Если в этом параметре указана сумма, перевод будет осуществлен на эту сумму (независимо от суммы, переданной в запросе на оформление заказа).
Необязательно	`captcha`	String	CAPTCHA (текст, предназначенный для того, чтобы отличать человеческий ввод от машинного)
Необязательно	`threeDSSDK`	Boolean	Возможные значения: `true` или `false` Флаг, показывающий, что платеж поступает из 3DS SDK.
Необязательно	`threeDSSDKEncData`	String	Зашифрованные данные об устройстве. Параметр является обязательным для SDK.
Необязательно	`threeDSSDKReferenceNumber`	String	Официальный идентификатор 3DS2 SDK
Необязательно	`threeDSSDKEphemPubKey`	String	Публичная часть эфемерного ключа. Требуется для установки сеанса с ACS. Параметр является обязательным для SDK.
Необязательно	`threeDSSDKAppId`	String	Уникальный идентификатор SDK. Параметр является обязательным для SDK.
Необязательно	`threeDSSDKTransId`	String	Уникальный идентификатор транзакции в SDK. Параметр является обязательным для SDK.
Необязательно	`threeDSMethodNotificationUrl`	String [1..512]	URL-адрес для отправки уведомления о прохождении проверки на ACS.
Условие	`threeDSServerTransId`	String [1..36]	Идентификатор транзакции, созданный на сервере 3DS. Обязателен для аутентификации 3DS.
Необязательно	`threeDSVer2FinishUrl`	String [1..512]	URL-адрес, по которому клиент должен быть перенаправлен после аутентификации на сервере ACS.
Условие	`threeDSVer2MdOrder`	String [1..36]	Номер заказа, который был зарегистрирован в первой части запроса в рамках 3DS2 операции. Обязателен для аутентификации 3DS. Если данный параметр присутствует в запросе, то используется `mdOrder`, который передается в настоящем параметре. В таком случае регистрация заказа не происходит, а происходит сразу оплата заказа. Этот параметр передается только при использовании методов мгновенной оплаты, т.е., когда заказ регистрируется и оплачивается в рамках одного запроса.
Необязательно	`bindingNotNeeded`	Boolean	Допустимые значения: `true`- создание связки после совершения платежа отключено (связка – это идентификатор клиента, переданный в запросе на регистрацию заказа, который после запроса оплаты будет удален из деталей заказа); `false` – в случае успешной оплаты может быть создана связка (при соблюдении необходимых условий). Это значение по умолчанию.
Условие	`originalPaymentNetRefNum`	String	Идентификатор оригинальной или предыдущей успешной транзакции в платежной системе по отношению к выполняемой операции по связке - TRN ID. Передается, если значение параметра `tii` = `R`,`U` или `F`. Обязателен при использовании связок мерчанта в переводах по связке.
Условие	`tii`	String	Идентификатор инициатора транзакции. Параметр, указывающий, какой тип операции будет выполнять инициатор (Клиент или Мерчант). Обязательно для перевода с использованием связки в блоке `fromCard` или собственной связки мерчанта. Возможные значения
Необязательно	`params`	Object	Поля дополнительной информации для последующего хранения, передаются в следующем виде: `{"param":"value","param2":"value2"}`. Данные поля могут быть переданы в процессинг банка для последующего отображения в реестрах банка. По умолчанию передаются `orderNumber` (номер заказа) и `orderDescription` (описание заказа).`orderDescription` не должно превышать 99 символов, не используйте следующие символы: `%`, `+`, возврат каретки `\r` и перевод строки `\n`). Чтобы включить эту функциональность, обратитесь в банк. В объекте `params` запроса на перевод денег с карты на карту могут быть переданы следующие данные клиента (формат значений зависит от используемого метода обработки данных): В параметре `payerName` - имя отправителя денег. В параметре `payerAddress` - адрес отправителя. В параметре `payerCity` - город отправителя. В параметре `payerCountry` - страна отправителя в виде кода ISO 3166-1 alpha-3 (трехбуквенный код). В параметре `payerPostalCode` - почтовый индекс отправителя. В параметре `payerState` - регион отправителя. Для платежной системы Visa в запросе на перевод денег с карты на карту также необходимо передать в параметре `params` следующую информацию (формат значений определяется используемым методом обработки данных): В параметре `recipientName` - имя получателя денег. При необходимости обратитесь в команду поддержки для указания постоянных значений параметров `payer*` и `recipientName`, чтобы не передавать их каждый раз во всех запросах.
Необязательно	`shippingPayerData`	Object	Объект, содержащий данные о доставке клиенту. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`preOrderPayerData`	Object	Объект, содержащий данные предварительного заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`orderPayerData`	Object	Объект, содержащий данные о плательщике заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`billingAndShippingAddressMatchIndicator`	String [1]	Индикатор соответствия платежного адреса владельца карты и адреса доставки. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. Возможные значения: `Y` - совпадение платежного адреса держателя карты и адреса доставки; `N` - платежный адрес владельца карты и адрес доставки не совпадают.
Условие	`billingPayerData`	Object	Блок с регистрационными данными клиента (адрес, почтовый индекс), необходимый для прохождения проверки адреса в рамках сервисов AVS/AVV. Обязателен, если функция включена для продавца на стороне Платежного шлюза. См. вложенные параметры.
Обязательно	`toCard`	Object	Блок с атриубутами карты начисления. См. вложенные параметры.

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

Значение `tii`	Описание	Тип транзакции	Инициатор транзакции	Данные карты для транзакции	Данные карты сохраняются после транзакции	Комментарий
CI	Инициирующий - Обычный (CIT)	Инициирующая	Покупатель	Вводится покупателем	Да	Транзакция электронной коммерции с сохранением связки.
F	Внеплановый платеж (CIT)	Последующая	Покупатель	Клиент выбирает карту вместо ручного ввода	Нет	Транзакция электронной коммерции, использующая ранее сохраненную обычную связку.

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

Обязательность	Название	Тип	Описание
Условие	`bindingId`	String [1..255]	Идентификатор связки, созданной при оплате заказа или использованной для оплаты. Доступно, только если продавцу разрешено создавать связки.
Условие	`pan`	String [1..19]	Номер карты для зачисления денежных средств.
Необязательно	`expirationYear`	Integer [4]	Год истечения действия карты зачисления. Принимаются значения от 2000 до 2200.
Необязательно	`expirationMonth`	Integer [2]	Месяц истечения действия карты зачисления. Доступные значения: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12.
Необязательно	`cardholderName`	String [1..26]	Имя держателя карты зачисления.
Условие	`seToken`	String	Зашифрованные данные карты. Обязательно, если используется вместо данных карты. Обязательные параметры для строки seToken: `timestamp`, `UUID`, `PAN`, `EXPDATE`, `MDORDER`. Подробнее о генерации seToken см. здесь.

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

Обязательность	Название	Тип	Описание
Необязательно	`shippingCity`	String [1..50]	Город заказчика (из адреса доставки)
Необязательно	`shippingCountry`	String [1..50]	Страна заказчика
Необязательно	`shippingAddressLine1`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine2`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine3`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingPostalCode`	String [1..16]	Почтовый индекс клиента для доставки
Необязательно	`shippingState`	String [1..50]	Штат/регион покупателя (из адреса доставки)
Необязательно	`shippingMethodIndicator`	Integer [2]	Индикатор способа доставки. Возможные значения: `01` - доставка на платежный адрес держателя карты. `02` - доставка на другой адрес, проверенный Мерчантом. `03` - доставка по адресу, отличному от основного адреса держателя карты. `04` - отправка в магазин/самовывоз (адрес магазина должен быть указан в соответствующих параметрах доставки) `05` - Цифровое распространение (включает онлайн-сервисы и электронные подарочные карты) `06` - билеты на путешествия и мероприятия, которые нельзя доставить. `07` - Прочее (например, игры, цифровые товары, не подлежащие доставке, цифровые подписки и т. д.)
Необязательно	`deliveryTimeframe`	Integer [2]	Срок поставки товара. Возможные значения: `01` - цифровая дистрибуция `02` - доставка в тот же день `03` - доставка на следующий день `04` - доставка в течение 2-х дней после оплаты и позже.
Необязательно	`deliveryEmail`	String [1..254]	Целевой адрес электронной почты для доставки цифрового распространения. Предпочтительно передавать электронную почту в самостоятельном параметре запроса `email` (но если вы передадите его в этом блоке, к нему применятся те же правила).

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

Обязательность	Название	Тип	Описание
Необязательно	`preOrderDate`	String [10]	Ожидаемая дата доставки (для предзаказанных покупок) в формате ГГГГММДД.
Необязательно	`preOrderPurchaseInd`	Integer [2]	Индикатор размещения клиентом заказа на доступную или будущую доставку. Возможные значения: `01` - возможна доставка; `02` - будущая доставка
Необязательно	`reorderItemsInd`	Integer [2]	Индикатор того, что клиент перебронирует ранее оплаченную доставку в составе нового заказа. Возможные значения: `01` - заказ размещается впервые; `02` - повторный заказ

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

Обязательность	Название	Тип	Описание
Необязательно	`homePhone`	String [7..15]	Домашний телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`workPhone`	String [7..15]	Рабочий телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`mobilePhone`	String [7..15]	Номер мобильного телефона владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.` Для платежей по VISA с 3DS авторизацией необходимо указать либо электронную почту, либо номер телефона владельца карты. Если у вас настроено отображение номера телефона на платежной странице и вы указали неверный номер телефона, клиент сможет исправить его на платежной странице.

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

Обязательность	Название	Тип	Описание
Необязательно	`billingCity`	String [0..50]	Город, зарегистрированный по конкретной карте у Банка Эмитента.
Необязательно	`billingCountry`	String [0..50]	Страна, зарегистрированная по конкретной карте банка-эмитента. Формат: ISO 3166-1 (Alpha 2 / Alpha 3 / Number-3) или наименование страны. Рекомендуем передавать двух/трехбуквенный ISO код страны.
Необязательно	`billingAddressLine1`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента (адрес плательщика). Строка 1. Обязательно к передаче для AVS-проверки.
Необязательно	`billingAddressLine2`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 2.
Необязательно	`billingAddressLine3`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 3.
Необязательно	`billingPostalCode`	String [0..9]	Почтовый индекс, зарегистрированный по конкретной карте у Банка Эмитента. Обязательно к передаче для AVS-проверки.
Необязательно	`billingState`	String [0..50]	Штат, зарегистрированный по конкретной карте у Банка Эмитента. Формат: полное значение кода ISO 3166-2, его часть или наименование штата/региона. Может содержать буквы только латинского алфавита. Рекомендуем передавать двухбуквенный ISO код штата/региона.

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

Обязательно	Название	Тип	Описание
Необязательно	`threeDSServerTransId`	String [1..36]	Идентификатор транзакции, созданный на сервере 3DS. Обязателен для аутентификации 3DS.
Необязательно	`threeDSVer2FinishUrl`	String [1..512]	URL-адрес, по которому клиент должен быть перенаправлен после аутентификации на сервере ACS.
Необязательно	`threeDSMethodNotificationUrl`	String [1..512]	URL-адрес для отправки уведомления о прохождении проверки на ACS.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`info`	String	Результат попытки перевода средств. Значение в случае успешного перевода: "Ваш платеж обработан, происходит переадресация..." Значение в случае ошибки: "Происходит переадресация..."
Условие	`acsUrl`	String [1..512]	URL-адрес для редиректа на ACS. Возвращается при успешном ответе в случае оплаты 3D-Secure, если требуется редирект на ACS. Подробнее см. Редирект на ACS.
Условие	`paReq`	String [1..255]	PAReq (Payment Authentication Request) — сообщение, которое необходимо отправить в ACS вместе с редиректом. Возвращается при успешном ответе в случае оплаты 3D-Secure, если необходим редирект на ACS. Это сообщение содержит данные в кодировке Base64, необходимые для аутентификации держателя карты. Подробнее см. Редирект на ACS.
Условие	`termUrl`	String [1..512]	При успешном ответе в случае оплаты 3D-Secure. Это URL-адрес, на который ACS перенаправляет владельца карты после аутентификации. Подробнее см. Редирект на ACS.
Условие	`statusResponse`	Object	Параметры статуса ответа. Этот блок возвращается, только если у вас включена соответствующая настройка. Для включения этой функциональности, обратитесь в техническую поддержку. См. вложенные параметры.

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

Обязательность	Название	Тип	Описание
Обязательно	`is3DSVer2`	Boolean	Возможные значения: `true` или `false` Флаг, показывающий, что платеж поступает из 3DS2.
Обязательно	`threeDSServerTransId`	String [1..36]	Идентификатор транзакции, созданный на сервере 3DS. Обязателен для аутентификации 3DS.
Необязательно	`threeDSMethodUrl`	String [1..512]	URL-адрес сервера ACS для сбора данных браузера.
Обязательно	`threeDSMethodUrlServer`	String [1..512]	URL-адрес сервера 3DS для сбора данных браузера, которые будут включены в AReq (Authentication Request) с сервера 3DS на сервер ACS.
Необязательно	`threeDSMethodDataPacked`	String [1..1024]	Данные CReq (Challenge Response) в кодировке Base-64 для отправки на сервер ACS.
Необязательно	`threeDSMethodURLServerDirect`	String [1..512]	URL-адрес `3dsmethod.do` для выполнения метода 3DS на сервере 3DS через платежный шлюз (при наличии соответствующего разрешения на уровне продавца).

Обязательность	Название	Тип	Описание
Условие	`acsUrl`	String [1..512]	URL-адрес для редиректа на ACS. Возвращается при успешном ответе в случае оплаты 3D-Secure, если требуется редирект на ACS. Подробнее см. Редирект на ACS.
Условие	`packedCReq`	String	Запакованные данные challenge request. Возвращается при успешном ответе в случае оплаты 3D-Secure, если требуется редирект на ACS. Это значение следует использовать как значение параметра `creq` ссылки на ACS (`acsUrl`), для перенаправления клиента на ACS. Подробнее см. Редирект на ACS.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`orderStatus`	Integer	Значение этого параметра указывает статус заказа в платежном шлюзе. Отсутствует, если заказ не был найден. Ниже приведен список доступных значений: `0` - заказ зарегистрирован, но не оплачен; `2` - проведена полная авторизация суммы заказа; `3` - авторизация отменена; `5` - инициирована авторизация через ACS банка-эмитента; `6` - авторизация отклонена;
Необязательно	`orderNumber`	String [1..36]	Номер заказа (ID) в системе мерчанта; должен быть уникальным для каждого заказа.
Необязательно	`panMaskedFrom`	String [1..19]	Маскированный номер карты для списания средств.
Необязательно	`panMaskedTo`	String [1..19]	Маскированный номер карты для зачисления средств.
Необязательно	`amount`	Integer [0..12]	Сумма платежа в минимальных единицах валюты (например, в копейках).
Необязательно	`currency`	String [3]	Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию. Допускаются только цифры.
Необязательно	`creationDate`	Integer	Дата регистрации заказа.
Необязательно	`orderDescription`	String [1..600]	Описание заказа передаваемое платежному шлюзу при регистрации. В этом поле недопустимо передавать персональные данные или платежные данные (номера карт т.п.). Данное требование связано с тем, что описание заказа нигде не маскируется.
Необязательно	`ip`	String [1..39]	IP адрес плательщика. IPv6 поддерживается во всех запросах (до 39 символов). При использовании аутентификации 3DS 2 рекомендуем вам передавать в этом параметре реальный IP адрес клиента. Это позволит повысить конверсию в оплату на стороне ACS.
Обязательно	`resultCode`	Integer	Код ошибки при выполнении запроса. Возможные значения: `0` - в случае успеха; `1` - в случае ошибки.
Необязательно	`orderParams`	Object	Объект с мерчантскими атрибутами заказа. В ответе может быть представлено более одного блока `orderParams`. Объект должен передаваться следующим образом: `{"param":"value","param2":"value2"}`.
Необязательно	`operationList`	Object	Объект, содержащий информацию о транзакциях, завершенных в заказе. В ответе может присутствовать более одного блока `operationList`. Параметры, которые можно передать, описаны ниже.
Необязательно	`binding`	String	Идентификатор связки (если она уже была создана). Этот параметр возвращается, только если версия `getP2PStatus` равна 3 или выше.

Примеры

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

curl -X POST 'https://abby.rbsuat.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "fromCard" : {
     "seToken": "ofVx1r3aIJ3Mlx3nkfeOIJgFOnwfsgFK+V6Yzm+KxJgsq19l74GChhX0We/LEFq78Rhn9uFAEZGdeyDhnIc/KfuvObf0EzoDA65Uj1Z8FjwWyjnEwTBHZL4KmdFBCSk8jLxHt70mXwyjiHYyCVH1fT/UVOnsrkZVGrqmEG4MTi5dX9Znzf24DwRg4iezvdT8vf0dUW5lJdvY1tgOsOnBulwy6kH/YbHVsnR6yxO6d6IsdnT5f8PxaB+7ZyUqgrd6VA88FGJKJgdoxk4721pqKSG5dYroLJG96s23EDJ2Hpi4e9wU2rP7E6dlFw+qzATqX/eaJbaQ9eakkdMWnkj7aQ=="
  },
  "toCard": {
        "cardholderName": "TEST CARDHOLDER",
        "expirationMonth": 12,
        "expirationYear": 2029,
        "pan": "5555555555555599"
  },
  "type" : "WITHOUT_FROM_CARD",
  "orderId" : "3dbaf8bb-1d68-76b3-b4e6-784700f26b04",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user"
}'

Пример первого запроса в случае аутентификации по протоколу 3DS2

curl -X POST 'https://abby.rbsuat.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "933",
  "fromCard" : {
    "bindingId" : "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
  },
  "orderId" : "38b7a9e0-7cfa-46f7-8655-f206a8898e7a",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user",
  "params" : {
    "name" : "payerAddress",
    "value" : "payer Address"
  }
}'

Пример второго запроса в случае аутентификации по протоколу 3DS2

curl -X POST 'https://abby.rbsuat.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "933",
  "fromCard" : {
    "bindingId" : "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
  },
  "orderId" : "38b7a9e0-7cfa-46f7-8655-f206a8898e7a",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user",
  "params" : {
    "name" : "payerAddress",
    "value" : "payer Address"
  },
  "threeDSServerTransId" : "f44d6d21-1874-45a5-aeb0-1c710dd6e134",
  "threeDSVer2FinishUrl" : "https://example.com/acs2/acs/3dsMethod"
}'

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

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

Пример ответа на первый запрос в случае аутентификации по протоколу 3DS2

{
  "errorCode": 0,
  "is3DSVer2": true,
  "threeDSServerTransId": "f44d6d21-1874-45a5-aeb0-1c710dd6e134",
  "threeDSMethodURLServer": "https://example.com/3dsserver/api/v1/client/gather?threeDSServerTransID=f44d6d21-1874-45a5-aeb0-1c710dd6e134",
}

Пример ответа на второй запрос в случае аутентификации по протоколу 3DS2

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

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

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

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

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Необязательно	`language`	String [2]	Ключ языка по ISO 639-1. Если язык не указан, используется язык по умолчанию, указанный в настройках магазина. Поддерживаемые языки: ru,en,by,pl.
Условие	`orderId`	String [1..36]	Номер заказа в платежном шлюзе. Уникален в пределах платежного шлюза.
Условие	`orderNumber`	String [1..36]	Номер заказа (ID) в системе мерчанта; должен быть уникальным для каждого заказа.

В запросе должен присутствовать либо orderId, либо orderNumber.

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

Обязательность	Название	Тип	Описание
Обязательно	`errorCode`	String [1..2]	Информационный параметр в случае ошибки, который может иметь разные кодовые значения: значение `0` - указывает на успех обработки запроса; другое числовое значение (`1`-`99`) - указывает на ошибку, для получения более подробной информации о которой необходимо проверить параметр `errorMessage`. Может отсутствовать, если результат не вызвал ошибки. Если запрос, связанный с оплатой заказа, обработан успешно, это еще не означает, что сам платеж прошел успешно. Чтобы определить, был ли платеж успешным или нет, используйте вызов getP2PStatus.do.
Обязательно	`errorMessage`	String [1..512]	Информационный параметр, являющийся описанием ошибки в случае возникновения ошибки. Значение `errorMessage` может варьироваться, поэтому не следует явным образом ссылаться на его значения в коде. Язык описания задается в параметре `language` запроса.
Необязательно	`orderStatus`	Integer	Значение этого параметра указывает статус заказа в платежном шлюзе. Отсутствует, если заказ не был найден. Ниже приведен список доступных значений: `0` - заказ зарегистрирован, но не оплачен; `2` - проведена полная авторизация суммы заказа; `3` - авторизация отменена; `5` - инициирована авторизация через ACS банка-эмитента; `6` - авторизация отклонена;
Необязательно	`orderNumber`	String [1..36]	Номер заказа (ID) в системе мерчанта; должен быть уникальным для каждого заказа.
Необязательно	`panMaskedFrom`	String [1..19]	Маскированный номер карты для списания средств.
Необязательно	`panMaskedTo`	String [1..19]	Маскированный номер карты для зачисления средств.
Необязательно	`amount`	Integer [0..12]	Сумма платежа в минимальных единицах валюты (например, в копейках).
Необязательно	`currency`	String [3]	Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию. Допускаются только цифры.
Необязательно	`creationDate`	Integer	Дата регистрации заказа.
Необязательно	`orderDescription`	String [1..600]	Описание заказа передаваемое платежному шлюзу при регистрации. В этом поле недопустимо передавать персональные данные или платежные данные (номера карт т.п.). Данное требование связано с тем, что описание заказа нигде не маскируется.
Необязательно	`ip`	String [1..39]	IP адрес плательщика. IPv6 поддерживается во всех запросах (до 39 символов). При использовании аутентификации 3DS 2 рекомендуем вам передавать в этом параметре реальный IP адрес клиента. Это позволит повысить конверсию в оплату на стороне ACS.
Обязательно	`resultCode`	Integer	Код ошибки при выполнении запроса. Возможные значения: `0` - в случае успеха; `1` - в случае ошибки.
Необязательно	`orderParams`	Object	Объект с мерчантскими атрибутами заказа. В ответе может быть представлено более одного блока `orderParams`. Объект должен передаваться следующим образом: `{"param":"value","param2":"value2"}`.
Необязательно	`operationList`	Object	Объект, содержащий информацию о транзакциях, завершенных в заказе. В ответе может присутствовать более одного блока `operationList`. Параметры, которые можно передать, описаны ниже.
Необязательно	`binding`	String	Идентификатор связки (если она уже была создана). Этот параметр возвращается, только если версия `getP2PStatus` равна 3 или выше.

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

Обязательность	Название	Тип	Описание
Необязательно	`operationType`	String	Тип транзакции. Доступны следующие значения: P2P_VERIFY - запрашивает сумму комиссии; P2P_DEBIT - списывает деньги; P2P_CREDIT - зачисляет деньги; P2P_DEBIT_REVERSAL - отмена списания; P2P_CREDIT_REVERSAL — отмена зачисления; P2P_TRANSFER - перевод денег с карты на карту; P2P_TRANSFER_REVERSAL - автоматический возврат, если при переводе произошла ошибка.
Необязательно	`amount`	Integer [0..12]	Сумма платежа в минимальных единицах валюты (например, в копейках).
Необязательно	`currency`	String [3]	Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию. Допускаются только цифры.
Необязательно	`datetime`	String	Дата и время совершения операции.
Необязательно	`resultCode`	String	Код ответа от процессинга банка. Содержит числовое значение. См. список кодов ответа здесь.
Необязательно	`resultCodeDescription`	String [1..512]	Описание кода ошибки транзакции.
Необязательно	`maskedPan`	String [1..19]	Маскированный номер карты или токена, использованного для оплаты.
Необязательно	`cardholderName`	String [1..26]	Имя держателя карты (при наличии).
Необязательно	`refNum`	String [12]	Уникальный идентификатор операции, присваиваемый банком-эквайером при проведении платежа по банковской карте. RRN создаётся исключительно банком-эквайером и используется для последующего поиска, проверки и урегулирования операций (включая возвраты, чарджбеки и расследования).

Примеры

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

curl -X POST 'https://abby.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": "933",
  "creationDate": 1674137044330,
  "orderParams": [],
  "operationList": [],
  "resultCode": 0
}

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

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

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

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

Обязательность	Название	Тип	Описание
Обязательно	`username`	String [1..30]	Логин учетной записи API продавца.
Обязательно	`password`	String [1..30]	Пароль учетной записи API продавца.
Обязательно	`tDsTransId`	String [1..36]	Уникальный идентификатор транзакции, полученный от сервера 3DS.

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

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

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

Примеры

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

curl --request POST \
  --url https://abby.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

OCT транзакции

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

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

API-вызовы

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

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

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

Примеры

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

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

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

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

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

Примеры

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

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

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

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

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

Примеры

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

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

P2P перевод

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

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

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

Примеры

Пример первого запроса в случае аутентификации по протоколу 3DS2

Пример второго запроса в случае аутентификации по протоколу 3DS2

Пример запроса AFT перевода

Пример ответа на первый запрос в случае аутентификации по протоколу 3DS2

Пример ответа на второй запрос в случае аутентификации по протоколу 3DS2

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

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

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

Примеры

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

Пример первого запроса в случае аутентификации по протоколу 3DS2

Пример второго запроса в случае аутентификации по протоколу 3DS2

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

Пример ответа на первый запрос в случае аутентификации по протоколу 3DS2

Пример ответа на второй запрос в случае аутентификации по протоколу 3DS2

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

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

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

Примеры

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

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

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

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

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

Примеры

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

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

Свяжитесь с нами

Спасибо!