Webhook платежа
Платежная система при успешной или ошибочной обработки платежа отправляет на вебхуки информацию о платеже и ошибке
Успешный вебхук
URL
Method POST
Ошибочный вебхук
URL
Method POST
Тело для успешного и ошибочного вебхука
| Параметр | Тип | Описание |
|---|---|---|
| id* | string | ID платежа в платежной системе. |
| created* | datetime | Дата создания платежа |
| updated* | datetime | Дата последнего обновления |
| error_code* | integer | Код ошибкиСм. Примечание - Коды ошибок платежа |
| error_message* | string | Текст ошибки |
| type* | string | Тип веб-хука PAYMENT - Платеж ADD_CARD - Добавление карты |
| invoice_id* | string | ID платежа в системе магазина |
| amount* | number | Сумма платежа |
| currency* | string | Валюта платежа |
| description* | string | Описание платежа |
| email* | string | Email клиента |
| phone* | string | Номер телефона клиента |
| language* | string | Язык интерфейса платежной формы |
| account_id | string | Аккаунт пользователя в системе магазина. Можно указывать любое значение.Пример: 77017576252, at@email.com, user34 |
| card_id | string | ID карты, если карта была сохранена или платеж был по сохраненной карте |
| card | object | Данные сохраненной карты |
| card_mask* | string | Маскированный номер карты |
| card_type* | string | Тип карты. МПС VISA MC - MasterCard AE - AmericanExpress |
| card_expire* | string | Срок действия картыФормат: dd/yy |
| card_issuer | string | Банк-эмитент |
| card_name* | string | Наименование карты |
| status* | string | Статус платежаСм. Примечание - Статусы платежей |
| bank_code | string | Код банка, в котором создали транзакцию |
| bank_id | string | ID транзакции банка |
| bank_invoice_id | string | Invoice ID транзакции банка |
| bank_reference | string | RRN транзакции банка |
| bank_int_reference | string | Internal RRN транзакции банка |
| sign* | string | Base64 подписи вебхука. |
json
{
"id": "642fd7ca9aa70984b8504558",
"created": "2023-04-07T08:43:54.631Z",
"updated": "2023-04-07T09:14:25.935Z",
"error_code": 0,
"error_message": "",
"type": "PAYMENT",
"invoice_id": "12321",
"amount": 100,
"currency": "KZT",
"description": "",
"email": "mail@mail.kz",
"phone": "77771234567",
"language": "ru",
"account_id": "60d94248af8328691ab438c3",
"card_id": "43sd2342dsd34fdf343fwdf34",
"card":{
"card_mask": "411111******1111",
"card_type": "VISA",
"card_expire": "12/24",
"card_issuer": "",
"card_name": "create test"
},
"status": "success",
"sign": "oEDogqZVDT0i5D7dO5PJXjD0EV3tmgL+9WFTuvuTuubhQdyF5brDQeUo5WpG/FO9dJ8wZqVXKGTkRGXRJ5ewTdWI4L3lVs+Gd8O4DDgL7Uj6QWQ21jxyL9Wy1m2eGnE5Iu6n/c/+Yv3lnihIUodNdfopDkEtumQ1AYF1GXiMZkNvDZPt67VEBiu/Hu7Zlve6wHfZ7WJIkIszKG1PojBhjG7MG6n/iehuv4NZLSRWuF7LXahMPuPfuDbVv6syRRRmvevuTVx+WkRmNEU4Z7dBcsGm6oHrAKIOSie6xyU6eHWs5ZPHdKvlHXjcospCS6U/Bjiq67uGmWHNmewB7rpNLg=="
}Подпись сгенерирована с помощью закрытого ключа и хэш-функции SHA256, используя алгоритм PKCS1v15.
Для верификации подписи используйте публичный ключ и оригинальное сообщение для генерации подписи.
Публичный ключ доступен по следующему адресу:
https://ps.airbapay.kz/acquiring/sign/public.pem
Сообщение собирается следующим образом:
id+invoice_id+amount+currency+status+description