Чтобы установить callback url переходим в разделе настройки в боте @PaySyncBot и выбираем пункт Настройки API
Callback URL используется для получения уведомлений о подтверждении заявок в реальном времени. Это URL, на который API будет отправлять HTTP POST запросы при подтверждении заявок.
**Формат Callback**
Когда заявка подтверждается, на установленный Callback URL будет отправлен **HTTP POST запрос с JSON телом**, содержащим информацию о транзакции.
```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)**.
```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": "ваши данные",
"sign": "d1de74fe96b8d01784df0da20927cce8e63d89b36fa84f54b4e9974d4dfccb06"
}
```
Обработка
При получении Callback, ваш сервер должен обработать информацию о транзакции и отправить ответ со статусом `200 OK`, чтобы подтвердить, что уведомление было успешно получено.
Уведомление в боте
Независимо от того, установлен ли **Callback URL**, пользователи всегда будут получать уведомления о транзакциях напрямую в боте-кошельке. Это обеспечивает дополнительный уровень уверенности, что пользователь не пропустит уведомление о транзакции, даже если какие-то проблемы возникнут с **Callback URL** или сервером пользователя.
Интеграция с callback url
Если **Callback UR**L также установлен, уведомления в боте будут дополняться уведомлениями, отправленными на Callback URL. Это позволяет пользователям использовать уведомления в боте для быстрой проверки транзакций и Callback URL для автоматизированной обработки транзакций на стороне сервера.
