Skip to content

SberPay

SB Integration option

Payment

Info

This integration option supports only RUB currency.

Payment flow

  1. The customer selects SberPay as a payment method on the merchant's website.
  2. The merchant sends a payment request to bePaid.

  3. bePaid sends a response with the following parameters:

    • deep link that redirects the customer to the payment page in the SberPay app (sberpay_qr_deeplink.deep_link or form.action);
    • QR-code, scanning the QR-code opens the payment page in the SberPay app (sberpay_qr_deeplink.qr_code).

    The links are valid for 20 minutes.

  4. The merchant redirects the customer to the link:

    • If the customer uses a mobile device, the merchant redirects the customer to the SberPay application using the deep link received at the previous step;
    • If the customer is using a desktop device, the merchant displays a QR-code and a button that redirects to a page where the customer submits their phone number for receiving a push notification from SberPay application;
      • If the customer selects the option to receive a push notification, the merchant displays a UI for submitting the phone number;
      • The customer submits their phone number;
      • The merchant sends the transaction confirmation request with the customer's phone number to bePaid;
      • The customer receives a push notification from the SberPay application.

  5. The customer completes the payment in the SberPay application.

  6. bePaid sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from bePaid using a the status query.
Request

Send a payment request with the following additional parameters:
object
return_url
required
 string
URL to return the customer to when the transaction is completed.
expired_at
 string
The time when the payment links expire, in ISO-8601 format: YYYY-MM-DDThh:mm:ssTZD, where YYYY – year (for example, 2026), MM – month (for example, 02), DD – day (for example, 09), hh – hours (for example, 18), mm – minutes (for example, 20), ss – seconds (for example, 45), TZD – time zone (+hh:mm or –hh:mm).
object
A section of the payment method information.
type
required
 string
sberpay_qr_deeplink
object
A section of information about the customer.
email
 string
The customer's email address.
phone
 string
The customer's phone number.
Request example 
{
    "request": {
        "amount": 200,
        "currency": "RUB",
        "description": "description",
        "return_url": "https://your_return_url.com",
        "method": {
            "type": "sberpay_qr_deeplink"
        },
        "customer": {                  
            "email": "john@example.com"
        }
    }
}
Response

The response will contain additional parameters:

  • sberpay_qr_deeplink.qr_code for displaying on the desktop device;
  • sberpay_qr_deeplink.deep_link and form.action – both contain a link for redirecting the customer to the SberPay application on the mobile device.
Response example 
{
    "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": []
        }
    }
}

Transaction confirmation

This request submits the customer's phone number if they have selected the option to complete the payment through a push notification in the application (see the payment flow for details).

Request

POST https://api.bepaid.by/beyag/transactions/{uid}/confirm
Parameter Type Description
phone string The customer's phone number with the + sign. The owner of the phone number will receive the push notification from the SberPay application for completing the payment.
Request example 
{
  "phone": "+79123456789"
}