P2P-переводы

P2P-транзакция

Функциональность P2P помогает вам предоставить пользователям (текущим или потенциальным клиентам) возможность отправлять деньги друг другу. Также она позволяет принимать переводы на ваши карты, не отправляя никому свои данные, и зарабатывать комиссионные, предоставляя услугу широкому кругу пользователей.

Услуга P2P — это услуга, доступная для настройки и интеграции со сторонними веб-сайтами, мобильными приложениями, а также интернет- и мобильными банками.

Пользователям доступен полный перечень операций, отправка/получение переводов, регистрация/авторизация в сервисе, управление сохраненными картами.

Важной особенностью сервиса P2P является возможность совершать переводы по номеру телефона, даже если пользователь еще не зарегистрирован в системе.

Существует несколько сценариев реализации P2P-транзакций:

• Данные держателя карты вводятся на стороне шлюза
• Данные держателя карты вводятся на стороне Интернет-магазина

Ввод данных карты на стороне шлюза

Схема взаимодействия

1. На сайте продавца (например, в интернет-магазине) держатель карты запрашивает выполнение денежного перевода P2P.
2. Система интернет-магазина регистрирует заказ в Платежном шлюзе через registerP2P.do. Используемые параметры регистрации включают сумму перевода, валюту, номер заказа в системе продавца и URL возврата для клиента.
   
3. Платежный шлюз в ответ на запрос регистрации возвращает уникальный идентификатор заказа в платежной системе и URL для перенаправления клиента на форму сбора карточных данных.
4. Система интернет-магазина передает URL-адрес перенаправления, полученный на Шаге 3, браузеру клиента.
5. Браузер клиента открывает URL-адрес.
6. По указанному URL браузер клиента получает форму для сбора карточных данных.
7. Клиент заполняет форму, и данные отправляются на сервер платежного шлюза.
8. Система проверяет принадлежность карты к 3-D Secure (SecureCode).
9. Шлюз отправляет ссылку перенаправления на страницу сервера управления доступом (ACS) банка-эмитента в веб-браузер клиента (этот шаг необходим для реализации 3DS).
10. Веб-браузер клиента запрашивает форму авторизации пользователя из ACS.
11. ACS отправляет форму авторизации в веб-браузер клиента.
12. Клиент заполняет форму, и данные отправляются на сервер платежного шлюза.
13. ACS обрабатывает форму и, независимо от результата, отправляет URL-адрес перенаправления страниц платежного шлюза в веб-браузер клиента. Вместе с этим URL отправляются зашифрованные параметры результата авторизации.
14. Веб-браузер клиента запрашивает страницу платежного шлюза при передаче зашифрованных параметров результата авторизации.
15. Платежный шлюз переводит деньги.
16. Когда деньги переведены, платежный шлюз отправляет обратный URL-адрес в веб-браузер клиента (URL-адрес был указан при регистрации заказа интернет-магазином на Шаге 2).
17. Веб-браузер клиента запрашивает результаты перевода денег из интернет-магазина.
18. Система интернет-магазина запрашивает информацию о статусе заказа у платежного шлюза – getP2PStatus.do.
    
19. Платежный шлюз возвращает статус заказа.
20. Система интернет-магазина показывает клиенту результат оплаты.

Ввод данных карты на стороне интернет-магазина

Схема взаимодействия

1. Держатель карты (клиент) взаимодействует с интернет-магазином для создания заказа.
2. Система интернет-магазина регистрирует заказ в Платежном шлюзе через registerP2P.do. Используемые параметры регистрации включают сумму перевода, валюту, номер заказа в системе продавца и URL возврата для клиента.
   
3. Платежный шлюз в ответ на запрос регистрации возвращает уникальный идентификатор заказа в платежной системе и URL для перенаправления клиента на форму сбора карточных данных.
4. Система интернет-магазина передает URL-адрес перенаправления, полученный на Шаге 3, браузеру клиента.
5. Клиент заполняет форму и отправляет данные.
6. Необязательно. Если интернет-магазин работает с комиссией, интернет-магазин отправляет платежному шлюзу запрос на сумму комиссии через verifyP2P.do / verifyP2PByBinding.do.
   
7. Необязательно. Платежный шлюз отправляет в ответ сумму комиссии.
8. Интернет-магазин отправляет запрос на перевод средств в Платежный шлюз через performP2P.do / performP2PByBinding.do.
   На этом этапе инициируется работа 3DS 2.0.
   
9. Платежный шлюз проверяет на сервере 3DS, может ли клиент аутентифицироваться с использованием протокола 2.0.
10. Платежный шлюз отправляет ответ на запрос, сделанный на Шаге 6. Ответ также возвращает следующие параметры:
    
    • is3DSVer2 - флаг возможности аутентификации 3DSv2 (true/false)
    • threeDSServerTransId - идентификатор транзакции, присвоенный сервером 3DS
    • threeDSMethodURLServer - адрес сервера 3DS для сбора данных браузера
    • threeDSMethodURL - (необязательно) адрес сервера ACS для сбора данных браузера
    • threeDSMethodDataPacked - (необязательно) данные для сбора данных браузера на ACS
    
    (См. также описание запроса).
11. Интернет-магазин вызывает threeDSMethodURLServer в отдельном iframe с помощью метода POST, используя значение, полученное из ответа на запрос на перевод средств. Это позволяет серверу 3DS собирать данные о браузере клиента.
12. Необязательный шаг. Если в ответе на запрос о переводе средств были получены параметры threeDSMethodURL и threeDSMethodDataPacked, интернет-магазин вызывает в отдельном iframe методом POST threeDSMethodURL.
    
13. Перевод средств - этап 2. Интернет-магазин повторно отправляет запрос на выполнение перевода через performP2P.do / performP2PByBinding.do.
    Необъодимо передать параметр threeDSServerTransId - идентификатор транзакции, который был создан сервером 3DS и возвращен на Шаге 10.
    
14. Платежный шлюз отправляет запрос на аутентификацию на сервер 3DS.
15. Сервер 3DS отправляет запрос аутентификации (AReq) на сервер ACS.
16. Сервер ACS отправляет ответ на запрос аутентификации (ARes) на сервер 3DS.
17. Сервер 3DS отправляет полученные данные в платежный шлюз.
18. 
    
    • Если клиенту не нужно проходить аутентификацию в ACS, платежный шлюз возвращает ответ на запрос о переводе средств. В этом случае сценарий продолжается с Шага 27.
    • Если клиенту необходимо пройти аутентификацию в ACS, Платежный шлюз отправит ответ на платежную страницу с данными перенаправления на ACS.
19. Страница оплаты перенаправляется на acsUrl с параметром creq=packedCReq.
20. ACS отображает страницу аутентификации для клиента (страница challenge).
21. Клиент аутентифицирован.
22. Сервер ACS проверяет подлинность данных аутентификации.
23. Происходит обмен данными между серверами ACS и 3DS и подтверждается результат обработки.
24. Сервер ACS перенаправляет клиента на страницу магазина.
25. Интернет-магазин отправляет запрос finish3dsVer2Payment.do платежному шлюзу.
26. Платежный шлюз отправляет интернет-магазину ответ на сделанный запрос.
27. Интернет-магазин отправляет getP2PStatus.do в платежный шлюз, чтобы узнать статус заказа.
28. Платежный шлюз отправляет ответ на сделанный запрос.
29. Интернет-магазин отображает страницу результата клиенту.

AFT-транзакция

AFT (Account Funding Transaction) – oсобый вид операций по списанию средств с целью пополнения внутреннего счета клиента в системе мерчанта или банковского счета в системе банка (часто используется как альтернатива операции покупки).

В случае AFT-транзакций схема взаимодействия такая же, как и для транзакций P2P. Отличие в том, что в AFT-транзакции указываются только данные карты списания.

OCT-транзакция

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

Схема взаимодействия

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-вызовы

Запросы по P2P-транзакциям должны быть подписаны. Информация о подписях запросов доступна в нашем Руководстве по API.

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

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

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

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

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

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

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

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

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

Примеры

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

curl -X POST 'https://dev.processing.ae/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "1"
}'

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

curl -X POST 'https://dev.processing.ae/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "12",
  "clientId": "122313",
  "bindingId": "59aaf552-cdae-70de-a092-8f8c00a9fba0",
  "transactionTypeIndicator": "A",
  "features":{
      "feature":["FEATURE_1", "FEATURE_2", .. "FEATURE_N"]
   }
}'

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

curl -X POST 'https://dev.processing.ae/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "12",
  "clientId": "122313",
  "creditBindingId": "99ef0cee-34fe-7312-ad7c-78bc00b3236a",
  "transactionTypeIndicator": "A",
  "features":{
      "feature":["FEATURE_1", "FEATURE_2", .. "FEATURE_N"]
   }
}'

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

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

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

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

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

В зависимости от бизнес-процессов, при проведение перевода с карты на карту могут быть возможны следующие варианты:

• В платежный шлюз передаются данные карты списания и данные карты зачисления денежных средств. В этом случае в запросе должны присутствовать оба блока параметров — fromCard и toCard.
• Если зачисление на карту производится сторонней системой, то в платежный шлюз передаются только данные карты списания. В этом случае должен быть заполнен только один блок параметров – fromCard
• Если списание с карты производится сторонней системой, то в платежный шлюз передаются только данные карты зачисления. В этом случае должен быть заполнен только один блок параметров – toCard

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

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

Блок fromCard (если списание производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

Блок toCard (если зачисление производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

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

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

Примеры

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

curl -X POST 'https://dev.processing.ae/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",
  "fromCard": {
    "cardholderName": "TEST CARDHOLDER",
    "cvc": "123",
    "expirationMonth": 12,
    "expirationYear": 2030,
    "pan": "5000001111111115"
  },
  "toCard": {
    "pan": "4000001111111118"
  },    
  "amount" : 50000
}'

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

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

P2P перевод

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

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

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

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

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

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

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

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

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

Блок fromCard (если списание производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

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

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

Блок toCard (если зачисление производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

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

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

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

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

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

* Обязательный, если нужен редирект на ACS

Примеры

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

curl -X POST 'https://dev.processing.ae/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": "eyJkZXZpY2VNYW51ZmFjdHVyZXJJZGVudGlmaWVyIjoiMDUwMTEwMDMwMjczIiwiY3VycmVuY3lDb2RlIjoiOTc4IiwiYXBwbGljYXRpb25FeHBpcmF0aW9uRGF0ZSI6IjI3MDEzMSIsInBheW1lbnREYXRhIjp7Im9ubGluZVBheW1lbnRDcnlwdG9ncmFtIjoiQUc5WW5Pak1YOUJXQUFSaElJOFBBb0FCRkE9PSJ9LCJwYXltZW50RGF0YVR5cGUiOiIzRFNlY3VyZSIsInRyYW5zYWN0aW9uQW1vdW50IjoxMDAsImFwcGxpY2F0aW9uUHJpbWFyeUFjY291bnROdW1iZXIiOiI1NTU1NTU1NTU1NTU1NTk5In0=",
    "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"]
  },        

}'

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

curl -X POST 'https://dev.processing.ae/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"
}'

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

{
  "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="
}

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

Блок fromCard (если списание производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

Блок toCard (если зачисление производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

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

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

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

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

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

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

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

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

* Обязательный если нужен редирект на ACS

Примеры

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

curl -X POST 'https://dev.processing.ae/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": "IVAN IVANOV",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2024,
        "pan": "5555555555555599"
  },
  "orderId" : "3dbaf8bb-1d68-76b3-b4e6-784700f26b04",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user"
}'

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

curl -X POST 'https://dev.processing.ae/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "978",
  "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"
  }
}'

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

curl -X POST 'https://dev.processing.ae/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "978",
  "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
}

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

{
  "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",
}

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

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

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

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

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

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

Блок fromCard (если списание производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

Блок toCard (если зачисление производится сторонней системой, то этот блок должен отсутствовать) включает в себя следующие параметры:

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

Примеры

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

curl --location --request POST 'https://dev.processing.ae/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",
    "fromCard": {
        "seToken": "ofVx1r3aIJ3Mlx3nkfeOIJgFOnwfsgFK+V6Yzm+KxJgsq19l74GChhX0We/LEFq78Rhn9uFAEZGdeyDhnIc/KfuvObf0EzoDA65Uj1Z8FjwWyjnEwTBHZL4KmdFBCSk8jLxHt70mXwyjiHYyCVH1fT/UVOnsrkZVGrqmEG4MTi5dX9Znzf24DwRg4iezvdT8vf0dUW5lJdvY1tgOsOnBulwy6kH/YbHVsnR6yxO6d6IsdnT5f8PxaB+7ZyUqgrd6VA88FGJKJgdoxk4721pqKSG5dYroLJG96s23EDJ2Hpi4e9wU2rP7E6dlFw+qzATqX/eaJbaQ9eakkdMWnkj7aQ=="
    },
    "toCard": {
        "cardholderName": "IVAN IVANOV",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2024,
        "pan": "5555555555555599"
    },
    "amount": 1000,
    "currency": "978",
    "clientId": "123",
    "fromCard": {
        "bindingId": "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
    },
    "toCard": {
        "pan": "4000001111111118"
    }
}'

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

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