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

Матеріал з partnerdocs
Немає опису редагування
Немає опису редагування
Рядок 77: Рядок 77:
| 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;" |номер замовлення, який створюється в системі платіжного агрегатора, передається в банк
|-
|-
| 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;" |'''<code>status</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;" |статус платежу (0 - успіх, -1 - неуспіх)
|-
|-
|}
''EasyPay приймає callback. Валідує заголовки, перевіряє підпис повідомлення.  Ідентифікує замовлення за orderId. Створюється платіжна операція для даного замовлення.''
{| 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>isSuccess</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>error</code>'''
| style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;" |неуспішне прийняття колбеку з помилкою
|}
|}

Версія за 20:11, 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 отримувача
orderId номер замовлення, який створюється в системі платіжного агрегатора, передається в банк
status статус платежу (0 - успіх, -1 - неуспіх)

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

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