Платежная страница

Проведение платежа с переходом на платежную страницу KVELL.

Проведение платежа

URL

Метод: POST

• Production: https://pay.kvell.group/checkout
• Stage: https://pay.stage.kvell.group/checkout

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

Название	Тип	Обязательно	Описание
api_key	string	Да	Уникальный идентификатор магазина
signature	string	Да	Подпись
amount	integer	Да	Сумма в копейках
description	string	Да	Описание к транзакции
transaction	string	Да	Уникальный номер транзакции на стороне мерчанта
success_url	string	Да	Ссылка при успешном выполнении запроса
fail_url	string	Да	Ссылка при неверном выполнении запроса
phone	string	Нет	Номер телефона плательщика для привязки карт
auto_return	string	Нет	Автоматический редирект на success_url или fail_url после оплаты. Задается в секундах. Если передать значение больше 0, то редирект произойдет через N-секунд. Если значение равно 0, то редирект произойдет сразу.
extra_data	json	Нет	Дополнительная информация
fiscal_data	json	Нет	Фискализация чека по Ф3-54

Формирование подписи

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

sha256({api_key}{transaction}{amount}{secret_key})

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

Пример

<form action="https://pay.kvell.group/checkout" method="POST">
    <input type="hidden" name="api_key" value="3a8c82d6-d2c6-4165-9a6b-ab3f14d965ae">
    <input type="hidden" name="amount" value="10000">
    <input type="hidden" name="description" value="Продукт №1">
    <input type="hidden" name="signature" value="afc09ed74d83849d44c1f1906b10d20c147bf0eb25da940c020c980b3b44ca38">
    <input type="hidden" name="success_url" value="http://yoursite.com/success">
    <input type="hidden" name="fail_url" value="http://yoursite.com/fail">
    <input type="hidden" name="transaction" value="fbfe9f88-d5c7-4994-aed6-ee8003f4f342">
    <input type="hidden" name="phone" value="79991234567">
    <input type="hidden" name="extra_data" value='{"string": "string"}'>
    <input type="hidden" name="fiscal_data"
           value='{"items": [{"name": "TEST", "price": 10025, "quantity": 2, "sum": 20050, "measurement_unit": "кг", "payment_method": "full_payment", "payment_object": "commodity", "vat_type": "vat20"}], "client": {"email": "client_email@mail.ru", "phone": "+71231234567"}, "company": {"email": "company_email@mail.ru", "sno": "osn", "payment_address": "https://kvell.com"}}'>
    <input type="submit" value="Оплатить">
</form>

Каскадный эквайринг

Каскадный эквайринг интегрируется аналогично форме проведения платежа, но только необходимо использовать два магазина.

URL

Метод: POST

• Production: https://pay.kvell.group/checkout/cascade
• Stage: https://pay.stage.kvell.group/checkout/cascade

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

Название	Тип	Обязательно	Описание
api_key_1	string	Да	Уникальный идентификатор первого магазина
api_key_2	string	Да	Уникальный идентификатор второго магазина
signature	string	Да	Подпись
amount	integer	Да	Сумма в копейках
description	string	Да	Описание к транзакции
transaction	string	Да	Уникальный номер транзакции на стороне мерчанта
success_url	string	Да	Ссылка при успешном выполнении запроса
fail_url	string	Да	Ссылка при неверном выполнении запроса
phone	string	Нет	Номер телефона плательщика для привязки карт
extra_data	json	Нет	Дополнительная информация
fiscal_data	json	Нет	Фискализация чека по Ф3-54

Формирование подписи

Подпись signature формируется конкатенацией api_key_1, api_key_2, transaction, amount, secret_key_1 и secret_key_2. Формируется sha256 от полученной строки:

sha256({api_key_1}{api_key_2}{transaction}{amount}{secret_key_1}{secret_key_2})

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

Пример

<form action="https://pay.kvell.group/checkout/cascade" method="POST">
    <input type="hidden" name="api_key_1" value="d0aea12e-f94a-47ac-9687-633f3f8167ac">
    <input type="hidden" name="api_key_2" value="ab64d7ee-cfd6-4f32-98ef-35996bd2815b">
    <input type="hidden" name="amount" value="10000">
    <input type="hidden" name="description" value="Продукт №1">
    <input type="hidden" name="signature" value="afc09ed74d83849d44c1f1906b10d20c147bf0eb25da940c020c980b3b44ca38">
    <input type="hidden" name="success_url" value="http://yoursite.com/success">
    <input type="hidden" name="fail_url" value="http://yoursite.com/fail">
    <input type="hidden" name="transaction" value="fbfe9f88-d5c7-4994-aed6-ee8003f4f342">
    <input type="hidden" name="phone" value="79991234567">
    <input type="hidden" name="extra_data" value='{"string": "string"}'>
    <input type="hidden" name="fiscal_data"
           value='{"items": [{"name": "TEST", "price": 10025, "quantity": 2, "sum": 20050, "measurement_unit": "кг", "payment_method": "full_payment", "payment_object": "commodity", "vat_type": "vat20"}], "client": {"email": "client_email@mail.ru", "phone": "+71231234567"}, "company": {"email": "company_email@mail.ru", "sno": "osn", "payment_address": "https://kvell.com"}}'>
    <input type="submit" value="Оплатить">
</form>