Versions Compared

Key

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

...

Список параметров полностью соответствует списку параметров авторизационного запроса.

Список параметров запроса (только основные параметры, а также наиболее часто используемые): 

...

Название

...

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

...

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

...

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

...

Описание

...

Да

...

Число

...

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

...

OrderNumber

...

Да

...

128 символов

...

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

...

Delay

...

Нет

...

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

...

0

...

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

...

Language

...

Нет

...

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

...

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

...

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

...

Order Comment

...

Нет

...

256 символов

...

Комментарий

...

OrderAmount

...

Да

...

Число, 15 цифр (разделитель «.»)

...

Сумма платежа в оригинальной валюте (например, 10.34)

...

OrderCurrency

...

Нет

...

3 символа

...

Валюта юр.лица или предприятия

...

Код валюты, в которой указана сумма платежа OrderAmount (Коды валют см. в  Таблице кодов валют)

...

Lastname

...

Нет

...

70 символов

...

Фамилия покупателя

...

Firstname

...

Нет

...

70 символов

...

Имя покупателя

...

Middlename

...

Нет

...

70 символов

...

Отчество покупателя

...

Email

...

Нет

...

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

...

1

...

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

...

Signature

...

Нет

...

строка

...

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

В ответе передается пакет данных в формате JSON, который содержит следующие параметры:

Section
Column
width20%

url

expirationtime

orderstate

Column
width80%

полный url для переадресации плательщика или подстановки в адрес iFrame

время, отведенное на оплату (time out)

состояние запроса на создание заказа в АПК Ассист (In Process или Decline)

Пример ответа при успешном создании заказа:

Code Block
languagexml
{"url": "https://payments.paysecure.ru/pay/pay.cfm?CFSID=MCRdVzAjKDM3Ai0nXVVKSCRbXl8pVyAgIAo%3D&stage=iframe", "expirationtime":"07.07.2018 16:37:53", "orderstate": "In Process"}

При успешном создании заказа всегда возвращается значение состояния заказа  "In Process" и только при получении такого статуса можно использовать возвращенный сервисом URL для переадресации плательщика или подстановки в адрес iFrame.

Пример ответа при ошибке:

Code Block
languagexml
{"URL":"", "expirationtime":"07.07.2018 13:37:53", 'orderstate": "Decline"}

Наверх

...

Checkvalue

...

Нет

...

строка

...

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

...

MobileDevice

...

Нет

...

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

...

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

...