Для получения URL (адреса для оплаты) нужно отправить запрос на сервер АПК Ассист методом HTTP POST (в кодировке UTF-8). На полученный в ответе URL можно перенаправить плательщика для последующей оплаты. Также полученный в ответе URL может быть подставлен в адрес iFrame.
В момент обращения к сервису PayRequest на стороне АПК Ассист создается заказ и фактически начинается процесс оплаты (с этого момента отсчитывается тайм-аут платежа). Поэтому промежуток времени между вызовом сервиса PayRequest и непосредственной переадресацией плательщика должен быть минимальным. Лучше всего вызывать PayRequest непосредственно перед переадресацией плательщика (или открытия iFrame).
URL запроса для передачи данных о платеже: https://<SERVER_NAME>/pay/payrequest.cfm
Список параметров полностью соответствует списку параметров авторизационного запроса.
Список параметров запроса (только основные параметры, а также наиболее часто используемые):
Название | Обяза- тельное поле | Принимаемые значения | Значение по умолчанию | Описание |
|---|---|---|---|---|
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
OrderNumber | Да | 128 символов | Номер заказа в системе расчетов предприятия. | |
Delay | Нет | 0 – одностадийный механизм работы | 0 | Признак авторизации банковской карты при двустадийном механизме работы |
Language | Нет | RU - русский, | Язык юр.лица или предприятия | Язык авторизационных страниц |
Order Comment | Нет | 256 символов | Комментарий | |
OrderAmount | Да | Число, 15 цифр (разделитель «.») | Сумма платежа в оригинальной валюте (например, 10.34) | |
OrderCurrency | Нет | 3 символа | Валюта юр.лица или предприятия | Код валюты, в которой указана сумма платежа OrderAmount (Коды валют см. в Таблице кодов валют) |
Lastname | Нет | 70 символов | Фамилия покупателя | |
Firstname | Нет | 70 символов | Имя покупателя | |
Middlename | Нет | 70 символов | Отчество покупателя | |
Нет | 128 символа | E-mail покупателя | ||
Address | Нет | 256 символов | Адрес покупателя | |
HomePhone | Нет | 64 символа | Домашний телефон покупателя | |
WorkPhone | Нет | 20 символов | Рабочий телефон покупателя | |
MobilePhone | Нет | 20 символов | Мобильный телефон покупателя | |
Fax | Нет | 20 символов | Факс покупателя | |
Country | Нет | 3 символа | Код страны покупателя | |
State | Нет | 3 символа | Код региона покупателя | |
City | Нет | 70 символов | Город покупателя | |
Zip | Нет | 25 символов | Индекс предприятия связи покупателя | |
URL_RETURN | Нет | 255 символов | URL страницы, на которую должен вернуться покупатель после осуществления платежа в системе (должна быть активирована опция «Перейти на страницу магазина» в настройках мерчанта в Личном кабинете). В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. | |
URL_RETURN_OK | Нет | 255 символов | Значение параметра URL_RETURN, а при его отсутствии – URL для возврата при успешной авторизации, указанный в Личном кабинете | URL страницы, куда должен вернуться покупатель после успешного осуществления платежа в системе АПК Ассист (должна быть активирована опция «Перейти на страницу магазина» в настройках мерчанта в Личном кабинете). В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. |
URL_RETURN_NO | Нет | 255 символов | Значение параметра URL_RETURN, а при его отсутствии – URL для возврата, указанный в Личном кабинете | URL страницы, куда должен вернуться покупатель после неуспешного осуществления платежа в системе АПК Ассист или при отсутствии ответа об окончательном статусе платежа (текущий статус "В процессе"), подробнее см."Возврат покупателя на страницу интернет-магазина после покупки". Должна быть активирована опция «Возвращаться в магазин по URL для возврата» в Личном кабинете. В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. |
CardPayment | Нет | 1 – использовать оплату по банковской карте, | 1 | Покупатель сможет сделать платеж с помощью банковской карты, если передано значение параметра 1 или параметр отсутствует (и оплата по банковским картам доступна для предприятия) |
Signature | Нет | строка | Формируется строка по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64 | |
Checkvalue | Нет | строка | Контрольный код. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правилам. | |
MobileDevice | Нет | 0 – использовать настройки мерчанта; | Вид платежных страниц (стандартные или для мобильных устройств). Если параметр не передан в запросе, используется настройка предприятия в системе (по умолчанию - стандартные страницы), для включения режима автоопределения устройства необходимо отправить письмо в службу поддержки support@assist.ru | |
| GooglePayPayment | Нет | 1; 0 | 0 | Признак оплаты через GooglePay (=1) |
| ApplePayPayment | Нет | 1; 0 | 0 | Признак оплаты через ApplePay (=1) |
| SamsungPayPayment | Нет | 1; 0 | 0 | Признак оплаты через SamsungPay (=1) |