Форма холдирования

Форма привязки карты через холдирование или предавторизации карты c отменой.

URL

Метод: GET или POST

Production: https://customer.pay.kvell.group/bind/card/preauthorize
Stage: https://customer.stage.kvell.group/bind/card/preauthorize

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

Название	Тип данных	Обязательно	Описание
`api_key`	string	Да	Уникальный идентификатор магазина
`customer_key`	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	Да	Подпись

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

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

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

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

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

Запрос `GET`

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

https://customer.stage.kvell.group/bind/card/preauthorize?api_key=a1aea13e-f94a-47ac-9687-633f3f8167fc&customer_key=bind_card_test&transaction=4416ea3d-ea94-4319-87d0-8fdf44b1bc87&description=Goody+goods&amount=627&signature=1cd3f0c885b15a63974406c453b6b7a0a1b2319c0ca017c7eb4bad15d73f5e86&success_url=http%3A%2F%2F127.0.0.1%3A5500&fail_url=http%3A%2F%2F127.0.0.1%3A5500

Запрос `POST`

<form action="https://customer.stage.kvell.group/bind/card/preauthorize" 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="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>

Отправка колбэка

Отправка коллбэка с информацией о привязанной карте. Колбэк задается в личном кабинете Мерчанта в технических настройках магазина. Необходимо выбрать тип колбэка Сохранение привязанной карты.

Метод: POST

Параметры

Название	Тип данных	Описание
`customer_key`	string	Идентификатор покупателя в системе продавца
`customer_card_token`	string	Токен привязанной карты
`pan_mask`	string	Маска карты
`holder`	string	Имя держателя карты
`transaction`	string	Уникальный номер транзакции на стороне мерчанта

{
  "customer_key": "bind_card_test",
  "customer_card_token": "4VNSbS7nF410G8WLEhUUUnflH2UKvWlHxIzN3Jr9JJs",
  "pan_mask": "411111******1111",
  "holder": "IVAN IVANOV",
  "transaction": "563bb54d-ed4c-4ca1-84a3-6a35c0178cf5"
}

Доставка колбэка

Отправка колбэка считается успешной, если ответ от сервера мерчанта вернёт статус HTTP-код 200. Любой другой HTTP-код в ответе означает, что запрос не доставлен.

Если первая отправка была неуспешной, то будет предпринято еще 5 попыток каждые 10 минут.