Оплата по карте

Форма проведения платежа с помощью токена карты. В теле запроса необходимо передавать идентификатор покупателя customer_key и токен привязанной карты customer_card_token.

URL

Метод: GET или POST

• Production: https://customer.pay.kvell.group/payment/card
• Stage: https://customer.stage.kvell.group/payment/card

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

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

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

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

sha256({api_key}{customer_key}{customer_card_token}{transaction}{amount}{success_url}{fail_url}{secret_key})

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

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

Запрос GET

https://customer.stage.kvell.group/payment/card?api_key={api_key}&customer_key={customer_key}&customer_card_token={customer_card_token}&transaction={transaction}&description={description}&amount={amount}&signature={signature}&success_url={success_url}&fail_url={fail_url}

https://customer.stage.kvell.group/payment/card?api_key=b4aea11e-f94a-47ac-9687-633f3f8167fc&customer_key=bind_card_test&customer_card_token=CFAVTwnLWp2QvVIr97ognZlHh62Q3HnbQiS3CHll5ln&transaction=c829f8c1-6409-4ce5-b6fa-ec5dcef37dc8&description=Goody+goods&amount=909&signature=40907938777ae11db7ea55127891ecfd23e285b0b66a814714f10dc244ac92cf&success_url=http%3A%2F%2F127.0.0.1%3A5500&fail_url=http%3A%2F%2F127.0.0.1%3A5500&callback_url=http%3A%2F%2F127.0.0.1%3A5500

Запрос POST

<form action="https://customer.stage.kvell.group/payment/card" method="POST">
    <input type="hidden" name="api_key" value="3a8c82d6-d2c6-4165-9a6b-ab3f14d965ae">
    <input type="hidden" name="transaction" value="fbfe9f88-d5c7-4994-aed6-ee8003f4f342">
    <input type="hidden" name="customer_key" value="bind_card_test">
    <input type="hidden" name="customer_card_token" value="CFAVTwnLWp2QvVIr97ognZlHh62Q3HnbQiS3CHll5ln">
    <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="submit" value="Оплатить">
</form>