Рекуррентные платежи
Рекуррентные платежи используются в том случае, когда требуется периодическое списание средств с банковской карты клиента в счет предприятия – поставщика услуг. Это разного рода подписки – оплата хостинга, мобильного телефона, доступа к ресурсам и т. п. Метод удобен для пользователя, так как данные карты вводятся клиентом один раз при первом платеже.
Предприятие может хранить расписание подписки на своей стороне и инициировать последующие платежи через запрос к веб-сервису системы АПК Ассист (описание параметров инициирующего авторизационного запроса и веб-сервиса для последующих платежей.
Веб-сервис предназначен для инициации оплаты за продолжение предоставления услуг по подписке. Возможность работы с этим сервисом определяется настройками процессинга банка-эквайера. Подробную информацию можно получить в службе поддержи ASSIST по адресу support@assist.ru.
Для инициации рекуррентного платежа необходимо в первоначальном запросе на авторизацию передать значение параметра RecurringIndicator=1 и значения параметров, задающих диапазон сумм последующих рекуррентных платежей, периодичность оплат (в днях) и дату окончания подписки.
Затем с указанной периодичностью предприятие инициирует платеж, задавая сумму, а необходимая платежная информация (данные банковской карты) берется из первоначальной оплаты.
Для совершения следующего рекуррентного платежа необходимо отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8).
URL запроса для рекуррентного платежа: https://<SERVER-NAME>/recurrent/rp.cfm.
Список параметров запроса
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
BillNumber | Да | 15 или 16 цифр | BillNumber первого заказа | |
OrderNumber | Да | 128 символов | Номер нового заказа для рекуррентного платежа | |
Merchant_ID | Да | Число | Идентификатор предприятия в АПК Ассист | |
Login | Да | 8 - 20 символов | Логин (лат. буквы и цифры, символ _) | |
Password | Да | 8 - 20 символов | Пароль (лат. буквы и цифры) | |
Amount | Да | Число, 15 цифр (разделители «.», «,») | Сумма рекуррентного платежа, должна находиться в допустимом диапазоне между значениями максимальной и минимальной сумм рекуррентных платежей, переданных при первоначальном запросе на авторизацию инициирующего платежа. | |
Currency | Да | 3 символа | Валюта рекуррентного платежа, должна совпадать с валютой инициирующего, в противном случае заказ закрывается с ошибкой. | |
OrderComment | Нет | 256 символов | Комментарий | |
Language | Нет | RU EN | EN | Язык вывода результатов |
Format | Нет | 1 – CSV | 1 для POST запроса, 4 для SOAP | Формат выдачи результатов |
Примечание. Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл.5.15.
Пример запроса для формата HTTP POST:
<FORM ACTION="https://<SERVER-NAME>/recurrent/rp.cfm" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="BillNumber" VALUE="511111100000001.1"> <INPUT TYPE="HIDDEN" NAME="OrderNumber" VALUE="A1_R1"> <INPUT TYPE="HIDDEN" NAME="Merchant_ID" VALUE="Ваш Merchant_ID"> <INPUT TYPE="HIDDEN" NAME="Login" VALUE="Ваш логин"> <INPUT TYPE="HIDDEN" NAME="Password" VALUE="Ваш пароль"> <INPUT TYPE="HIDDEN" NAME="Amount" VALUE="20"> <INPUT TYPE="HIDDEN" NAME="Currency" VALUE="RUB"> <INPUT TYPE="HIDDEN" NAME="Format" VALUE="3"> <INPUT TYPE="HIDDEN" NAME="Language" VALUE="EN"> <INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Выполнить"> </FORM>
Список параметров ответа:
Название | Значение |
billnumber | Уникальный номер заказа в системе АПК Ассист, расширенный формат |
ordernumber | Номер заказа |
testmode | Тестовый режим |
ordercomment | Комментарий |
orderamount | Оригинальная сумма заказа |
ordercurrency | Оригинальная валюта заказа |
firstname | Имя плательщика |
lastname | Фамилия плательщика |
middlename | Отчество плательщика |
Email плательщика | |
orderdate | Дата заказа по Гринвичу (GMT) |
orderstate | Статус заказа |
packetdate | Дата формирования запроса по Гринвичу (GMT) |
signature | |
operationtype | Тип операции |
amount | Сумма операции |
currency | Валюта операции |
ipaddress | IP-адрес плательщика |
meantypename | Тип платежного средства |
meansubtype | Подтип платежного средства |
meannumber | Номер платежного средства |
cardholder | Держатель платежного средства |
cardexpirationdate | Срок действия карты |
issuebank | Название банка-эмитента |
bankcountry | Страна банка-эмитента |
rate | Курс валюты |
responsecode | Код возврата |
message | Сообщение о результате операции |
customermessage | Сообщение о результате для покупателя |
recommendation | Рекомендация |
approvalcode | Код авторизации |
protocoltypename | Протокол |
processingname | Процессинг |
В качестве значения поля <meannumber> возвращаются первые 6 и последние 4 цифры номера карты, остальные цифры скрыты символом *.
Автоматические рекуррентные платежи по расписанию
Имеется возможность хранения расписания и инициации последующих платежей на стороне АПК Ассист. В этом случае предприятие передает параметры расписания в первоначальном платеже, а дальнейшие платежи (рекуррентные платежи по расписанию) инициируются автоматически на сервере АПК Ассист.
Для подключения автоматических рекуррентных платежей следует отправить соответствующую заявку в клиентский отдел по адресу support@assist.ru. В заявке должен присутствовать идентификатор предприятия (мерчанта) в системе – MerchantID, мерчант должен работать через процессинг, разрешающий проведение рекуррентных платежей.
Сервис предназначен для инициации оплаты за продолжение предоставления услуг по подписке. Данная возможность допустима для оплат, проводимых через процессинг UCS и ОАО «Банк «Санкт-Петербург».
Для инициации рекуррентного платежа необходимо в первоначальном запросе на авторизацию передать значение параметра RecurringIndicator=1 и значения параметров, задающих диапазон сумм последующих рекуррентных платежей, периодичность оплат (в днях) и дату окончания подписки.
Затем с указанной периодичностью предприятие инициирует платеж, задавая сумму, а необходимая платежная информация (данные кредитной карты) берется из первоначальной оплаты.
Для совершения следующего рекуррентного платежа необходимо отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8).
Параметры запроса:
Название | Обязатель-ное поле | Принимаемые значения | Значение по умолчанию | Описание |
BillNumber | Да | 15 или 16 цифр | BillNumber первого заказа | |
OrderNumber | Да | 128 символов | Номер нового заказа для рекуррентного платежа | |
Merchant_ID | Да | Число | Идентификатор предприятия в АПК Ассист | |
Login | Да | 8 - 20 символов | Логин (лат. буквы и цифры, символ _) | |
Password | Да | 8 - 20 символов | Пароль (лат. буквы и цифры) | |
Amount | Да | Число, 15 цифр (разделители «.», «,») | Сумма рекуррентного платежа | |
Currency | Да | 3 символа | Валюта рекуррентного платежа | |
OrderComment | Нет | 256 символов | Комментарий | |
Language | Нет | RU EN | EN | Язык вывода результатов |
Format | Нет | 1 – CSV | 1 для POST запроса, 4 для SOAP | Формат выдачи результатов |
Параметры ответа:
Название | Значение |
billnumber | Уникальный номер заказа в системе АПК Ассист, расширенный формат |
ordernumber | Номер заказа |
testmode | Тестовый режим |
ordercomment | Комментарий |
orderamount | Оригинальная сумма заказа |
ordercurrency | Оригинальная валюта заказа |
firstname | Имя плательщика |
lastname | Фамилия плательщика |
middlename | Отчество плательщика |
Email плательщика | |
orderdate | Дата заказа по Гринвичу (GMT) |
orderstate | Статус заказа |
packetdate | Дата формирования запроса по Гринвичу (GMT) |
signature | |
operationtype | Тип операции |
amount | Сумма операции |
currency | Валюта операции |
ipaddress | IP-адрес плательщика |
meantypename | Тип платежного средства |
meansubtype | Подтип платежного средства |
meannumber | Номер платежного средства |
cardholder | Держатель платежного средства |
cardexpirationdate | Срок действия карты |
issuebank | Название банка-эмитента |
bankcountry | Страна банка-эмитента |
rate | Курс валюты |
responsecode | Код возврата |
message | Сообщение о результате операции |
customermessage | Сообщение о результате для покупателя |
recommendation | Рекомендация |
approvalcode | Код авторизации |
protocoltypename | Протокол |
processingname | Процессинг |
- Описание rp.cfm
- Авторекуренты, создание расписания в ЛК
- Псевдорекунты?
- Привязка новой карты