A2A Callback - нотифікація від банку: відмінності між версіями

Поточна версія на 13:37, 26 лютого 2026

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

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

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

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`	неуспішне прийняття колбеку з помилкою

@@ Рядок 10: / Рядок 10: @@
 </p>
 <br>
-'''Request'''<syntaxhighlight lang="http" line="1">
+==== '''Request''' ====
+<syntaxhighlight lang="http" line="1">
 headers
 'PartnerKey: partnerName'
@@ Рядок 31: / Рядок 33: @@
 }
 <br>
-</syntaxhighlight>'''Response''' <syntaxhighlight lang="http" line="1">
+</syntaxhighlight>
+==== '''Response''' ====
+<syntaxhighlight lang="http" line="1">
 headers
 ----
@@ Рядок 79: / Рядок 84: @@
 |-
 |}
+<br>
 ''EasyPay приймає callback. Валідує заголовки, перевіряє підпис повідомлення.  Ідентифікує замовлення за orderId. Створюється платіжна операція для даного замовлення.''
+<br>
 {| style="border-collapse: collapse; width: 100%; font-family: Roboto, sans-serif; font-weight: 100; font-size: 0.8em; color: #333;"
 ! style="border: none; border-bottom: 1px solid #d3d3d3; text-align: center; padding: 8px;" |Параметр