9. Привязка карты

Привязкой карты называется созданная в банковской процессинговой сети ассоциация с определённой картой, позволяющая списывать в любое время с привязанной карты любую сумму и зачислять её определённому абоненту. Данная возможность оказывается особенно полезной, кода нельзя точно или заранее определить, какую сумму и когда нужно будет списать с карты плательщика. Примером могут быть службы такси и сервисы аренды оборудования.

Первый платеж по карте, которую нужно привязать, будет проходить в обычном режиме с вводом реквизитов карты. Поэтому для создания привязки можно провести транзакцию на любую сумму (в том числе на 1 рубль). Последующие платежи по этой карте можно будет выполнять без явного участия плательщика, безакцептно. Тем не менее, если нужно выполнить платёж с привязанной карты по расписанию, без явного действия со стороны абонента, мы настоятельно рекомендуем уведомлять абонента заранее перед очередным списанием.

Для создания привязки необходимо при инициализации платежа методом HTML-формы передать следующие параметры:

	Параметр	Назначение	Обязательный
1	sum	Сумма списания в рублях.	Да
2	msgtype	Тип операции, для создания привязки карты принимает значение createbinding.	Да
3	clientid	Идентификатор клиента.	Да

Остальные параметры принимаются и обрабатываются так же, как и при обычной инициализации платежа методом HTML-формы.

Пример формы для создания привязки карты.

<form method='POST' action='http://demo.rsb-processing.ru/create/' >
  Идентификатор абонента: <input  type='text' name='clientid' value='123456'/> <br />
  Сумма: <input  type='text' name='sum' value='1'/> <br />
  <input type='submit' value='Создать привязку' />
  <input  type='hidden' name='msgtype' value='createbinding'/> 
</form>

Идентификатор абонента: <input type='text' name='clientid' value='123456'/> <br />

Сумма: <input type='text' name='sum' value='1'/> <br />

</form>

Пример, как будет отображаться данная форма:

Более подробно о создании HTML-Формы можно прочитать в разделе методы интеграции.

В параметрах проведенного платежа будет содержаться полe bank_id, это уникальный идентификатор привязки в системе банка. В POST-оповещение по такому платежу будет добавлено полe bank_id. Оно позволит в дальнейшем проводить безакцептные списания с использованной в данном платеже карты.

В настоящее время JSON API поддерживает следующие методы для работы с привязками карт:

	URI	Назначение
9.1	RESERVED
9.2	RESERVED
9.3	RESERVED
9.4	RESERVED
9.5	RESERVED
9.6	/change/binding/execute/	Безакцептное выполнение платежа по имени привязки bank_id.
9.7	RESERVED

9.6. Безакцептное списание по имени связки /change/binding/execute/

При помощи этого запроса можно выполнить списание по привязанной ранее карте. Формат запроса:

Таблица 8.6.1. Параметры запроса

Тип	Формат запроса
POST	/change/binding/execute/
	Параметр	Назначение
1.	bank_id	Банковский уникальный идентификатор привязки, по которому необходимо произвести списание.
2.	orderid	Номер заказа в системе магазина.
3.	token	Токен безопасности.
	…	Остальные параметры инициализации платежа, которые поддерживает метод HTML-формы.

Обратите внимание, что выполняемому платежу будет присвоен bank_id такой же, как и у первого платежа, по которому выполнялась привязка карты. Если списание произведено успешно, то возвращается объект вида:

[
    {
   "result":"success",
   "payment_id":"1582"
    }
]

[

{

"result":"success",

"payment_id":"1582"

}

]

В поле payment_id этого объекта будет содержаться номер совершённого платежа. Информацию о нём можно получить с помощью запроса 2.3 или дождавшись POST-уведомления.

В случае ошибки поле result ответа будет содержать описание ошибки:

[
   {
   "result":"fail",
   "msg":"runtime error during template execution"
   }
]

[

{

"result":"fail",

"msg":"runtime error during template execution"

}

]

POST-оповещение по безакцептному платежу, выполненному с помощью привязки карты с идентификатором bank_id , будет содержать такое же значение в поле bank_id .