# Raiffeisenbank (Russia) Subscription API

**Canonical:** https://apis.io/apis/raiffeisen-ru/raiffeisen-ru-subscription-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) Subscription 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 Subscription. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 120 JSON Schemas.

Для включения подписок необходима дополнительная настройка. Для этого заполните заявку в [Онлайн-банке](https://www.rbo.raiffeisen.ru/sign-form/subscription). Посмотреть клиентский путь можно с помощью нашей [Демо страницы подписок](https://pay.raif.ru/pay/configurator/#/subscription) Для реализации возможны два сценария: * отдельно подписка с последующими платежами [Схема взаимодействия](#section/Obshie-shemy-raboty/Podpiski). * подписка с оплатой [Схема взаимодействия](#section/Obshie-shemy-raboty/Podpiski-s-oplatoj). <font color = dark> Произвести подписку могут клиенты банков, поддержавших механизм подписки. Произвести оплату возможно из приложения любого банка.</font> [Список банков, поддержавших механизм подписки](https://widget.cbrpay.ru/v1). ## Виджеты <iframe src="https://pay.raif.ru/widgets/?publicId=MA0000279719&subscriptionPurpose=%D0%91%D0%BB%D0%B0%D0%B3%D0%BE%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5%20%D0%BF%D0%BE%D0%B6%D0%B5%D1%80%D1%82%D0%B2%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5&logo=https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTqiwtWhVXbOj0gImTuuRHXuDre7gr-MEdQOpsJU9pNy2TRhYDyIuqkPIzZ_0RSyDE2G-M&amp;usqp=CAU&widgetType=CHARITY&buttonColor=774098&textButtonColor=FFFFFF&offer=https://bfkh.ru/oferta_bfkh.pdf" width="100%" height="280" style="border: 0; border-radius: 16px" allowtransparency="true" scrolling="no" frameborder="0"></iframe> Для размещения виджета у себя на сайте необходимо: * cкопировать код виджета (iframe) * открыть HTML код вашей страницы для редактирования * вставить код виджета в необходимое место страницы * сохранить HTML код страницы и обновить ее на сайте ### Параметры виджета Параметр | Описание | Значение ---------|----------|--------- src<font color = dark>*</font> | URL-адрес встраиваемой страницы | Описано ниже width<font color = dark>*</font> | Ширина виджета <br> Может быть задана клиентом, но максимальный размер не должен превышать 728 пикселей | от 280 до 728 пикселей height<font color = dark>*</font> | Высота виджета <br> Фиксированное значение | 280 пикселей style<font color = dark>*</font> | Стиль для корректного отображения рамки виджета | "border: 0; border-radius: 16px" allowtransparency<font color = dark>*</font> | Прозрачный фон виджета | true scrolling<font color = dark>*</font> | Полосы прокрутки. Не используются | no frameborder<font color = dark>*</font> | Рамка с эффектом трехмерности. Не отображается | 0 ### Параметры URL-адреса встраиваемой страницы Параметр | Описание | Значение ---------|----------|--------- HOST<font color = dark>*</font> | Хост | * https://pay.raif.ru (продовый хост) <br> * https://pay-test.raif.ru (тестовый хост) publicId<font color = dark>*</font> | Идентификатор, который используется для открытия платежной формы и не является конфиденциальным | subscriptionPurpose<font color = dark>*</font> | Цель подписки (отображается на виджете) | logo | Ссылка на логотип клиента (отображается на виджете) | widgetType<font color = dark>*</font> | Тип виджета | * CHARITY (благотворительность) <br> * PAYMENT (оплата) buttonColor<font color = dark>*</font> | Цвет кнопки | Передавать в формате hex без символа # <br> Например, цвет #774098 нужно передать как buttonColor=774098 textButtonColor<font color = dark>*</font> | Цвет текста внутри кнопки | Передавать в формате hex без символа # offer | Ссылка на оферту клиента <br> Если параметр не передан, то в виджете отобразится только [ссылка на условия платежа и подключения подписки](https://www.raiffeisen.ru/static/common/SME-Documents/Widget_terms.pdf) | * Параметр не передан, отобразится текст: <br>"Оплачивая, вы соглашаетесь с [условиями](https://www.raiffeisen.ru/static/common/SME-Documents/Widget_terms.pdf)"<br><br>* Параметр передан, отобразится текст: <br>"Оплачивая, вы соглашаетесь с [условиями](https://www.raiffeisen.ru/static/common/SME-Documents/Widget_terms.pdf) и [офертой](https://bfkh.ru/oferta_bfkh.pdf)" Пример iframe для виджета на тестовой среде: <pre><code>&lt;iframe src="https://pay-test.raif.ru/widgets/?publicId=000001780049001-80049001&subscriptionPurpose=%D0%91%D0%BB%D0%B0%D0%B3%D0%BE%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5%20%D0%BF%D0%BE%D0%B6%D0%B5%D1%80%D1%82%D0%B2%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5&logo=https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTqiwtWhVXbOj0gImTuuRHXuDre7gr-MEdQOpsJU9pNy2TRhYDyIuqkPIzZ_0RSyDE2G-M&amp;usqp=CAU&widgetType=CHARITY&buttonColor=774098&textButtonColor=FFFFFF&offer=https://bfkh.ru/oferta_bfkh.pdf" width="630" height="280" style="border: 0; border-radius: 16px" allowtransparency="true" scrolling="no" frameborder="0"&gt;&lt;/iframe&gt;</code></pre> Подставьте в iframe продовый хост, также укажите данные своей компании в параметрах URL-адреса встраиваемой страницы и интегрируйте к себе на сайт.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/sbp/v1/subscriptions` | Создание QR для подписки |
| GET | `/sbp/v1/subscriptions/{subscriptionId}` | Получение информации по подписке |
| DELETE | `/sbp/v1/subscriptions/{subscriptionId}` | Отмена подписки |
| POST | `/sbp/v1/subscriptions/{subscriptionId}/orders` | Запрос на совершение платежа по подписке |
| GET | `/sbp/v1/subscriptions/{subscriptionId}/orders/{orderId}` | Проверка статуса платежа по подписке |

## Machine-readable artifacts (174)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/refs/heads/main/openapi/raiffeisen-ru-subscription-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

Subscription

---

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