Система Быстрых Платежей (SBP)

Процесс проведения оплаты

Процесс проведения платежа этим методом содержит следующие этапы:

Вы инициируете запрос на оплату.
Система направляет запрос провайдеру платежного метода. СБП генерирует QR-код для проведения оплаты.
Вы получаете ответ и перенаправляете клиента на полученный URL.
Клиент получает QR-код и проводит оплату.
Вам приходит автоматическое уведомление о статусе платежа, если в запросе на проведение оплаты был передан параметр notification_url.

Для данного альтернативного способа оплаты поддерживаются следующие операции:

Оплата

Запрос

Отправьте запрос оплаты со следующими дополнительными данными:

Параметр	Тип данных	Описание
method	object	Секция параметров способа оплаты.
type * обязательный	string	`sbp`

Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию form со ссылкой для перехода к странице с QR-кодом. Направьте клиента на URL, переданный как значение параметра form.action.

Запрос статуса операции

Запрос

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

Ответ

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

Возврат средств клиенту

Запрос

Если необходимо вернуть платеж клиенту, отправьте запрос возврата средств c UID транзакции оплаты.

Ответ

Ответ будет содержать статус транзакции, а также иную информацию о транзакции согласно описанию запроса возврата средств.

Вариант интеграции MT

Info

Данная интеграция поддерживает только валюту RUB.

Оплата

Процесс проведения оплаты

Покупатель инициирует платеж на сайте торговца.
Торговец отправляет запрос оплаты в bePaid.
bePaid присылает в ответе URL на страницу СБП с QR-кодом для оплаты.
Торговец перенаправляет покупателя на полученный URL. Время жизни ссылки по умолчанию – 15 минут.
Покупатель сканирует QR-код, выбирает банк из списка доступных, перенаправляется в приложение выбранного банка и подтверждает оплату. Также покупатель может отсканировать код из банковского приложения. При открытии ссылки на мобильном устройстве, покупателю сразу отображается список банковских приложений для завершения оплаты.
Торговец получает автоматическое уведомление о результате транзакции.
Торговец уведомляет покупателя о результате оплаты.

Запрос

Отправьте запрос оплаты со следующими дополнительными параметрами:

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения транзакции.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`sbp`

Пример запроса

{
    "request": {
        "amount": 100000,
        "currency": "RUB",
        "description": "description",
        "return_url": "https://merchant.ltd/return",
        "method": {
            "type": "sbp"
        }
    }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа

{
    "transaction": {
        "uid": "ff907a25-c194-44bb-b3ec-9a943f89f863",
        "type": "payment",
        "status": "pending",
        "amount": 100000,
        "currency": "RUB",
        "description": "description",
        "created_at": "2024-09-23T13:21:05Z",
        "updated_at": "2024-09-23T13:21:06Z",
        "method_type": "sbp",
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/ff907a25-c194-44bb-b3ec-9a943f89f863/fc6fcec74ae131c4afad01db10a2abd209b91b0b4e54c8af65a38485bbcdd245",
        "payment": {
            "status": "pending",
            "gateway_id": 4497,
            "ref_id": "3960848",
            "message": "Transaction was initialized."
        },
        "sbp": {
            "type": "sbp"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "test": false,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },      
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://qr.nspk.ru/AD100066PTMO2TOG8S1B64I8GGMR32GR",
            "method": "GET",
            "fields": []
        }
    }
}

Возврат средств

Запрос

Для возврата средств по платежу, отправьте запрос на возврат средств. Возврат можно осуществить однократно на полную или частичную сумму родительской транзакции.