Page History

Versions Compared

Key

This line was added.
This line was removed.
Formatting was changed.

...

Название

Обяза- тельное поле

Принимаемые значения

Значение по умолчанию

Описание

Merchantmerchant_ID

Да

Число

Идентификатор предприятия в системе АПК Ассист

OrderNumberorderNumber

Да

128 символов

Номер заказа в системе расчетов предприятия.

Delaydelay

Нет

0 – одностадийный механизм работы
1- двустадийный механизм

Признак авторизации банковской карты при двустадийном механизме работы

Note
При желании использовать двустадийный режим работы сначала следует проконсультироваться с сотрудниками службы поддержки (support@assist.ru).

languageLanguage

Нет

RU - русский,
EN - английский

Язык юр.лица или предприятия

Язык авторизационных страниц

OrderComment orderComment

Нет

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 символов

Мобильный телефон покупателя

Faxcountry

Нет

20 символов

Факс покупателя

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 – использовать оплату по банковской карте,
0 – не использовать

Покупатель сможет сделать платеж с помощью банковской карты, если передано значение параметра 1 или параметр отсутствует (и оплата по банковским картам доступна для предприятия)

YMPaymentympayment

Нет

1 – использовать платежную систему YandexMoney,
0 – не использовать

Покупатель сможет сделать платеж с помощью платежной системы YandexMoney, если передано значение параметра 1 или параметр отсутствует (и оплата по YandexMoney доступна для предприятия)

WMPaymentsberPayPayment

Нет

1 – использовать платежную систему WebMoneySberPay,
0 – не использовать

Покупатель сможет сделать платеж с помощью всех средств оплаты платежной системы WebMoneySberPay, если передано значение параметра 1 или параметр отсутствует (и оплата по WebMoney SberPay доступна для предприятия)QIWIPayment

fastPayPayment

Нет

1 – использовать платежную систему QIWI, ; 0

0 – не использовать1

Покупатель сможет сделать платеж с помощью всех средств оплаты платежной системы QIWIСистемы Быстрых Платежей, если передано значение параметра 1 или параметр отсутствует (и оплата по QIWI СБП доступна для предприятия).

QIWIMtsPaymentgooglePayPayment

Нет

1; 01

Оплата с помощью средств на счету мобильного телефона (оператор МТС)

QIWIMegafonPayment

Нет

1; 0

Оплата с помощью средств на счету мобильного телефона (оператор Мегафон)

QIWIBeelinePayment

Нет

1; 0

Оплата с помощью средств на счету мобильного телефона (оператор БиЛайн)

QIWITele2Payment

Нет

1; 0

Оплата с помощью средств на счету мобильного телефона (оператор Tele2)

FastPayPayment

Нет

1; 0

Покупатель сможет сделать платеж с помощью Системы Быстрых Платежей, если передано значение параметра 1 и оплата по СБП доступна для предприятия.

Признак оплаты через Google Pay (=1)

applePayPaymentGooglePayPayment

Нет

1; 0

Признак оплаты через GooglePay Apple Pay (=1)

ApplePayPaymentsamsungPayPayment

Нет

1; 0

Признак оплаты через ApplePay Samsung Pay (=1)

SamsungPayPaymentmirPayPayment

Нет

1; 0

Признак оплаты через SamsungPay Mir Pay (=1)

Signaturesignature

Нет*

строка

Формируется строка по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64.

Warning
Внимание! Параметр необходим для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками. Следует также включить настройку проверки кода или подписи в ЛК.

Checkvaluecheckvalue

Нет*

строка

Контрольный код. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – строка, сформированная по определенным правилам.
Примечание. Если мерчант формирует контрольный код без разделителей, следует сообщить об этом в службу поддержки.

Warning
Внимание! Параметр необходим для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками. Следует также включить настройку проверки кода или подписи в ЛК.

MobileDevicemobileDevice

Нет

0 – использовать настройки мерчанта;
1 – стандартные страницы;
2 – страницы для мобильных устройств

Вид платежных страниц (стандартные или для мобильных устройств). Если параметр не передан в запросе, используется настройка предприятия в системе (по умолчанию - стандартные страницы), для включения режима автоопределения устройства необходимо отправить письмо в службу поддержки support@assist.ru

RecurringIndicatorrecurringIndicator

Нет

1 – рекуррентный платеж
0 - нерекуррентный платеж

Признак рекуррентного платежа

RecurringMinAmountrecurringMinAmount

Нет/Да

Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,»)

Минимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1

RecurringMaxAmountrecurringMaxAmount

Нет/Да

Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,»)

Максимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1

RecurringPeriodrecurringPeriod

Нет/Да

Число, 3 цифры

Периодичность рекуррентных платежей в днях.Обязателен при RecurringIndicator = 1

RecurringMaxDaterecurringMaxDate

Нет/Да

Строковое представление даты в формате DD.MM.YYYY

Дата окончания рекуррентных платежей. Обязателен при RecurringIndicator = 1

Accountaccount

Нет/Да**

30 символов

Идентификатор получателя денежных средств (номер оплачиваемого телефона)

/12 цифр**

Номер договора или лицевого счета покупателя

disable3DSDisable3DS

Нет

0 – проверять 3-D Secure согласно настройкам предприятия,
1 – проводить платеж без 3-D Secure.

Признак отключения 3-D Secure.

Note
Использование такого режима работы возможно по согласованию с Assist. Для настройки необходимо обратиться в службу технической поддержки support@assist.ru

Warning
При использовании параметра его необходимо добавлять и в подпись заказа, которая формируется по определенным правилам.

challengeResponseNotificationUrl

Нет

255 символов

URL, на который отправляется результат прохождения 3ds и перенаправляется покупатель после Challenge.

*Для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками, необходимо передать один из параметров (Signature или Checkvalue), также должна быть включена настройка проверки контрольного кода (или подписи) в ЛК.

**Для предприятий с mcc 4814 (Телекоммуникационные услуги) в параметре необходимо передать номер оплачиваемого телефона.

Expand

title	При работе с бонусными баллами необходимо передавать дополнительный параметр

OrderMaxPoints

Нет

Число, 15 цифр

(разделитель «.»)

Максимальная сумма, которую можно оплатить баллами «Спасибо»

...

В том случае, если более одного параметра, задающего тип платежного средства (CardPayment, WMPayment QR code и т.п.), имеют значение 1, покупателю предоставляется возможность выбрать способ оплаты на платежной странице АПК Ассист. Если эти параметры не передаются, пользователь также сможет выбрать способ оплаты на платежной странице АПК Ассист из всех доступных для данного предприятия. Если все эти параметры имеют значение 0, это приводит к ошибке.

Информация об использовании протокола 3-D Secure 2.0при создании платежа.

...

Code Block

language	xml

<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>

...

Если используется опция возврата покупателя в магазин, рекомендуется после получения данных об успешно оплаченном заказе на URL_RETURN_OK дополнительно сделать запрос о результате авторизации на сервер АПК Ассист (о запросе результатов авторизации подробнее) для того чтобы убедиться, что данный заказ действительно оплачен. Также рекомендуется запрашивать результат авторизации при переходе и по адресам URL_RETURN и URL_RETURN_NO, поскольку такой переход выполняется при различных статусах платежа, в том числе и при статусе «В процессе».

...

Имеется возможность передачи дополнительных произвольных параметров в авторизационном запросе.

Для этого необходимо передать перечень полей и их значения в том же порядке, как они были перечислены в параметре ListParameters.

Пример

Code Block

language	xml

ListParameters="Field1,Field2"
Field1="42"
Field2="room"

...

Наверх

Content

Space Tools

Versions Compared

Old Version 155

New Version 180

Key