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

← Попереднє редагування Наступне редагування →

Версія за 19:06, 25 лютого 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
}

Response

headers
----
body
{
  "isSuccess": "true",
  "error": null
}

Параметр	Характеристика
`orderId`	номер замовлення, який створюється в системі платіжного агрегатора, передається в банк
`paymentId`	номер платіжного документа в банку
`paymentDescription`	призначення платежу в банку
`amount`	сума переказу
`paymentDate`	дата переказу
`payerIban`	IBAN платника
`payerId`	ІПН плаитника
`payerFullName`	ПІБ платника
`recipientIban`	IBAN отримувача

@@ Рядок 10: / Рядок 10: @@
 </p>
 <br>
-Request
+'''Request'''<syntaxhighlight lang="http" line="1">
+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
+}
+</syntaxhighlight>'''Response''' <syntaxhighlight lang="http" line="1">
+headers
+----
+body
+{
+  "isSuccess": "true",
+  "error": null
+}
+</syntaxhighlight>
+{| 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;" |Параметр
+! style="border: none; border-bottom: 1px solid #d3d3d3; text-align: center; padding: 8px;" |Характеристика
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>orderId</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |номер замовлення, який створюється в системі платіжного агрегатора, передається в банк
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>paymentId</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |номер платіжного документа в банку
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>paymentDescription</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |призначення платежу в банку
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>amount</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |сума переказу
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>paymentDate</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |дата переказу
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>payerIban</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |IBAN платника
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>payerId</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |ІПН плаитника
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>payerFullName</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |ПІБ платника
+|-
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |'''<code>recipientIban</code>'''
+| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |IBAN отримувача
+|}