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

Alfa-Pay

Проведение платежа через Alfa-Pay и получение ссылки для оплаты.

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

URL

Метод: POST

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

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

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

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

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

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

Название Тип данных Обязательно Описание
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_alfapay"
}

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

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