Вебхук об изменении статуса платежа
Webhook
POSTpayment_status
callback_url (из запроса создания платежа илииз настроек кабинета; URL в платеже приоритетнее) при каждом переходе
платежа в конечный статус:
paid, expired, cancelled,underpaid. Если URL не задан нигде, вебхуки не отправляются.Требования к вашему endpoint
2xx в течение 10 секунд, тело ответа игнорируется.Подпись
X-Webhook-Signature;hex(hmac_sha256(webhook_secret, raw_body)) исравните с заголовком функцией постоянного времени
(
hmac.compare_digest и аналоги). Тело для подписи берите сырымибайтами до парсинга JSON: перепаковка JSON меняет байты и ломает
подпись. Вебхук с неверной подписью отбрасывайте с ответом
400.Повторы и идемпотентность
2xx: доставка повторяется с нарастающим интервалом(1 мин, 5 мин, 30 мин, далее каждые 2 часа) до 24 часов. Один и тот
же вебхук может прийти повторно, в том числе после успешной
доставки. Храните обработанные
event_id: повторное событиеподтверждайте ответом
200 без повторной обработки. Заказ не долженактивироваться дважды.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"event_id": "9c7e6f7a-1b2c-4d3e-8f90-a1b2c3d4e5f6",
"event_type": "payment.paid",
"created_at": "2026-08-02T12:03:28Z",
"payment": {
"payment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_code": "7XK4M2QD",
"payment_url": "https://pay.banka.bot/7XK4M2QD",
"status": "paid",
"amount": 500,
"amount_total": 540,
"currency": "RUB",
"method": "sbp",
"order_id": "order_123",
"created_at": "2026-08-02T12:00:00Z",
"paid_at": "2026-08-02T12:03:27Z",
"expires_at": "2026-08-02T13:00:00Z"
}
}'Modified at 2026-09-03 09:19:54