Page History
...
Название | Обяза-тельное поле | Принимаемые значения | Значение по умолчанию | Описание | ||
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |||
OrderNumber | Да | 128 символов | Номер заказа в системе расчетов предприятия. | |||
Delay | Нет | 0 – одностадийный механизм работы | 0 | Признак авторизации банковской карты при двустадийном механизме работы | ||
Language | Нет | RU - русский, EN - английский | Язык юр.лица или предприятия | Язык авторизационных страниц | ||
OrderComment | Нет | 4000 символов | Комментарий | |||
OrderAmount | Да | Число, 15 знаков, два знака после разделителя (допустимый разделитель «.») | Сумма платежа в оригинальной валюте (например, 10.34) | |||
OrderCurrency | Нет | 3 символа | Валюта юр.лица или предприятия | Код валюты, в которой указана сумма платежа OrderAmount (коды валют см. в Таблице кодов валют) | ||
Lastname | Нет | 70 символов | Фамилия покупателя | |||
Firstname | Нет | 70 символов | Имя покупателя | |||
Middlename | Нет | 70 символов | Отчество покупателя | |||
Нет | 128 символа | E-mail покупателя | ||||
Address | Нет | 256 символов | Адрес покупателя | |||
HomePhone | Нет | 64 символа | Домашний телефон покупателя | |||
WorkPhone | Нет | 20 символов | Рабочий телефон покупателя | |||
MobilePhone | Нет | 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 или параметр отсутствует (и оплата по банковским картам доступна для предприятия). | ||
ERIPPayment** | Нет | 1 – использовать оплату по ЕРИП, | 1 | Покупатель сможет сделать платеж по ЕРИП, если передано значение параметра 1 или параметр отсутствует (и оплата по ЕРИП доступна для предприятия). | ||
MobiconPayment | Нет | 1 – использовать платежную систему Mobicon, | 1 | Покупатель сможет сделать платеж с помощью платежной системы Mobicon, если передано значение параметра 1 или параметр отсутствует (и оплата по Mobicon доступна для предприятия) | ||
| GooglePayPayment | Нет | 1; 0 | 0 | Признак оплаты через Google Pay (=1) | ||
| ApplePayPayment | Нет | 1; 0 | 0 | Признак оплаты через ApplePay (=1) | ||
| SamsungPayPayment | Нет | 1; 0 | 0 | Признак оплаты через SamsungPay (=1) | ||
Signature | Нет* | строка | Формируется строка по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64.
| |||
Checkvalue | Нет* | строка | Контрольный код. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правилам. Примечание. Если мерчант формирует контрольный код без разделителей, следует сообщить об этом в службу поддержки support@belassist.by.
| |||
MobileDevice | Нет | 0 – использовать настройки мерчанта; | Вид платежных страниц (стандартные или для мобильных устройств). Если параметр не передан в запросе, используется настройка предприятия в системе (по умолчанию - стандартные страницы), для включения режима автоопределения устройства необходимо отправить письмо в службу поддержки support@belassist.by. | |||
RecurringIndicator | Нет | 1 – рекуррентный платеж | 0 | Признак рекуррентного платежа | ||
RecurringMinAmount | Нет/Да | Число, 15 знаков, два знака после разделителя (допустимый разделитель «.») | Минимальная сумма рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1 | |||
RecurringMaxAmount | Нет/Да | Число, 15 знаков, два знака после разделителя (допустимый разделитель «.») | Максимальная сумма рекуррентных платежей. Параметр обязателен при RecurringIndicator=1 | |||
RecurringPeriod | Нет/Да | Число, 10 цифр | Периодичность рекуррентных платежей в днях. Параметр обязателен при RecurringIndicator=1 | |||
RecurringMaxDate | Нет/Да | Строковое представление даты в формате DD.MM.YYYY | Дата окончания рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1 |
*Для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками, необходимо передать один из параметров (Signature или Checkvalue), также должна быть включена настройка проверки контрольного кода (или подписи) в ЛК.
**В целях безопасности для таких платежей не рекомендуется передавать в значениях параметров персональные данные о плательщике (фамилия, имя, отчество, адрес и т.п.), если их наличие не является обязательным для совершения платежа.
| Note | ||
|---|---|---|
| ||
Все параметры, передаваемые в запросе, проходят автоматическую валидацию в АПК Ассист. Правила валидации описаны в табл. "Правила валидации входных параметров". |
...