9. Привязка карты
Источник: https://docs.paykeeper.ru/dokumentatsiya-json-api/privyazka-karty/
Обзор
Привязка карты создаёт связь с конкретной картой в процессинге банка, позволяя списывать с неё средства в любой момент без участия держателя. Это полезно для услуг, где сумма/время транзакции не известны заранее — такси, прокат оборудования и т. п.
Первичная настройка
Первый платёж требует ввода реквизитов карты. Последующие платежи с привязанной картой могут проходить без участия держателя. Рекомендуется перед списанием заранее уведомлять держателя карты.
Для создания привязки через HTML-форму передаются параметры:
| Параметр | Назначение | Обязательный |
|---|---|---|
sum | Сумма списания в рублях | Да |
msgtype | Тип операции — createbinding | Да |
clientid | Идентификатор клиента | Да |
Остальные параметры — по стандартным правилам инициализации HTML-форм.
Пример HTML-формы
<form method='POST' action='http://demo.paykeeper.ru/create/' >
Идентификатор абонента: <input type='text' name='clientid' value='123456'/>
Сумма: <input type='text' name='sum' value='1'/>
<input type='submit' value='Создать привязку' />
<input type='hidden' name='msgtype' value='createbinding'/>
</form>Успешный платёж содержит поле bank_id — уникальный идентификатор привязки в банковской системе, позволяющий делать последующие безакцептные списания.
9.6 Безакцептное списание /change/binding/execute/
Тип: POST
Формат: /change/binding/execute/
Параметры:
| Параметр | Назначение |
|---|---|
bank_id | Уникальный банковский ID привязки |
clientid | Идентификатор клиента (как при создании привязки) |
orderid | Номер заказа в системе мерчанта |
token | Токен безопасности |
sum | Сумма платежа |
Успех
[
{"result": "success", "payment_id": "1582"}
]Ошибка
[
{"result": "fail", "msg": "runtime error during template execution"}
]Выполненный платёж получает тот же bank_id, что и исходный платёж привязки. POST-оповещения о безакцептных платежах содержат тот же bank_id.