Webhook выплаты

Когда статус выплаты меняется, KassaGO отправляет POST-запрос с JSON на адрес из параметра hook_url или из настроек выплат в личном кабинете.

Когда приходит

Уведомление отправляется при каждом изменении статуса выплаты: wait → success или wait → fail.

Уведомления приходят только по выплатам, созданным через API. По выплатам из личного кабинета webhook не отправляется.

Как обработать

  1. Проверьте подпись из заголовка x-api-sha256-signature дополнительным ключом пользователя — как это сделать.
  2. Найдите выплату по payoff_id или order_id и обновите её статус.
  3. Для status = fail причина указана в error_message.
  4. Обрабатывайте уведомления идемпотентно и отвечайте кодом 200.

Заголовки

  1. 1.Accept: application/json
  2. 2.Content-Type: application/json
  3. 3.x-api-sha256-signature: {Signature}

Поля

payoff_iduuid
Идентификатор выплаты
order_idstring
Идентификатор в вашей системе
statusstring
wait, success или fail. Описание статусов
servicestring
Система вывода
walletstring
Адрес кошелька получателя
amountstring
Сумма выплаты без учёта комиссии
commissionstring
Комиссия
error_messagestring
Причина отклонения. Только для status = fail

Суммы передаются строками, чтобы при проверке подписи не возникало расхождений из-за форматирования чисел.