Чтобы установить 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 для автоматизированной обработки транзакций на стороне сервера.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.paysync.bot/merchanty-p2p/uvedomlenie-ob-oplate.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.