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

СБП

Проведение платежа с помощью СБП и получение ссылки для оплаты.

Перед вызовом необходимо создать сессию методом POST /v1/orders/session.

URL

Метод: POST

  • Production: https://api.pay.kvell.group/v1/orders/sbp
  • Stage: https://api.pay.stage.kvell.group/v1/orders/sbp

Параметры запроса

Название
 Тип данных Обязательно Описание
transaction string Да Уникальный номер транзакции на стороне мерчанта, использованный при создании сессии
customer string Нет Идентификатор клиента

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

{
  "transaction": "57c49ef5-5b15-4b1e-900d-6d85d0a7f7b4",
  "customer": "customer@example.com"
}

Заголовки запроса

Название Тип данных Обязательно Описание
X-Api-Key string Да Уникальный идентификатор магазина
X-Signature string Да Подпись

Подпись X-Signature формируется конкатенацией X-Api-Key, transaction и secret_key. Формируется sha256 от полученной строки:

sha256({X-Api-Key}{transaction}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта;

Ответ запроса

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

{
  "form_url": "https://redirect.url/to_sbp"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}

Получив form_url, выполните редирект пользователя на страницу оплаты или сформируйте из ссылки QR-код.

Привязка счёта

Привязка счёта без оплаты

Чтобы выполнить привязку счёта без оплаты, при создании сессии передавайте amount равным 0. После успешной привязки можно использовать метод рекуррентного платежа для безакцептного списания без присутствия клиента.

Привязка счёта с оплатой

Чтобы выполнить привязку счёта с оплатой, при создании сессии передавайте amount больше 0. После успешной привязки можно использовать метод рекуррентного платежа для безакцептного списания без присутствия клиента.