Получение и обработка

Как обрабатывать полученное уведомление?

Перед переходу к этому шагу, прочитайте страницы о настройке и принципах работы. Иначе велика вероятность ошибочной настройки.

В данный момент имеется возможность получать коллбеки ТОЛЬКО об некоторых действиях с ЗАЯВКАМИ и ВЫПЛАТАМИ. В будущем, будет реализована техничексая возможность получения уведомлений о различных действиях в системе.

Когда происходят какие либо действия с нашей стороны (в том числе вызванное вашей стороной, например закрытие заявки), происходит отправка уведомления на вашу сторону, перечисление вариантов событий описано ниже. Для заявок и выплат, при их создании вы должны передать поле webhook_url

Когда заявка завершится, вы получите информацию о ней на адрес, указанный вами в поле webhook_url. Веб-хук будет отправлен методом POST.

Проверка коллбеков осуществляется путем хэширования тела веб-хука с помощью ключа secret (указываемого в личном кабинете) и HMAC-SHA256, заранее исключив из тела параметр sign. Указанный secret не отображается в личном кабинете после его сохранения в целях безопасности.

Пример коллбека о статусе заявки

{
    "id": 123,
    "request_proprietary_id": "456789ab-89ab-cdf-0123-466789abcdf0",
    "merchant_request_id": "SDFG-TRR3U-HNGF-ST-UIKN",
    "initial_amount": "1000.0000",
    "amount_to_pay": "1001.0000",
    "crypto_amount": "10.9926",
    "crypto_rate": "90.9704",
    "status": "SUCCESS",
    "created": "2024-05-30 00:37:53.672461+03:00",
    "closed": "2024-05-30 00:37:53.672461+03:00",
    "sign": "c718262a791a087814bdf7e1d42e93ac00dbcfa46b8fbc86d66d5f3768a32e91"
}

Параметр	Тип	Описание
id	integer	порядковый номер заявки (сервиса)
request_proprietary_id	string	внутренний UUID4 заявки (сервиса)
merchant_request_id	string	ваш ID заявки (до 50 символов)
initial_amount	float	изначальная сумма заявки/выплаты
amount_to_pay	float	итоговая сумма заявки/выплаты
crypto_amount	float	итоговая сумма заявки/выплаты в USDT
crypto_rate	float	курс USDT на момент создания заявки/выплаты
status	string	текущий статус заявки (может быть "FAILED", "PROCESSING", "SUCCESS")
created	string	ISO timestamp без "T" создания заявки с часовым поясом
closed	string	ISO timestamp без "T" закрытия (подтверждения, либо отмены) заявки (может быть null)
sign	string	подпись

Пример коллбека о статусе выплаты

{
    "id": 123,
    "request_proprietary_id": "456789ab-89ab-cdf-0123-466789abcdf0",
    "merchant_request_id": "SDFG-TRR3U-HNGF-ST-UIKN",
    "amount_to_pay": "1001.00",
    "crypto_amount": "10.9926349346",
    "crypto_rate": "90.97",
    "status": "processing",
    "created": "2024-05-30 00:37:53.672461+03:00",
    "closed": "2024-05-30 00:37:53.672461+03:00",
    "sign": "c718262a791a087814bdf7e1d42e93ac00dbcfa46b8fbc86d66d5f3768a32e91"
}

Параметр	Тип	Описание
id	integer	порядковый номер заявки (сервиса)
request_proprietary_id	string	внутренний UUID4 заявки (сервиса)
merchant_request_id	string	ваш ID заявки (строка до 50 символов)
amount_to_pay	string	итоговая сумма заявки/выплаты
crypto_amount	string	итоговая сумма заявки/выплаты в USDT
crypto_rate	string	курс USDT на момент создания заявки/выплаты
status	string	текущий статус заявки (может быть "FAILED", "PROCESSING", "SUCCESS")
created	string	ISO timestamp без "T" создания заявки с часовым поясом
closed	string	ISO timestamp без "T" закрытия (подтверждения, либо отмены) заявки (может быть null)
sign	string	подпись