Page History
| Table of Contents |
|---|
Список параметров авторизационного запроса
URL авторизационного запроса:
...
Название | Обяза- тельное поле | Принимаемые значения | Значение по умолчанию | Описание |
|---|---|---|---|---|
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 или параметр отсутствует (и оплата по банковским картам доступна для предприятия) |
YM Payment | Нет | 1 – использовать платежную систему YandexMoney, | 1 | Покупатель сможет сделать платеж с помощью платежной системы YandexMoney, если передано значение параметра 1 или параметр отсутствует (и оплата по YandexMoney доступна для предприятия) |
WMPayment | Нет | 1 – использовать платежную систему WebMoney, | 1 | Покупатель сможет сделать платеж с помощью платежной системы WebMoney, если передано значение параметра 1 или параметр отсутствует (и оплата по WebMoney доступна для предприятия) |
QIWIPayment | Нет | 1 – использовать платежную систему QIWI, | 1 | Покупатель сможет сделать платеж с помощью всех средств оплаты платежной системы QIWI, если передано значение параметра 1 или параметр отсутствует (и оплата по QIWI доступна для предприятия) |
QIWI Mts Payment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор МТС) |
QIWI Megafon Payment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор Мегафон) |
QIWIBeelinePayment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор БиЛайн) |
| QIWITele2Payment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор Tele2) |
Signature | Нет | строка | Формируется строка по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64 | |
Checkvalue | Нет | строка | Контрольный код. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правилам. | |
MobileDevice | Нет | 0 – использовать настройки мерчанта; | Вид платежных страниц (стандартные или для мобильных устройств). Если параметр не передан в запросе, используется настройка предприятия в системе (по умолчанию - стандартные страницы), для включения режима автоопределения устройства необходимо отправить письмо в службу поддержки support@assist.ru | |
RecurringIndicator | Нет | 1 – рекуррентный платеж | 0 | Признак рекуррентного платежа |
RecurringMinAmount | Нет/Да | Число, 15 цифр (разделитель «.») | Минимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1 | |
RecurringMaxAmount | Нет/Да | Число, 15 цифр | Максимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1 | |
RecurringPeriod | Нет/Да | Число, 10 цифр | Периодичность рекуррентных платежей в днях.Обязателен при RecurringIndicator = 1 | |
RecurringMaxDate | Нет/Да | Строковое представление даты в формате DD.MM.YYYY | Дата окончания рекуррентных платежей. Обязателен при RecurringIndicator = 1 | |
| GooglePayPayment | Нет | 1; 0 | 0 | Признак оплаты через GooglePay (=1) |
| ApplePayPayment | Нет | 1; 0 | 0 | Признак оплаты через ApplePay (=1) |
| SamsungPayPayment | Нет | 1; 0 | 0 | Признак оплаты через SamsungPay (=1) |
| FastPayPayment | Нет | 1; 0 | 0 | Разрешение оплаты через Систему Быстрых Платежей (=1) |
...
| Expand | ||
|---|---|---|
| ||
В случае, когда предприятие заключило соответствующий договор и желает предоставить плательщику возможность оплатить часть своего товара/услуги бонусными баллами программы «Спасибо от Сбербанка», в авторизационном запросе необходимо передать параметр OrderMaxPoints, значение которого задает максимальное количество баллов, которое клиент сможет использовать при оплате. Если клиент будет оплачивать картой СберБанка, включенной в программу «Спасибо», и на его бонусном счету будут доступные к оплате баллы, то после ввода данных карты клиент получит предложение оплатить часть покупки баллами. Максимальная сумма, которой может воспользоваться клиент – это меньшая из двух сумм: OrderMaxPoints и остатка баллов на бонусном счету клиента. Плательщик сможет выбрать любую сумму баллов (с учетом ограничения) или оплатить всю покупку средствами с карты (без использования бонусных баллов). В зависимости от этого выбора в АПК Ассист будет создана одна (оплата только картой) или две (оплата картой и баллами) операции оплаты в заказе. Предприятие может также (после заключения соответствующих договоров и активации настроек в системе) работать в режиме, при котором клиентам начисляются бонусные баллы после успешной оплаты картой СберБанка, включенной в программу «Спасибо». Баллы начисляются вне зависимости от того, были использованы бонусные баллы при оплате или нет. При работе в этом режиме в заказе кроме операций оплаты будет создана операция начисления баллов. Все операции, созданные в рамках данного заказа (операции оплаты картой и баллами, операция начисления) можно увидеть в мониторинге заказов в Личном кабинете, а также в результатах запросов к веб-сервисам (например, orderresult). Обратите внимание, что подтверждение оплаты и отмена заказов с более чем одной успешной операцией оплаты имеют определенную специфику, описанную в соответствующих разделах руководства. |
| Anchor | ||||
|---|---|---|---|---|
|
Возврат покупателя на страницу интернет–магазина после покупки
После совершения платежа в системе АПК Ассист покупатель видит страницу с информацией о результате платежа (например, «Завершено успешно») и данными платежа, покупателя и предприятия.
...
| Tip | |||||
|---|---|---|---|---|---|
Имеется возможность передачи дополнительных произвольных параметров. в авторизационном запросе. Для этого необходимо передать перечень полей и их значения в том же порядке, как они были перечислены в параметре ListParameters . Пример
Дополнительные параметры, переданные таким образом, могут быть использованы на пользовательских платежных страницах предприятия (магазина). Для этого в шаблон необходимо добавить тэг с названием параметра, например,, <%Field1%> |