Page History

Versions Compared

Key

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

Table of Contents

1. Запрос на оплату картой

...

Список параметров авторизационного запроса

URL авторизационного запроса:

...

QIWITele2PaymentAndroidPayPayment

Название

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

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

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

Описание

Merchantmerchant_ID

Да

Число

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

OrderNumberorderNumber

Да

128 символов

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

Delaydelay

Нет

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

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

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

languageLanguage

Нет

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

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

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

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

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

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 или параметр отсутствует (и оплата по банковским картам доступна для предприятия)

YM Paymentympayment

Нет

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

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

WMPaymentsberPayPayment

Нет

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

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

fastPayPayment

Нет

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

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

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

QIWI Mts PaymentgooglePayPayment

Нет

1; 0

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

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

QIWI Megafon Payment

)

applePayPayment

Нет

1; 0

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

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

samsungPayPaymentQIWIBeelinePayment

Нет

1; 0

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

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

mirPayPayment

Нет

1; 0

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

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

signature

Нет*

Signature

Нет

строка

Формируется строка

, сшитая из следующих параметров заказа:Merchant_ID;OrderNumber;OrderAmount;OrderCurrency, разделенных точкой с запятой

по определенным правилам. На базе этой строки алгоритмом MD5 формируется дайджест.

Дайджест

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

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

checkvalue

Нет*

строка

Контрольный код.

Checkvalue

Нет

строка

Контрольный код.

Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х –

результат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency разделенных точкой с запятой, + -строковая склейка

строка, сформированная по определенным правилам.
Примечание. Если мерчант формирует контрольный код без разделителей, следует сообщить об этом в службу поддержки.

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

mobileDeviceMobileDevice

Нет

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

Вид платежных страниц (стандартные или для мобильных устройств). Если параметр не передан в запросе, используется настройка предприятия в системе (по умолчанию - стандартные страницы), для включения режима автоопределения устройства необходимо отправить письмо в службу поддержки 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

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

SamsungPayPayment

Нет

1; 0

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

...

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

...

OrderMaxPoints

...

Нет

...

Число, 15 цифр

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

...

/Да**

30 символов/12 цифр**

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

disable3DS

Нет

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 цифр

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

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

Multiexcerpt include

MultiExcerptName	Validation
PageWithExcerpt	Блоки документов

Note
Для фискализации платежа в запросе могут передаваться дополнительные параметры для формирования корректного чека. Описание дополнительных параметров приведено в разделе "Режимы передачи данных чека".

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

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

Пример кнопки, содержащей оптимальный набор параметров:

Code Block

language	xml

<FORM ACTION="https://<SERVER-NAME>/pay/order.cfm" METHOD="POST

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

Multiexcerpt include

MultiExcerptName	Validation
PageWithExcerpt	Блоки документов

В том случае, если более одного параметра, задающего тип платежного средства (CardPayment, WMPayment и т.п.), имеют значение 1, покупателю предоставляется возможность выбрать способ оплаты на платежной странице АПК Ассист. Если эти параметры не передаются, пользователь также сможет выбрать способ оплаты на платежной странице АПК Ассист из всех доступных для данного предприятия. Если все эти параметры имеют значение 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="LanguageMerchant_ID" VALUE="RUВаш Merchant_ID">
<INPUT TYPE="HIDDEN" NAME="EmailOrderNumber" VALUE="test@test.ruA20042011_28">
<INPUT TYPE="HIDDEN" NAME="OrderCommentOrderAmount" VALUE="Оплата заказа 28-A237.40">
<INPUT TYPE="HIDDEN" NAME="URL_RETURN_OKOrderCurrency" VALUE="http://www.URL.ru/yesUSD">
<INPUT TYPE="HIDDEN" NAME="URL_RETURN_NODelay" VALUE="http://www.URL.ru/no">"0">
<INPUT TYPE="HIDDEN" NAME="CardPaymentLanguage" VALUE="1RU">
<INPUT TYPE="HIDDEN" NAME="WMPaymentEmail" VALUE="0test@test.ru">
<INPUT TYPE="HIDDEN" NAME="YMPaymentOrderComment" VALUE="0Оплата заказа 28-A">
<INPUT TYPE="SUBMITHIDDEN" NAME="SubmitURL_RETURN_OK" VALUE="Купить">
</FORM>

После нажатия такой кнопки покупатель перенаправляется на авторизационные страницы АПК Ассист, где может ввести остальные персональные данные и осуществить оплату заказа с помощью банковской карты. Данные об имени, фамилии и адресе электронной почты покупателя являются обязательными (параметры Firstname, Lastname, Email) и должны быть либо переданы в авторизационном запросе, либо введены на платежной странице.

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="YMPayment" VALUE="0">
<INPUT TYPE="SUBMIT" NAME="Submit" VALUE="Купить">
</FORM>

Обращаем ваше внимание, что оригинальная сумма и Обращаем ваше внимание, что оригинальная сумма и код валюты, переданные предприятием в параметрах платежа при перенаправлении покупателя на авторизационные страницы АПК Ассист, могут отличаться от суммы и валюты авторизации. Сумма и валюта авторизации – это сумма и код валюты, которые были переданы в Процессинговый центр для авторизации банковской карты (обычно это сумма в рублях). Например, если оригинальная сумма платежа равна 100 USD (долларов США), то сумма авторизации, совершенной 06.06.2018, равна 6198,22 RUB (рублей).

...

Expand

title	Оплата баллами по программе «Спасибо» от Сбербанка

В случае, когда предприятие заключило соответствующий договор и желает предоставить плательщику возможность оплатить часть своего товара/услуги бонусными баллами программы «Спасибо от Сбербанка», в авторизационном запросе необходимо передать параметр OrderMaxPoints, значение которого задает максимальное количество баллов, которое клиент сможет использовать при оплате. Если клиент будет оплачивать картой СберБанка, включенной в программу «Спасибо», и на его бонусном счету будут доступные к оплате баллы, то после ввода данных карты клиент получит предложение оплатить часть покупки баллами. Максимальная сумма, которой может воспользоваться клиент – это меньшая из двух сумм: OrderMaxPoints и остатка баллов на бонусном счету клиента. Плательщик сможет выбрать любую сумму баллов (с учетом ограничения) или оплатить всю покупку средствами с карты (без использования бонусных баллов). В зависимости от этого выбора в АПК Ассист будет создана одна (оплата только картой) или две (оплата картой и баллами) операции оплаты в заказе.

Предприятие может также (после заключения соответствующих договоров и активации настроек в системе) работать в режиме, при котором клиентам начисляются бонусные баллы после успешной оплаты картой СберБанка, включенной в программу «Спасибо». Баллы начисляются вне зависимости от того, были использованы бонусные баллы при оплате или нет. При работе в этом режиме в заказе кроме операций оплаты будет создана операция начисления баллов.

Все операции, созданные в рамках данного заказа (операции оплаты картой и баллами, операция начисления) можно увидеть в мониторинге заказов в Личном кабинете, а также в результатах запросов к веб-сервисам (например, orderresult).

Обратите внимание, что подтверждение оплаты и отмена заказов с более чем одной успешной операцией оплаты имеют определенную специфику, описанную в соответствующих разделах руководства.

...

Anchor

	222
	222

Возврат покупателя на страницу интернет–магазина после покупки

После совершения платежа в системе АПК Ассист покупатель видит страницу с информацией о результате платежа (например, «Завершено успешно») и данными платежа, покупателя и предприятия.

Можно настроить также автоматическое перенаправление покупателя на сайт предприятия после завершения платежа в АПК Ассист. Для этого необходимо выбрать действие после авторизации «Перейти на страницу магазина» в Личном кабинете в разделе «Настройки мерчантов», вкладка «Настройки платежей». В случае удачной авторизации покупатель будет перенаправлен на адрес, указанный в параметре URL_RETURN_OK. Во всех остальных случаях он перенаправляется на адрес, указанный в параметре URL_RETURN или URL_RETURN_NO. При этом при авторизации по банковской карте к этим адресам добавляются параметры Billnumber – полный уникальный номер платежа в системе АПК Ассист и OrderNumber – номер заказа в системе расчетов предприятия, соответствующий данному платежу, в формате:

Code Block

language	xml

http://URL возврата/?billnumber=полный_уникальный_номер&ordernumber=номер_заказа

Параметры URL_RETURN_OK и URL_RETURN (или URL_RETURN_OK и URL_RETURN_NO) можно также передать в авторизационном запроса. Значения параметров URL_RETURN_OK и URL_RETURN, переданных в авторизационном запросе, являются приоритетными по отношению к значениям, введенным в Личном кабинете.

Note
Примечание. При возврате покупателя на сайт предприятия значение номера заказа всегда передается с использованием URL-кодирования, т.е. все не цифровые и не принадлежащие латинскому алфавиту символы (кроме ’-’ и ’_’.) заменяются на знак процентов ’%’ с последующими двумя 16-ричными цифрами кода символа, пробелы заменяются знаками ’+’. Это важно, если номер заказа содержит те или иные специальные символы.

Note

Примечание. При возврате покупателя на сайт предприятия значение номера заказа всегда передается с использованием URL-кодирования, т.е. все не цифровые и не принадлежащие латинскому алфавиту символы (кроме ’-’ и ’_’.) заменяются на знак процентов ’%’ с последующими двумя 16-ричными цифрами кода символа, пробелы заменяются знаками ’+’. Это важно, если номер заказа содержит те или иные специальные символы.

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

2. Запрос на оплату токеном

2.1. Оплата токеном в браузере на стороне магазина

При проведении оплаты токеном Google Pay в браузере на стороне магазина выполняются следующие действия:

Image Removed

Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку оплаты Google Pay (доступно в браузерах с поддержкой Payment Request API на мобильных устройствах).
После нажатия кнопки оплаты через Google Pay осуществляется вызов Payment Request API и передача сертификата с публичным ключом Ассист.
Открывается специальный диалог браузера, в котором можно выбрать одну из карт, привязанных в мобильном приложении Google Pay.
После выбора карты покупателю предлагается приложить палец к считывателю для подтверждения платежа.
Приложение Google Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его скрипту страницы магазина.
Зашифрованный пакет с токеном и данными платежа передается в сервис TokenPay АПК Ассист.
АПК Ассист расшифровывает пакет с токеном и данными платежа.
АПК Ассист проводит оплату токеном через процессинг расчётного банка.
АПК Ассист возвращает результаты проведения оплаты интернет-магазину.

При проведении оплаты токеном Apple Pay в браузере на стороне магазина выполняются следующие действия:

Image Removed

Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку оплаты Apple Pay (доступно только в браузере Safari на платформе MacOS).
После нажатия кнопки оплаты через Apple Pay осуществляется вызов Payment Request API и передача сертификата с публичным ключом мерчанта. Одновременно открывается специальный диалог, в котором можно будет выбрать одну из карт, привязанных в мобильном приложении Apple Pay.
После выбора карты покупателю направляется PUSH уведомление на iPhone и предлагается приложить палец к считывателю для подтверждения платежа.
Приложение Apple Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его скрипту страницы магазина.
Зашифрованный пакет с токеном и данными платежа передается в сервис TokenPay АПК Ассист.
АПК Ассист расшифровывает пакет с токеном и данными платежа.
АПК Ассист проводит оплату токеном через процессинг расчётного банка.
АПК Ассист возвращает результаты проведения оплаты интернет-магазину.

Для организации приема платежей токеном в браузере на стороне магазина нужно выполнить следующие подготовительные шаги:

сделать заявку для подключения платёжных средств для оплаты токенами (Apple Pay, Google Pay) в службу технической поддержки АПК Ассист support@assist.ru;
интегрировать в код своей страницы:
- для получения шифрованного пакета с токеном и данными платежа:
  - Payment Request API для Google Pay;
  - ApplePay JS API для Apple Pay;
- для проведения оплаты – обращение к сервису TokenPay;
получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для приёма платежей токенами при оплате товаров и услуг данному предприятию выполнены;
подготовиться к приему платежей:
при использовании Apple Pay создать и подписать сертификат Apple Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист;
при использовании Google Pay для организации схемы шифрования токена следует применять публичный ключ Public Key: 'BElVf3z1PE68riWbP0YRp4vC+0MuNbd6pqVAe1uHBHYGJvzZonlkVAp5CEEp2EEUswS7hS1y0RyNB3SR2FVExDQ=' и идентификатор мерчанта MerchantID:'16590966430175452581'.

...

2.2. Передача платежной информации TokenPay

Для передачи зашифрованного блока данных о платеже нужно отправить запрос на сервер АПК Ассист методом HTTP POST (в кодировке UTF-8).

URL запроса для передачи зашифрованного блока данных о платеже:

https://<SERVER_NAME>/pay/tokenpay.cfm ,

где <SERVER_NAME> - адрес сервера который предоставляется службой поддержки Ассист в процессе подключения.

Список параметров запроса:

...

Название

...

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

...

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

...

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

...

Описание

...

Да

...

Число

...

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

...

Login

...

Да

...

8 - 20 символов

...

Логин учетной записи в АПК Ассист (лат. буквы и цифры, символ _)

...

Да

...

8 - 20 символов

...

Пароль учетной записи в АПК Ассист (лат. буквы и цифры)

...

OrderNumber

...

Да

...

128 символов

...

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

...

OrderAmount

...

Да

...

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

...

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

...

OrderCurrency

...

Нет

...

3 символа

...

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

...

Код валюты, в которой указана сумма платежа OrderAmount

...

OrderComment

...

Нет

...

256 символов

...

Комментарий

...

Delay

...

Нет

...

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

1- двустадийный механизм

...

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

...

Language

...

Нет

...

RU - русский,

EN - английский

...

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

...

Язык квитанции об оплате

...

ClientIP

...

Нет

...

Максимум 15 цифр, 4 разделителя «.»

...

IP адрес покупателя

...

TokenType

...

Нет

...

1 – Apple Pay;

2 – Google Pay;

3 – Samsung Pay

...

Идентификатор типа платежного токена

...

PaymentToken

...

Нет

...

JSON

...

Платежный токен

...

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

...

Индекс предприятия связи покупателя

...

isConvert

...

Нет

...

0 - не конвертировать в базовую валюту;

1 - не конвертировать при возможности;

2 - всегда конвертировать

...

Флаг конвертации валюты платежа в базовую валюту

...

Format

...

Нет

...

4 – SOAP
5 – JSON

...

Формат выдачи результатов

...

Signature

...

Нет

...

строка

...

Формируется строка, сшитая из следующих параметров заказа:

Merchant_ID;OrderNumber;OrderAmount;OrderCurrency, разделенных точкой с запятой.

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

Ассист и OrderNumber – номер заказа в системе расчетов предприятия, соответствующий данному платежу, в формате:

Code Block

language	xml

http://URL возврата/?billnumber=полный_уникальный_номер&ordernumber=номер_заказа

Note
Примечание. При возврате покупателя на сайт предприятия значение номера заказа всегда передается с использованием URL-кодирования, т.е. все не цифровые и не принадлежащие латинскому алфавиту символы (кроме ’-’ и ’_’.) заменяются на знак процентов ’%’ с последующими двумя 16-ричными цифрами кода символа, пробелы заменяются знаками ’+’. Это важно, если номер заказа содержит те или иные специальные символы.

Note

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

Наверх

...

RecurringIndicator

...

Нет

...

1 –

рекуррентный платеж

0 - обычный платеж

...

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

...

RecurringMinAmount

...

Нет/Да

...

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

...

Минимальная сумма рекуррентных платежей.

Обязателен при RecurringIndicator = 1

...

RecurringMaxAmount

...

Нет/Да

...

Число, 15 цифр

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

...

Максимальная сумма рекуррентных платежей.

Обязателен при RecurringIndicator = 1

...

RecurringPeriod

...

Нет/Да

...

Число, 10 цифр

...

Периодичность рекуррентных платежей в днях.

Обязателен при RecurringIndicator = 1

...

RecurringMaxDate

...

Нет/Да

...

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

...

Дата окончания рекуррентных платежей.

Обязателен при RecurringIndicator = 1

...

Content

Space Tools

Versions Compared

Old Version 97

New Version 180

Key

1. Запрос на оплату картой

Список параметров авторизационного запроса

Возврат покупателя на страницу интернет–магазина после покупки

2. Запрос на оплату токеном

2.1. Оплата токеном в браузере на стороне магазина

2.2. Передача платежной информации TokenPay