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

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

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

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

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

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

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

<form method='POST' action='http://demo.paykeeper.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	URI:/info/binding/autopayment-by-id/	Назначение:Автоплатеж по его id
9.2	URI:/info/binding/autopayments-by-bank-id/?bank_id=	Назначение:Все автоплатежи по bank_id
9.3	URI:/info/binding/binding-by-bank-id	Назначение:Подписка по bank_id
9.4	URI:/info/binding/autopayments-all	Назначение:Все автоплатежи
9.5	URI:/info/binding/autopayments-count	Назначение:Количество автоплатежей
9.6	URI:/change/binding/execute/	Назначение:Безакцептное выполнение платежа по имени привязки bank_id.
9.7	URI:/info/binding/autopayment-statistic/	Назначение:Статистика по автоплатежу

9.1. Автоплатеж по его id /info/binding/autopayment-by-id/

9.2. Все автоплатежи по bank_id /info/binding/autopayments-by-bank-id/?bank_id=

9.3. Подписка по bank_id /info/binding/binding-by-bank-id

9.4. Все автоплатежи /info/binding/autopayments-all

9.5. Количество автоплатежей /info/binding/autopayments-count

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

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

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

Тип	Формат запроса
Тип:POST	Формат запроса:/change/binding/execute/

	Параметр	Назначение
1.	Параметр:bank_id	Назначение:Банковский уникальный идентификатор привязки, по которому необходимо произвести списание.
2.	Параметр:clientid	Назначение:Идентификатор клиента в системе магазина, указанный при создании привязки.
3.	Параметр:orderid	Назначение:Номер заказа в системе магазина.
4.	Параметр:token	Назначение:Токен безопасности.
5.	Параметр:sum	Назначение:Сумма платежа.
	Параметр:…	Назначение:Остальные параметры инициализации платежа, которые поддерживает метод 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.

9.7. Статистика по автоплатежу /info/binding/autopayment-statistic

Оставьте заявку

Менеджер перезвонит вам и расскажет про детали подключения

Контактное лицо

Контактный телефон

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

Электронная почта

Адрес сайта

Соглашаюсь с обработкой персональных данных