Прием платежей через SberPay по QR-коду

Этот сценарий описывает прием платежа через SberPay по QR-коду. Для оплаты не требуется вводить данные карты.

Визуализация QR-кода и его передача плательщику производится на вашей стороне.

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

Гайдлайны и SDK можно найти здесь.

На оплату методом SberPay после подтверждения платежа дается 20 минут. Если в течение 20 минут вы не передадите Банку подтверждение в методе session/confirm, оплата не будет произведена, и сессия автоматически завершится в статусе canceled.

Сценарий оплаты

Создайте платежную сессию отдельно от платежа методом session/create или одновременно с платежом c помощью метода session/init/payment с набором необходимых параметров, в том числе с обязательным параметром channel = mobile_web и ссылкой для перехода плательщика в параметре return_url.
Если вы создали сессию отдельно от платежа, отправьте запрос session/start/payment.
Дождитесь от Банка 131 вебхука ready_to_confirm — он означает, что Банк готов провести платеж и ждет вашего подтверждения.
Подтвердите платеж запросом session/confirm или отмените платеж, отправив запрос session/cancel.
Опционально: вы можете вызвать методы отправки дополнительных уведомлений, СМС или PUSH, используя метод sberpay/push. Выбор для отправки СМС или PUSH производится на стороне провайдера (Сбер).
Дождитесь вебхука action_required с URL в параметре redirect.url, создайте QR-код из URL и передайте его плательщику.
Дождитесь, когда плательщик либо подтвердит, либо отменит оплату. Сбер отправляет плательщика в ваше приложение или на сайт по диплинку или URL, который был передан в параметре return_url.
Дождитесь от Банка 131 вебхука payment_finished с результатом проведения платежа или периодически опрашивайте статус транзакции (не чаще, чем 1 раз в 5 секунд).
Если плательщик откажется от оплаты, то об этом станет известно только по истечении 20 минут — как только закончится срок жизни заказа на оплату методом SberPay.
Сообщите пользователю статус платежа.

Пример запроса на оплату через QR-код

curl -X POST \
https://proxy.bank131.ru/api/v1/session/init/payment \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
  "payment_details": {
    "type": "internet_banking",
    "internet_banking": {
      "type": "sber_pay",
      "sber_pay": {
        "phone": "71234567890",
        "channel": "mobile_web"
      }
    }
  },
  "amount_details": {
    "amount": 1000,
    "currency": "RUB"
  },
  "metadata": "mobile_web",
  "customer": {
    "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
  },
  "payment_options": {
    "return_url": "https://t.me/bank131"
  }
}'

Пример ответа на запрос на оплату через QR-код

{
  "status": "ok",
  "session": {
    "id": "ps_12345",
    "status": "in_progress",
    "created_at": "2023-09-29T05:42:10.549869Z",
    "updated_at": "2023-09-29T05:42:10.948457Z",
    "acquiring_payments": [
      {
        "id": "pm_131",
        "status": "in_progress",
        "created_at": "2023-09-29T05:42:10.973559Z",
        "customer": {
          "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
        },
        "payment_details": {
          "type": "internet_banking",
          "internet_banking": {
            "type": "sber_pay",
            "sber_pay": {
              "phone": "71234567890",
              "channel": "mobile_webe"
            }
          }
        },
        "amount_details": {
          "amount": 1000,
          "currency": "RUB"
        },
        "metadata": "order123",
        "payment_options": {
          "return_url": "https://t.me/bank131",
          "recurrent": false
        }
      }
    ]
  }
}

Сценарий оплаты​

Сценарий оплаты