# Raiffeisenbank (Russia) Callback API

**Canonical:** https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-callback-api/  
**Provider:** Raiffeisenbank (Russia) — https://apis.io/providers/raiffeisen-ru/  
**Base URL:** https://api.raiffeisen.ru/raif-pay  
**Documentation:** https://developer.raiffeisen.ru/docs/api/019d728b-89c8-75f1-b40c-acf0a4c37d0f

Raiffeisenbank (Russia) Callback API is one of 113 APIs that [Raiffeisenbank (Russia)](https://apis.io/providers/raiffeisen-ru/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 120 JSON Schema definitions. Tagged areas include Callback. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 120 JSON Schemas.

Для информирования ТСП о проведенных платежах и возвратах могут использоваться HTTP-уведомления на адрес, указанный в его настройках. Адрес для уведомлений можно указать в [личном кабинете](https://www.rbo.raiffeisen.ru/acquiring/mcp#/) во вкладке "Прием платежей". <div align=center><a href='images/callback.png' target='_blank'><img src='images/callback.png'></a></div> Также адрес для тестовой и боевой среды можно указать с помощью [метода в API](#operation/post-settings-v1-callback). Для партнёра уведомление представляет собой входящий 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`| | **Возвраты** | | | Уведомление о возврате (v1) | `refund.amount\|publicId\|refund.id\|refund.status.value\|refund.status.date` | | **Подписки** | | | Уведомление о подписке (v2) | `data.publicId\|data.id\|data.status.value\|data.status.date` | Необходимо проверять сумму, так как у клиентов есть возможность ее изменить. **Уведомления отправляются с IP 193.28.44.23**

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| POST | `/settings/v1/callback` | Настройка url для callback |
| POST | `/api/settings/v1/callback` | Настройка url для callback |

## Machine-readable artifacts (174)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/openapi/raiffeisen-ru-callback-api-openapi.yml
- **Documentation** — https://developer.raiffeisen.ru/docs/api/019d728b-89c8-75f1-b40c-acf0a4c37d0f
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-notification-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-notification-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-notification-settings-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-notification-settings-request-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/aa8d5f34-610d-49b7-99e5-dd3258149bc8
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-file-metadata-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-file-upload-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-file-upload-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-currency-contract-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-currency-contract-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-document-status-response-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/d75569ab-740b-4c7d-a124-d0dc2f0e74aa
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-login-view-data-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-token-request-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-error-page-data-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-login-step-request-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-public-jwks-response-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-token-revocation-request-dto-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/55c08ade-ed8a-49c2-83f3-b7e39c13d760
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-report-task-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-report-task-create-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-report-task-type-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/f534bb35-a6e1-4fb5-afd5-b01fbcdddda3
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-payment-order-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-payment-order-create-request-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/efaa116d-b797-458f-bd44-5936c5a32f1e
- **Documentation** — https://developer.raiffeisen.ru/docs/api/3d89f643-c91d-4c9f-81e4-297b39c8bb68
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-foreign-trade-contract-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/adddd098-b2cc-4363-a01c-3453b48998c9
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-pdf-report-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-mt940-report-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create1-creport-request-v2-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create1-creport-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-excel-report-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-create-mt942-report-request-schema.json
- **Documentation** — https://developer.raiffeisen.ru/docs/api/f3d7b2d1-38e7-4ba3-9b65-83c7cccbd952
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-task-create-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/json-schema/raiffeisen-ru-task-response-schema.json
- …and 134 more, listed in full on the page.

## Other Raiffeisenbank (Russia) APIs (12)

- [Raiffeisenbank (Russia) Accounts Operation API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-accounts-operation-api-api/)
- [Raiffeisenbank (Russia) Agreement API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-agreement-api/)
- [Raiffeisenbank (Russia) Agreements API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-agreements-api/)
- [Raiffeisenbank (Russia) Agreement Sum API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-agreementsum-api/)
- [Raiffeisenbank (Russia) API - Client API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-api-client-api/)
- [Raiffeisenbank (Russia) API - Fund API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-api-fund-api/)
- [Raiffeisenbank (Russia) Applications API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-applications-api/)
- [Raiffeisenbank (Russia) Audits Controller API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-auditscontroller-api/)
- [Raiffeisenbank (Russia) Bills API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-bills-api/)
- [Raiffeisenbank (Russia) Brokerage Payment Orders API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-brokerage-payment-orders-api/)
- [Raiffeisenbank (Russia) Brokerage Reports API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-brokerage-reports-api/)
- [Raiffeisenbank (Russia) Buyer API](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-buyer-api/)

## Tags

Callback

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-callback-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/raiffeisen-ru/.