Page History
| Table of Contents |
|---|
...
Список параметров авторизационного запроса
URL авторизационного запроса:
...
Название | Обяза- тельное поле | Принимаемые значения | Значение по умолчанию | Описание | ||||
|---|---|---|---|---|---|---|---|---|
Merchantmerchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |||||
OrderNumberorderNumber | Да | 128 символов | Номер заказа в системе расчетов предприятия. | |||||
Delaydelay | Нет | 0 – одностадийный механизм работы | 0 | Признак авторизации банковской карты при двустадийном механизме работы
| ||||
languageLanguage | Нет | RU - русский, | Язык юр.лица или предприятия | Язык авторизационных страниц | ||||
Order Comment orderComment | Нет | 256 4000 символов | Комментарий | |||||
OrderAmountorderAmount | Да | Число, 15 цифр (разделитель знаков, два знака после разделителя (допустимые разделители «.», «,») | Сумма платежа в оригинальной валюте (например, 10.34) | |||||
OrderCurrencyorderCurrency | Нет | 3 символа | Валюта юр.лица или предприятия | Код валюты, в которой указана сумма платежа OrderAmount (Коды валют см. в Таблице кодов кодов валют ) | ||||
Lastnamelastname | Нет | 70 символов | Фамилия покупателя | |||||
Firstnamefirstname | Нет | 70 символов | Имя покупателя | |||||
Middlenamemiddlename | Нет | 70 символов | Отчество покупателя | |||||
Emailemail | Нет | 128 символасимволов | E-mail покупателя | |||||
Addressaddress | Нет | 256 символов | Адрес покупателя | |||||
HomePhonehomePhone | Нет | 64 символа | Домашний телефон покупателя | |||||
WorkPhoneworkPhone | Нет | 20 символов | Рабочий телефон покупателя | |||||
MobilePhonemobilePhone | Нет | 20 символов | Мобильный телефон покупателя | Fax | Нет | 20 символов | Факс покупателя | |
country | Country | Нет | 3 символа | Код страны покупателя | ||||
Statestate | Нет | 3 символа | Код региона покупателя | |||||
Citycity | Нет | 70 символов | Город покупателя | |||||
Zipzip | Нет | 25 символов | Индекс предприятия связи покупателя | |||||
URLurl_RETURN | Нет | 255 символов | URL страницы, на которую должен вернуться покупатель после осуществления платежа в системе (должна быть активирована опция «Перейти на страницу магазина» в настройках мерчанта в Личном кабинете). В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. | |||||
URLurl_RETURN_OK OK | Нет | 255 символов | Значение параметра URL_RETURN, а при его отсутствии – URL для возврата при успешной авторизации, указанный в Личном кабинете | URL страницы, куда должен вернуться покупатель после успешного осуществления платежа в системе АПК Ассист (должна быть активирована опция «Перейти на страницу магазина» в настройках мерчанта в Личном кабинете). В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. | ||||
URLurl_RETURN_NO NO | Нет | 255 символов | Значение параметра URL_RETURN, а при его отсутствии – URL для возврата, указанный в Личном кабинете | URL страницы, куда должен вернуться покупатель после неуспешного осуществления платежа в системе АПК Ассист или при отсутствии ответа об окончательном статусе платежа (текущий статус "В процессе"), подробнее см."Возврат покупателя на страницу интернет-магазина после покупки". Должна быть активирована опция «Возвращаться в магазин по URL для возврата» в Личном кабинете. В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. | ||||
CardPaymentcardPayment | Нет | 1 – использовать оплату по банковской карте, | 1 | Покупатель сможет сделать платеж с помощью банковской карты, если передано значение параметра 1 или параметр отсутствует (и оплата по банковским картам доступна для предприятия) | ||||
YM Paymentympayment | Нет | 1 – использовать платежную систему YandexMoney, | 1 | Покупатель сможет сделать платеж с помощью платежной системы YandexMoney, если передано значение параметра 1 или параметр отсутствует (и оплата по YandexMoney доступна для предприятия) | ||||
WMPaymentsberPayPayment | Нет | 1 – использовать платежную систему WebMoneySberPay, | 1 | Покупатель сможет сделать платеж с помощью всех средств оплаты платежной системы WebMoneySberPay, если передано значение параметра 1 или параметр отсутствует (и оплата по WebMoney SberPay доступна для предприятия)QIWIPayment | ||||
| fastPayPayment | Нет | 1 – использовать платежную систему QIWI, ; 0 | 0 – не использовать1 | Покупатель сможет сделать платеж с помощью всех средств оплаты платежной системы QIWIСистемы Быстрых Платежей, если передано значение параметра 1 или параметр отсутствует (и оплата по QIWI СБП доступна для предприятия). | ||||
| QIWI Mts PaymentgooglePayPayment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор МТС) | 0 | Признак оплаты через Google Pay (=1) | ||
| applePayPaymentQIWI Megafon Payment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор Мегафон) | 0 | Признак оплаты через Apple Pay (=1) | ||
| samsungPayPaymentQIWIBeelinePayment | Нет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор БиЛайн) | 0 | Признак оплаты через Samsung Pay (=1) | ||
| mirPayPayment | QIWITele2PaymentНет | 1; 0 | 1 | Оплата с помощью средств на счету мобильного телефона (оператор Tele2) | 0 | Признак оплаты через Mir Pay (=1) | ||
signature | Нет* | Signature | Нет | строка | Формируется строка по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64 .
| |||
checkvalue | Нет* | Checkvalue | Нет | строка | Контрольный код. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правилам.
| |||
mobileDeviceMobileDevice | Нет | 0 – использовать настройки мерчанта; | Вид платежных страниц (стандартные или для мобильных устройств). Если параметр не передан в запросе, используется настройка предприятия в системе (по умолчанию - стандартные страницы), для включения режима автоопределения устройства необходимо отправить письмо в службу поддержки support@assist.ru | |||||
RecurringIndicatorrecurringIndicator | Нет | 1 – рекуррентный платеж | 0 | Признак рекуррентного платежа | ||||
RecurringMinAmountrecurringMinAmount | Нет/Да | Число, 15 цифр (разделитель знаков, два знака после разделителя (допустимые разделители «.», «,») | Минимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1 | |||||
RecurringMaxAmountrecurringMaxAmount | Нет/Да | Число, 15 цифр | Максимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1 | |||||
RecurringPeriodrecurringPeriod | Нет/Да | Число, 10 цифр3 цифры | Периодичность рекуррентных платежей в днях.Обязателен при RecurringIndicator = 1 | |||||
RecurringMaxDaterecurringMaxDate | Нет/Да | Строковое представление даты в формате DD.MM.YYYY | Дата окончания рекуррентных платежей. Обязателен при RecurringIndicator = 1 | |||||
account | Нет | 1; 0 | 0 | Признак оплаты через GooglePay (=1) | ||||
| ApplePayPayment | Нет | 1; 0 | 0 | Признак оплаты через ApplePay (=1) | SamsungPayPayment | Нет | 1; 0 | 0 | Признак оплаты через SamsungPay (=1)
/Да** | 30 символов/12 цифр** | Номер договора или лицевого счета покупателя | ||||||
| disable3DS | Нет | 0 – проверять 3-D Secure согласно настройкам предприятия, 1 – проводить платеж без 3-D Secure. | 0 | Признак отключения 3-D Secure.
| ||||
| challengeResponseNotificationUrl | Нет | 255 символов | URL, на который отправляется результат прохождения 3ds и перенаправляется покупатель после Challenge. |
*Для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками, необходимо передать один из параметров (Signature или Checkvalue), также должна быть включена настройка проверки контрольного кода (или подписи) в ЛК.
**Для предприятий с mcc 4814 (Телекоммуникационные услуги) в параметре необходимо передать номер оплачиваемого телефона.
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
| Multiexcerpt include | ||||
|---|---|---|---|---|
|
| Note |
|---|
Для фискализации платежа в запросе могут передаваться дополнительные параметры для формирования корректного чека. Описание дополнительных параметров приведено в разделе "Режимы передачи данных чека". |
В том случае, если более одного параметра, задающего тип платежного средства (CardPayment, WMPayment QR code и т.п.), имеют значение 1, покупателю предоставляется возможность выбрать способ оплаты на платежной странице АПК Ассист. Если эти параметры не передаются, пользователь также сможет выбрать способ оплаты на платежной странице АПК Ассист из всех доступных для данного предприятия. Если все эти параметры имеют значение 0, это приводит к ошибке.
Информация об использовании протокола 3-D Secure 2.0при создании платежа.
Пример кнопки, содержащей оптимальный набор параметров:
| Code Block | ||
|---|---|---|
| ||
<FORM ACTION="https://<SERVER-NAME>/pay/order.cfm" METHOD="POST">
<INPUT TYPE="HIDDEN" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="HIDDEN" NAME="OrderNumber" VALUE="A20042011_28">
<INPUT TYPE="HIDDEN" NAME="OrderAmount" VALUE="237.40">
<INPUT TYPE="HIDDEN" NAME="OrderCurrency" VALUE="USD">
<INPUT TYPE="HIDDEN" NAME="Delay" VALUE="0">
<INPUT TYPE="HIDDEN" NAME="Language" VALUE="RU">
<INPUT TYPE="HIDDEN" NAME="Email" VALUE="test@test.ru">
<INPUT TYPE="HIDDEN" NAME="OrderComment" VALUE="Оплата заказа 28-A">
<INPUT TYPE="HIDDEN" NAME="URL_RETURN_OK" VALUE="http://www.URL.ru/yes">
<INPUT TYPE="HIDDEN" NAME="URL_RETURN_NO" VALUE="http://www.URL.ru/no">
<INPUT TYPE="HIDDEN" NAME="CardPayment" VALUE="1">
<INPUT TYPE="HIDDEN" NAME="WMPayment" VALUE="0">
<INPUT TYPE="HIDDEN" NAME="YMPayment" VALUE="0">
<INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Купить">
</FORM>
|
...
| Expand | ||
|---|---|---|
| ||
В случае, когда предприятие заключило соответствующий договор и желает предоставить плательщику возможность оплатить часть своего товара/услуги бонусными баллами программы «Спасибо от Сбербанка», в авторизационном запросе необходимо передать параметр OrderMaxPoints, значение которого задает максимальное количество баллов, которое клиент сможет использовать при оплате. Если клиент будет оплачивать картой СберБанка, включенной в программу «Спасибо», и на его бонусном счету будут доступные к оплате баллы, то после ввода данных карты клиент получит предложение оплатить часть покупки баллами. Максимальная сумма, которой может воспользоваться клиент – это меньшая из двух сумм: OrderMaxPoints и остатка баллов на бонусном счету клиента. Плательщик сможет выбрать любую сумму баллов (с учетом ограничения) или оплатить всю покупку средствами с карты (без использования бонусных баллов). В зависимости от этого выбора в АПК Ассист будет создана одна (оплата только картой) или две (оплата картой и баллами) операции оплаты в заказе. Предприятие может также (после заключения соответствующих договоров и активации настроек в системе) работать в режиме, при котором клиентам начисляются бонусные баллы после успешной оплаты картой СберБанка, включенной в программу «Спасибо». Баллы начисляются вне зависимости от того, были использованы бонусные баллы при оплате или нет. При работе в этом режиме в заказе кроме операций оплаты будет создана операция начисления баллов. Все операции, созданные в рамках данного заказа (операции оплаты картой и баллами, операция начисления) можно увидеть в мониторинге заказов в Личном кабинете, а также в результатах запросов к веб-сервисам (например, orderresult). Обратите внимание, что подтверждение оплаты и отмена заказов с более чем одной успешной операцией оплаты имеют определенную специфику, описанную в соответствующих разделах руководства. |
...
| Anchor | ||||
|---|---|---|---|---|
|
Возврат покупателя на страницу интернет–магазина после покупки
После совершения платежа в системе АПК Ассист покупатель видит страницу с информацией о результате платежа (например, «Завершено успешно») и данными платежа, покупателя и предприятия.
...
Если используется опция возврата покупателя в магазин, рекомендуется после получения данных об успешно оплаченном заказе на URL_RETURN_OK дополнительно сделать запрос о результате авторизации на сервер АПК Ассист (о запросе результатов авторизации подробнее см. п.2.3.3) для того чтобы убедиться, что данный заказ действительно оплачен. Также рекомендуется запрашивать результат авторизации при переходе и по адресам URL_RETURN и URL_RETURN_NO, поскольку такой переход выполняется при различных статусах платежа, в том числе и при статусе «В процессе».