Когда приходит
Уведомление отправляется при каждом изменении статуса выплаты: wait → success или wait → fail.
Уведомления приходят только по выплатам, созданным через API. По выплатам из личного кабинета webhook не отправляется.
Как обработать
- Проверьте подпись из заголовка x-api-sha256-signature дополнительным ключом пользователя — как это сделать.
- Найдите выплату по payoff_id или order_id и обновите её статус.
- Для status = fail причина указана в error_message.
- Обрабатывайте уведомления идемпотентно и отвечайте кодом 200.
Заголовки
- 1.Accept: application/json
- 2.Content-Type: application/json
- 3.x-api-sha256-signature: {Signature}
Поля
- payoff_iduuid
- Идентификатор выплаты
- order_idstring
- Идентификатор в вашей системе
- statusstring
- wait, success или fail. Описание статусов
- servicestring
- Система вывода
- walletstring
- Адрес кошелька получателя
- amountstring
- Сумма выплаты без учёта комиссии
- commissionstring
- Комиссия
- error_messagestring
- Причина отклонения. Только для status = fail
Суммы передаются строками, чтобы при проверке подписи не возникало расхождений из-за форматирования чисел.