Коллбэк

• Webhook уведомление отправляется только при успешном завершении депозита. Вам нужно:

  • принять уведомление;

  • проверить подпись (signature);

  • проверить сумму (amount) — она может быть изменена, если пользователь оплатил другую сумму;

  • пополнить баланс пользователя в случае успешной проверки.

• Мы считаем уведомление доставленным, если ваш сервер ответил статусом 200 с текстом OK.

  • Важно учитывать возможность повторных уведомлений и изменений суммы при спорах.

Webhook отправляет POST-запрос на URL, указанный в настройках кассы, если webhook_url не был передан. Если webhook_url был передан при создании депозита, то отправляем на URL из переданного параметра.

Response

Пример успешного ответа

{
   "deal_id": "7a2ab81c-b041-4638-be6e-437049e7a8eb",
   "state": "completed",
   "amount": "300",
   "currency": "RUB",
   "amount_usdt_income": "28.1",
   "signature": "md5 подпись",
   "order_id": "string"
}

Name	Type	Description
deal_id	string	Уникальный идентификатор сделки
state	string	Текущий статус сделки
amount	string (number)	Сумма сделки в фиатной валюте
currency	string	Фиатная валюта сделки. Используется только поддерживаемая для вашей кассы RUB
amount_usdt_income	string (number)	Сумма сделки в USDT (криптовалюта), которая поступила
signature	string	Подпись для проверки подлинности запроса (формируется с помощью секретного слова)
order_id	string	ID, который вы передавали при создании сделки

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

Для проверки подлинности уведомления необходимо сгенерировать MD5-подпись с использованием следующей строки:

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

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