Для приема СБП-платежей оставьте заявку на сайте.

Райффайзенбанк выполнит регистрацию. После завершения процесса вы будете оповещены по электронной почте.

Покупатель

• выбирает в ПО партнёра услуги/товары и пункт «Оплата через СБП» (опционально)
• сканирует QR-код, предоставленный партнёром, и подтверждает платеж в приложении своего банка
• получает результат платежа и оплаченные услуги/товары

Партнёр

• запрашивает формирование QR-кода для выбранных товаров/услуг (корзины)
• отображает QR-код клиенту для сканирования и проведения оплаты
• обрабатывает уведомления о результатах СБП-операций
• запрашивает данные по платежу (опционально)
• обеспечивает выдачу товаров/услуг покупателю по факту платежа

Райффайзенбанк

• предоставляет интерфейс для запроса QR-кода со стороны партнёра
• обеспечивает перевод денежных средств на счет партнёра по факту расчетов в СБП
• определяет формат уведомления о факте СБП-платежа
• предоставляет интерфейс для получения данных по платежу

По закону от 22.05.2003 № 54–ФЗ "О применении контрольно-кассовой техники при осуществлении расчетов в Российской Федерации" при оплате товаров, работ или услуг необходимо формировать фискальный чек и отправлять его в налоговую с помощью кассы.

Райффайзенбанк предоставляет возможность фискализировать чеки через API банка.

B случае если прием платежей планируется на сайте или в мобильном приложении, рекомендуем использовать протокол с отображением QR-кода на нашей форме.

Если прием платежей реализуется в физических точках или по каким-либо причинам вам не подходит решение с нашей формой, можете использовать протокол, описанный ниже.

На рисунке изображена схема информационного обмена c партнёром при реализации платежа по QR-коду.

Вы можете предложить клиенту привязать оплату по СБП к программе лояльности или к аккаунту в вашем сервисе. Для этого вы можете сгенерировать QR-код и отобразить его клиенту либо перенаправить его на специальную ссылку, которая есть в ответе на запрос генерации QR-кода на подписку.

После по уникальному идентификатору подписки вы можете обращаться за безакцептным списанием средств с клиента за ваши товары и услуги.

Также есть схема, когда одним запросом создается QR-код на получение оплаты и заведение подписки.

В данном случае клиент проводит оплату, после чего ему отображается окно с предложением подключения подписки.

Клиент может провести оплату, но отказаться от подписки. Также клиент может провести оплату из приложения банка, который не подключен к сервису подписок.

На схеме ниже представлен сценарий работы с Кассовой ссылкой СБП. Здесь и далее для ее обозначения используется тип QRVariable. Это тип QR-кода, который означает Кассовую ссылку СБП и на уровне API и хранения данных отличает ее от статического и динамического QR-кодов.

Для более быстрой интеграции вы можете воспользоваться нашими SDK:

• Java

Также список готовых решений вы можете посмотреть по ссылке.

Bзаимодействие осуществляется по протоколу HTTP с использованием методов GET/POST/DELETE (в описании каждого запроса явно указан требуемый метод и адрес).

POST-запрос использует JSON-аргументы, GET и DELETE-запросы работают со строками запросов.

API всегда возвращает ответ в формате JSON, независимо от типа запроса.

Ответ любого метода содержит код сообщения (code). Если в процессе обработки любого запроса произойдет логическая ошибка, API вернет дополнительно описание ошибки (message).

Запросы, связанные с получением данных по платежу и управлением платежами, авторизуются посредством секретного ключа API (secretKey). Параметр авторизации указывается в заголовке Authorization, значение которого формируется как "Bearer secretKey".

Для получения тестовых данных для интеграции необходимо заполнить анкету на pay.raif.ru.

Посмотреть боевой sbpMerchantId и сгенерировать ключи можно в личном кабинете во вкладке "Прием платежей".

Секретный ключ необходимо хранить в доверенной среде, так как по нему возможно проведение возвратов.

При работе в мобильной версии сайта или приложении мы рекомендуем использовать нашу форму.

Если планируете использовать свою форму, то необходимо реализоовать виджет выбора банка, для этого нужно для каждого банка получить его схему:

• схемы банков для платежный QR
• схемы банков для подписочных QR

И подставить ее в url из параметра payload, вместо https.

Для работы с СБП через NFC необходимо реализовать взаимодействие через "Кассовую платежную ссылку".

Необходимо на каждую кассу сгенерировать QR c типом QRVariable. Из ответа на запрос генерации QR, нужно получить ссылку из параметра payload, в ссылке в начало домена необходимо добавить "web." и полученную ссылку нужно зашить в NFC метку.

Пример:

В payload вы плучили https://qr.nspk.ru/AS100004BAL7227F9BNP6KNE007J9B3K?type=01&bank=100000000007 ,

в NFC метку нужно будет зашить https://web.qr.nspk.ru/AS100004BAL7227F9BNP6KNE007J9B3K?type=01&bank=100000000007

Для полного цикла тестирования оплаты Райффайзенбанк предоставляет возможность использования демо-приложения для сканирования QR-кода от имени покупателя по адресу: https://pay.raif.ru/pay/rfuture/

Указанный адрес можно открыть в браузере любого устройства, где есть камера. Никакого дополнительного софта/плагинов устанавливать не нужно. Далее нажать на значок СБП (при необходимости разрешить браузеру доступ к камере) и поднести к ней изображение QR-кода. Если камера не открылась, проверьте, что в адресе указан протокол HTTPS.

Для реализации взаимодействия с партнёром Райффайзенбанк предоставляет API из следующих запросов:

• регистрация QR-кода,
• отмена QR-кода,
• получение данных по зарегистрированному ранее QR-коду,
• получение данных по платежу,
• возврат денежных средств - может быть выполнен в любое время после проведения оплаты на полную сумму платежа или частичную. Однако сумма частичных запросов на возврат не должна превышать общую сумму заказа.
• получение информации по возврату.

Схема взаимодействия.