Коллбэк

Вебхук-уведомления передаются на указанный webhook_url, который вы отправляете при создании заявки. Они сообщают о статусе платежа (успешного или неуспешного) по заявке. Вебхук-уведомление считается доставленным, если ваш сервер вернул статус 200 и ответ OK в текстовом формате.

Повторные вебхук-уведомления возможны, поэтому рекомендуется проверять, было ли уже обработано предыдущее уведомление, чтобы избежать дублирования.

В этой документации описано, как настроить ваш сервер для приема и обработки вебхук-уведомлений о результатах выполнения заявок на выплату. Уведомление содержит информацию о статусе платежа, сумме и уникальном идентификаторе сделки. Для обеспечения безопасности используется подпись, которую необходимо проверить.

Request

После завершения обработки платежа ваше приложение получит POST-запрос на URL, который был передан в параметре webhook_url при создании заявки.

Пример вебхук-уведомления

{
   "payout_deal_id": "f0b1b3b4-0b1b-4b3b-8b1b-3b4b5b6b7b8b",
   "state": "completed",
   "amount": "1000",
   "currency": "RUB",
   "amount_usdt": "10",
   "order_id": "0001",
   "signature": "md5",
   "status_code": 700
}

Body

Name	Type	Описание
payout_deal_id	string	Уникальный идентификатор сделки
state	string	Текущий статус сделки (completed, processing, и т.д.)
amount	string (number)	Сумма платежа в фиатной валюте
currency	string	Валюта платежа RUB
amount_usdt	string	Сумма в USDT
order_id	string	Ваш внутренний номер заявки
signature	string	Подпись для проверки подлинности уведомления (формируется с использованием секретного слова)
status_code	string (number)	Код результата сделки (например, 700 для успешной сделки)

Проверка подписи

Для проверки подписи необходимо сгенерировать хеш MD5 в формате:

md5(payout_deal_id:amount:секретное_слово_2)

Затем сравнить этот хеш с полученной подписью в поле signature вебхук-уведомления. Если подписи совпадают, это означает, что уведомление пришло от нашего сервера.

Статусы заявок

Name	Description
created	Новая заявка
completed	Выполненная сделка (финальный статус)
processing	Сделка находится в процессе
waiting_result	Ожидание финального статуса
rejected_balance	Недостаточно баланса на кассе для выполнения выплаты (финальный статус)
rejected_by_system	Отклонено внутри системы или по причине недоступности метода (финальный статус)
rejected_timeout	Отклонено из-за истечения времени или отказа платежного провайдера (финальный статус)

Статус-коды ответа

Name	Description
700	Сделка завершена успешно
721	Недостаточно средств на кассе мерчанта
722	Сделка не выполнена в требуемые сроки
723	Не удалось выполнить запрос
725	Отмена со стороны платежной системы по причине невозможности перевода