Уведомление об оплате

Чтобы установить callback url переходим в разделе настройки в боте @PaySyncBot и выбираем пункт Настройки API

Callback URL используется для получения уведомлений о подтверждении заявок в реальном времени. Это URL, на который API будет отправлять HTTP POST запросы при подтверждении заявок.

Формат Callback

Когда заявка подтверждается, на установленный Callback URL будет отправлен HTTP POST запрос с JSON телом, содержащим информацию о транзакции.

{
"trade": "678099",
"card_number": "2200 3804 5257 1862",
"amount": "7539",
"usdt_amount": "69.54",
"currency": "RUB",
"conversion_rate": "95.95",
"status": "paid",
"time": "2024-09-21 10:03:18",
"time_paid": "2024-09-21 10:06:09",
"token": "f571d339-dd80-4d88-a6ee-43a3986e301e",
"user_id": "********",
"data": "ваши данные",
}
          

Дополнительная защита подписи

Когда мы отправляем обратный вызов (callback), обычно он не содержит аутентификационной подписи. Однако, для дополнительного уровня проверки, вы можете включить проверку подписи вебхука. Для этого необходимо включить параметры apikey и client_id в хеш sha256.

apikey можно получить из раздела настроек API вашего бота.

client_id представляет собой ваш уникальный идентификатор клиента, который также можно найти в нашем боте.

При получении вебхука от нас, осуществите проверку по параметру sign, используя хеш sha256(apikey + client_id).

{
"trade": "678099",
"card_number": "2200 3804 5257 1862",
"amount": "7539",
"usdt_amount": "69.54",
"currency": "RUB",
"conversion_rate": "95.95",
"status": "paid",
"time": "2024-09-21 10:03:18",
"time_paid": "2024-09-21 10:06:09",
"token": "f571d339-dd80-4d88-a6ee-43a3986e301e",
"user_id": "********",
"data": "ваши данные",
"sign": "d1de74fe96b8d01784df0da20927cce8e63d89b36fa84f54b4e9974d4dfccb06"
}
 

Обработка

При получении Callback, ваш сервер должен обработать информацию о транзакции и отправить ответ со статусом 200 OK, чтобы подтвердить, что уведомление было успешно получено.

Уведомление в боте

Независимо от того, установлен ли Callback URL, пользователи всегда будут получать уведомления о транзакциях напрямую в боте-кошельке. Это обеспечивает дополнительный уровень уверенности, что пользователь не пропустит уведомление о транзакции, даже если какие-то проблемы возникнут с Callback URL или сервером пользователя.

Интеграция с callback url

Если Callback URL также установлен, уведомления в боте будут дополняться уведомлениями, отправленными на Callback URL. Это позволяет пользователям использовать уведомления в боте для быстрой проверки транзакций и Callback URL для автоматизированной обработки транзакций на стороне сервера.