Callback Notifications API (1.0)
Download OpenAPI specification:Download
Для информирования ТСП о проведенных платежах, возвратах и изменениях статусов подписок используются HTTP-уведомления на адрес, указанный в настройках мерчанта.
Для партнёра уведомление представляет собой входящий POST-запрос с JSON-структурой.
Уведомление считается принятым, если получатель ответил на запрос кодом HTTP 200.
Ответы с любыми другими HTTP-кодами будут считаться невалидными. Повторные попытки отправки проводятся в течение суток с нарастающим интервалом.
Для проверки подлинности уведомлений к данным добавляется подпись в заголовке X-Api-Signature-SHA256, полученная на основе общего секретного ключа и контрольной строки с помощью HMAC-SHA-256.
| Тип операции | Тип уведомления | Шаблон проверки | Актуальность |
|---|---|---|---|
| Оплата | |||
| Уведомление об оплате (v3) | data.amount|data.publicId|data.order.id|data.status.value|data.status.date |
✅ | |
| Уведомление об оплате (v2) | amount|publicId|order|transaction.status.value|transaction.status.date |
⚠️ | |
| Уведомление об оплате (v1) | amount|sbpMerchantId|order|paymentStatus|transactionDate |
⚠️ | |
| Возвраты | |||
| Уведомление о возврате (v1) | amount|publicId|refund.id|status.value|status.date |
✅ | |
| Подписки | |||
| Уведомление о подписке (v2) | data.publicId|data.id|data.status.value|data.status.date |
✅ | |
| Уведомление о подписке (v1) | data.publicId|data.id|data.status.value|data.status.date |
⚠️ |
Уведомления отправляются с IP 193.28.44.23
Настройка url для callback
Уведомления будут подписываться ключом, переданным в заголовке авторизации. Подробнее о форматах уведомлений читайте в документации.
Authorizations:
Request Body schema: application/jsonrequired
| callbackUrl required | string URL-адрес для приема уведомлений |
object Настройки типов операций |
Responses
Request samples
- Payload
{- "operationTypes": {
- "payment": {
- "version": "V3",
- "enabled": true
}, - "refund": {
- "version": "V1",
- "enabled": true
}, - "subscription": {
- "version": "V2",
- "enabled": false
}
}
}Response samples
- 200
- 400
{- "operationTypes": {
- "payment": {
- "version": "V3",
- "enabled": true
}, - "refund": {
- "version": "V1",
- "enabled": true
}, - "subscription": {
- "version": "V2",
- "enabled": false
}
}
}Уведомление об оплате (v3) Webhook
Уведомление о платеже для эквайринга и СБП.
header Parameters
| X-Api-Signature-SHA256 required | string Заполняется подписью, полученной алгоритмом HMAC-SHA-256 с использованием выбранного секретного ключа и контрольной строки |
Request Body schema: application/json
| event required | string Value: "PAYMENT" Тип сообщения |
required | any Данные по операции |
Request samples
- Payload
{- "event": "PAYMENT",
- "data": {
- "id": "payment-12345",
- "publicId": "MA0000000552",
- "amount": 1500.5,
- "order": {
- "id": "order-12345"
}, - "status": {
- "value": "SUCCESS",
- "date": "2024-08-06T14:50:59+03:00"
}, - "paymentMethod": "SBP",
- "parameters": {
- "sbpTransactionId": "B7CF9F02B5224F34913FB5BB311CED39"
}
}
}Уведомление об оплате (v2) Deprecated Webhook
header Parameters
| X-Api-Signature-SHA256 required | string Заполняется подписью, полученной алгоритмом HMAC-SHA-256 с использованием выбранного секретного ключа и контрольной строки |
Request Body schema: application/json
| event required | string Value: "payment" Тип сообщения |
required | any (PaymentTransactionV2) Данные по операции |
Request samples
- Payload
{- "event": "payment",
- "transaction": {
- "id": 120059,
- "orderId": "testOrder",
- "status": {
- "value": "SUCCESS",
- "date": "2019-07-11T17:45:13+03:00"
}, - "paymentMethod": "sbp",
- "paymentParams": {
- "qrId": "AD100051KNSNR64I98CRUJUASC9M72QT"
}, - "amount": 12500.5,
- "comment": "Покупка шоколадного торта",
- "extra": {
- "extraParam": "Example extra param"
}
}
}Уведомление об оплате (v1) Deprecated Webhook
header Parameters
| X-Api-Signature-SHA256 required | string Заполняется подписью, полученной алгоритмом HMAC-SHA-256 с использованием выбранного секретного ключа и контрольной строки |
Request Body schema: application/json
| transactionId | number Идентификатор операции платежа в Райффайзенбанке |
| qrId | string <= 32 characters Уникальный идентификатор QR-кода, выданный СБП |
| sbpMerchantId | string <= 12 characters Идентификатор зарегистрированного ТСП в СБП |
| merchantId | string Идентификатор ТСП в Райффайзенбанке |
| amount | number Сумма в рублях |
| currency | string <= 3 characters Валюта платежа |
| transactionDate | string <date-time> Дата и время проведения платежа |
| paymentStatus | string Статус проведения платежа |
| additionalInfo | string <= 140 characters Дополнительная информация |
| order | string <= 40 characters ^[A-Za-z0-9-_.]+$ Уникальный идентификатор заказа |
| createDate | string <date-time> Время формирования заявки |
object Дополнительные поля, переданные в запросе ранее |
Request samples
- Payload
{- "transactionId": 41,
- "qrId": "AS100032PQ7739G58NCQ457RA2OG82JP",
- "sbpMerchantId": "MA0000000279",
- "merchantId": "1780672001",
- "amount": 10,
- "currency": "RUB",
- "transactionDate": "2020-01-15T16:01:49.043924+03:00",
- "paymentStatus": "SUCCESS",
- "additionalInfo": "Дополнительная информация",
- "order": "testOrder",
- "createDate": "2020-01-15T13:00:40+03:00",
- "extra": {
- "extraParam": "Example extra param"
}
}Уведомление о возврате (v1) Webhook
Уведомление о возврате для эквайринга и СБП.
header Parameters
| X-Api-Signature-SHA256 required | string Заполняется подписью, полученной алгоритмом HMAC-SHA-256 с использованием выбранного секретного ключа и контрольной строки |
Request Body schema: application/json
object |
Request samples
- Payload
{- "refund": {
- "id": "refund-12345",
- "sbp": {
- "sbpTransactionId": "B7CF9F02B5224F34913FB5BB311CED39"
}, - "amount": 1500.5,
- "status": {
- "value": "COMPLETED",
- "date": "2024-08-06T14:50:59+03:00"
}, - "paymentParams": {
- "transactionId": 1345,
- "orderId": "order-12345",
- "qrId": "AD100051KNSNR64I98CRUJUASC9M72QT"
}
}
}Уведомление о подписке (v2) Webhook
Уведомление об изменении подписки.
header Parameters
| X-Api-Signature-SHA256 required | string Заполняется подписью, полученной алгоритмом HMAC-SHA-256 с использованием выбранного секретного ключа и контрольной строки |
Request Body schema: application/json
| event required | string Value: "SUBSCRIPTION" Тип сообщения |
required | any Данные о подписке |
Request samples
- Payload
{- "event": "SUBSCRIPTION",
- "data": {
- "publicId": "000001780049001-80049001",
- "id": "subscription-test",
- "status": {
- "value": "SUBSCRIBED",
- "date": "2025-11-29T19:43:54+03:00"
}, - "purpose": "Подписка на интернет магазин",
- "paymentMethod": "ACQUIRING",
- "paymentSystem": "MIR",
- "cardNumber": "22013233****4439",
- "expirationDate": "2035-10"
}
}Уведомление о подписке (v1) Deprecated Webhook
header Parameters
| X-Api-Signature-SHA256 required | string Заполняется подписью, полученной алгоритмом HMAC-SHA-256 с использованием выбранного секретного ключа и контрольной строки |
Request Body schema: application/json
| event | string Value: "SUBSCRIPTION" Тип сообщения |
object |
Request samples
- Payload
{- "event": "SUBSCRIPTION",
- "data": {
- "id": "c5b3fd06",
- "publicId": "MA0000000552",
- "bank": {
- "name": "Райффайзенбанк",
- "memberId": "100000000007"
}, - "status": {
- "value": "SUBSCRIBED",
- "date": "2024-08-06T14:50:59+03:00"
}, - "qr": {
- "id": "AD399130040A4FFAB09111CB6304BF8D"
}
}
}