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

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

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

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
    }
  ]
}

После получения успешного ответа необходимо вызвать метод проведения платежа СБП.