Перейти к содержанию

SberPay

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

Оплата

Info

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

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

  1. Покупатель инициирует оплату SberPay на сайте торговца.
  2. Торговец отправляет запрос на оплату в bePaid.

  3. bePaid возвращает в ответе следующие параметры:

    • deep link, который ведёт на страницу оплаты в приложении SberPay покупателя (sberpay_qr_deeplink.deep_link или form.action);
    • QR-код – при сканировании осуществляется переход в приложение SberPay (sberpay_qr_deeplink.qr_code).

    Время жизни ссылок составляет 20 минут.

  4. Торговец перенаправляет покупателя на ссылку для оплаты.

    • Если покупатель использует мобильное устройство, торговец перенаправляет покупателя в приложение SberPay с помощью deep link, полученного на предыдущем шаге;
    • Если покупатель использует desktop-устройство, торговец отображает покупателю QR-код для сканирования в приложении SberPay и кнопку для завершения оплаты с помощью push-уведомления на номер телефона;
      • Если покупатель выбирает опцию оплаты с помощью push-уведомления, торговец отображает покупателю интерфейс для ввода номера телефона;
      • Покупатель вводит номер телефона;
      • Торговец отправляет bePaid запрос на подтверждение транзакции с указанием номера телефона покупателя;
      • Покупатель получает push-уведомление от приложения SberPay.

  5. Покупатель завершает транзакцию в приложении SberPay.

  6. bePaid отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у bePaid с помощью запроса получения статуса транзакции.
Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL для возврата покупателя после завершения оплаты.
expired_at
 string
Время в формате ISO-8601, до которого действительны ссылки для оплаты. По умолчанию – 20 минут. Формат: YYYY-MM-DDThh:mm:ssTZD, где YYYY – год (например, 2028), MM – месяц (например, 02), DD – день (например, 09), hh – часы (например, 18), mm – минуты (например, 20), ss – секунды (например, 45), TZD – часовой пояс (+hh:mm или –hh:mm), например, +02:00.
object
Секция параметров способа оплаты.
type
обязательный
 string
sberpay_qr_deeplink
object
Секция информации о покупателе.
email
 string
Адрес электронной почты покупателя.
phone
 string
Номер телефона покупателя.
Пример запроса 
{
    "request": {
        "amount": 200,
        "currency": "RUB",
        "description": "description",
        "return_url": "https://your_return_url.com",
        "method": {
            "type": "sberpay_qr_deeplink"
        },
        "customer": {                  
            "email": "john@example.com"
        }
    }
}
Ответ

Ответ будет содержать дополнительные параметры:

  • sberpay_qr_deeplink.qr_code для отображения покупателю QR-кода на desktop-устройстве;
  • sberpay_qr_deeplink.deep_link и form.action – оба параметра содержат ссылку для перенаправления покупателя в приложение SberPay на мобильном устройстве.
Пример ответа 
{
    "transaction": {
        "uid": "0d4e6d9e-96c1-4b95-a9c7-7a33c9d8eabe",
        "type": "payment",
        "status": "pending",
        "amount": 3000,
        "currency": "RUB",
        "description": "description",
        "created_at": "2026-01-26T08:35:40Z",
        "updated_at": "2026-01-26T08:35:40Z",
        "method_type": "sberpay_qr_deeplink",
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/0d4e6d9e-96c1-4b95-a9c7-7a33c9d8eabe/8bc456031aa08fe0d188860647cec80987804729bb9f52c4278ece42a853ecbd",
        "payment": {
            "status": "pending",
            "gateway_id": 6016,
            "ref_id": "80b3c822-b263-512e-1836-4b131af76e0d",
            "message": "Обработка запроса прошла без системных ошибок",
            "bank_code": "E0"
        },
        "sberpay_qr_deeplink": {
            "type": "sberpay_qr_deeplink",
            "qr_code": "iVBORw0KGgoAAAANSUhEUgAAAMgAAADIAQAAAACFI5MzAAAEdUlEQVR4nO1YvW6jShQ+YyyNmxintAQGyU/gDiRL0PEc6/sAMaRxswskjRsb5wE2eQ46kCxB5ydAgoBEucbbMJLHc2f7m7vRbLtTIKTDOZz/74MB++gM4KPzVyIqoQipaIR81DC7YQhCNOwQCkTf4zPwe3bPzHBrhpn+DUrErsJedyPobH2dthMChwUNEx1S/Q9yIE2ATizoNtys5FnlZ3T+R+LG5SotIQc/KYL8czofSOSeyk4bGGbIWtfRX2EJv9wTtBYicLdmcIJ1Pg23sALqo6GoNYmx8rCoJ6SeGM1hwQtRyowJd0g30r/lzZ3PW065c1pfbkJbuN/ofX98wsrPUApZ9hhPuxjk5HcefCiRfozmt4V+t7mOCb3hTHW0aiQcKdVi4jq8BPQ91wKi1nEDoArnbY11INUAmlcA5mj+Bt66WtSaNDCOL1tlbUmVow5IMTlNfVl86h/MObUbFOtjA8Y5vpH5uyHsGx/zIrBqVb6iuO0YlbJqT0zhSPcna5IrqKuCfIoQz5v0GB2Ft6VnFF2n/pD1i3FEfdolZGcvhef0kA+jEb+9frd1JiuvgKW4FY/UuK6g5R2CEgX1fJlPqU2Fq+DaWEsoi5dfnCwgVseXgFEKT1aQlivryvw23FLqlJ3dABbOG2VM3dn6gZCZYQUpmhF9RTLh7n2C2stLtG3WcESZVkd8pQv7xiNVwx77thSA6sEx2mhaXwpHutuwnVm6merybblR3JD6jnBN4ecWeaBcDO4b93N4sIaXXLzfbvh6gOH3EYf45jkrdqPSj3XhSF1bH5+UtaFO8unO1sJev0ApPllQriCdpAAGXAitzOsYK8I1vZHh62K5wvCApIjh/WkYmsJ4SqWe1ds27OswAzYqPKi7fiqOC6Df2SUbTXcbcBMr6qazkzguqPIRJRxZhj+3TWQXg1PzxRXHBdQtn7D6zgHLLf+J5zdj+RYJ+8ZpTHEmdZBrUQavULmjunJ14SrIDtfVD0YTmjrztbCrIj74wh0C2d6YnoGwiHppKjuSvBHGLHgJzUmezTBEtgLYYqG+zsX324NdXgx+xY8JoL5wfU7hxDHrmeGA93Bccjp9Ju19rMBJGE9hnJIbXn51qL8pmQMPToN6YY5EA6w/pfC8nd/S4VvMCVgRpJpw3r64x68+jBf0sS+8fHnJJQ//TudjiRzN75PMO7E89gKr/eErzCz+gL8RLzX3hiqbAITbaVymC8/Cmcz3huSadRehPZ5HW3WWCuMCRHLxjiuWUdmWzim/1tXmdzofSiTW4xnU/JELAcCat+CjQYR948mqTM6LMCeWv1IHRz/ThfOG0Hyf4zChkxxcdkTR8gLieePfzi89GaTsbEj+iO6hHBNxXOhGtHLwGXTOA4OF5roQ2uI7hJ+3WGFOObaal0QNt+0NxHfIr4OLMAFIlQcZHnxTYp/R+W+J3EsezH1ziJLjE7SztN7n4tb4t/OdzQeq8Cx9vCAdq6pNI969rHQTzhm0PbAu47xLixLx/yF/JQKSfwHUwl6W8fstuAAAAABJRU5ErkJggg==",
            "deep_link": "sberpay://invoicing/v2?bankInvoiceId=80b3c822b263512e18364b131af76e0d&operationType=Web2App&option=Connect",
            "expired_at": "2026-01-26T08:55:40.494+00:00"
        },
        "customer": {
            "email": "email.name@example.com",
            "phone": "+79123456789",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Обработка запроса прошла без системных ошибок",
        "test": false,
        "billing_address": {
            "email": "email.name@example.com",
            "phone": "+79123456789"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "sberpay://invoicing/v2?bankInvoiceId=80b3c822b263512e18364b131af76e0d&operationType=Web2App&option=Connect",
            "method": "GET",
            "fields": []
        }
    }
}

Подтверждение транзакции

Этот метод предназначен для передачи номера телефона покупателя, если покупатель выбрал получение push-уведомления в приложении для завершения оплаты.Подробнее в описании процесса оплаты.

Запрос

POST https://api.bepaid.by/beyag/transactions/{uid}/confirm
Параметр Тип данных Описание
phone string Номер телефона покупателя со знаком +. В результате запроса, владелец номера телефона получит push-уведомление от приложения SberPay для завершения оплаты.
Пример запроса 
{
  "phone": "+79123456789"
}