Page History
...
Предприятие может хранить расписание подписки на своей стороне и инициировать последующие платежи через запрос к веб-сервису системы АПК Ассист (описание параметров инициирующего авторизационного запроса и веб-сервиса для последующих платежей.
Веб-сервис предназначен для инициации оплаты за продолжение предоставления услуг по подписке. Возможность работы с этим сервисом определяется настройками процессинга банка-эквайера. Подробную информацию можно получить в службе поддержи 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
2 – WDDX
3 – XML
4 - SOAP
...
1 для POST запроса,
4 для SOAP
...
Формат выдачи результатов
Примечание. Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл.5.15.
Пример запроса для формата HTTP POST:
| Code Block | ||
|---|---|---|
| ||
<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
2 – WDDX
3 – XML
4 - SOAP
...
1 для POST запроса,
4 для SOAP
...
Формат выдачи результатов
Параметры ответа:
...
Название
...
Значение
Необходимо обязательно получить от клиентского отдела подтверждение, что подключаемому предприятию разрешены автоматические рекуррентные платежи.
Подробнее о реализации рекуррентных платежей по расписанию
Уведомление покупателя о подписке на платежных страницах
При совершении первоначального рекуррентного платежа на платежных страницах АПК Ассист покупатель увидит следующее сообщение о подписке:
| Panel |
|---|
Оплачивая данный заказ, вы соглашаетесь на периодическое (раз в <RecurringPeriod> <RecurringPeriodScale>) списание средств (в размере <RecurringMaxAmount> <OrderCurrency>) с вашей банковской карты в срок до <RecurringMaxDate> |
Пример платежной страницы с сообщением о подписке:
Информация об автоматических рекуррентных платежах в личном кабинете
Просмотр информации об автоматических рекуррентных платежах доступен в личном кабинете предприятия в разделе «Автоматические платежи». Можно просмотреть список заказов (как первоначальных, так и автоматических рекуррентных платежей), сделать отмену, изменить расписание автоматических платежей.
...
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
...
Процессинг
...