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

СБП

СБП для юрлиц позволяет регистрировать платёжные ссылки и генерировать QR-коды по запросу получателя. Получатель может передать их плательщику для совершения платежа на основе предоставленных данных.

Создание сессии

Создание сессии используется для инициализации платежа.

URL

Метод: POST

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

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

Название
 Тип данных Обязательно Описание
amount integer Да Сумма в копейках
description string Да Описание к транзакции
transaction string Да Уникальный номер транзакции на стороне мерчанта
extra_data json-поле Нет Дополнительная информация
fiscal_data json-поле Нет Фискальные данные 
{
  "transaction": "57c49ef5-5b15-4b1e-900d-6d85d0a7f7b4",
  "amount": 10000,
  "description": "Товар за 100 рублей",
  "extra_data": {
        "merchant_data_key": "merchant_data_value"
    }
}

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

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

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

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

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

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

{
  "ok": true
}

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

Регистрация платежа

Регистрация платежа выполняется получателем платежа для последующего получения QR-кода (платёжной ссылки), по которой плательщик совершит оплату.

URL

Метод: POST

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

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

Название
 Тип данных Обязательно Описание
transaction string Да Уникальный номер транзакции на стороне мерчанта
tax_percentage 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-код.