A2A Callback - нотифікація від банку

Матеріал з partnerdocs

Загальна логіка


Банк надсилає повідомлення про факт надходження коштів на рахунок компанії, відкритий у банку.

Параметри запиту



POST /api/a2a/callback


Request

headers
'PartnerKey: partnerName' 
'locale: ua'
'AppId: a5806a5f-dbb8-496a-a23f-aab6d2fcbce1'
'PageId: 2ce7dba6-4600-456e-b9c8-f13cacf1c85d'

body
{
  "orderId": "3211123577871",
  "paymentId": "ORD-20251104-7890",
  "paymentDescription": "Оплата замовлення ORD-20251104-7890 за товари/послуги",
  "amount": 5800,
  "paymentDate": "2024-05-24T16:14:45+03:00",
  "payerIban": "UA113305749000000026009479663",
  "payerId": 1234567890,
  "payerFullName": "Тестеренко Тест Тестович",
  "recipientIban": "UA123456789012345678901234567",
  "status": 0
}
<br>

Response

headers
----
body
{
  "isSuccess": "true",
  "error": null
}
Параметр Характеристика
orderId номер замовлення, який створюється в системі платіжного агрегатора, передається в банк
paymentId номер платіжного документа в банку
paymentDescription призначення платежу в банку
amount сума переказу
paymentDate дата переказу
payerIban IBAN платника
payerId ІПН плаитника
payerFullName ПІБ платника
recipientIban IBAN отримувача
orderId номер замовлення, який створюється в системі платіжного агрегатора, передається в банк
status статус платежу (0 - успіх, -1 - неуспіх)


EasyPay приймає callback. Валідує заголовки, перевіряє підпис повідомлення. Ідентифікує замовлення за orderId. Створюється платіжна операція для даного замовлення.

Параметр Характеристика
isSuccess статус успішного/неуспішного прийняття колбеку зі сторони платіжного агрегатора
error неуспішне прийняття колбеку з помилкою