Для оплаты с помощью токена нужно отправить запрос на сервер АПК Ассист в формате JSON (swagger описание: https://docs.assist.ru/swagger/).
URL запроса для передачи платежного токена
https://<SERVER_NAME>/pay/tokenpay.cfm ,
где <SERVER_NAME> - адрес сервера который предоставляется службой поддержки Assist в процессе подключения.
Список параметров запроса:
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание | |
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | ||
Login | Да | 8 - 20 символов | Логин учетной записи в АПК Ассист (лат. буквы и цифры, символ _) | ||
Password | Да | 8 - 20 символов | Пароль учетной записи в АПК Ассист (лат. буквы и цифры) | ||
OrderNumber | Да | 128 символов | Номер заказа в системе расчетов предприятия. | ||
OrderAmount | Да | Число, 15 цифр (разделители «.», «,») | Сумма платежа в оригинальной валюте (например, 10.34) | ||
OrderCurrency | Нет | 3 символа | Валюта юр.лица или предприятия | Код валюты, в которой указана сумма платежа OrderAmount | |
OrderComment | Нет | 256 символов | Комментарий | ||
Delay | Нет | 0 – одностадийный механизм работы 1- двустадийный механизм | 0 | Признак авторизации кредитной карты при двустадийном механизме работы | |
Language | Нет | RU - русский, EN - английский | Язык юр.лица или предприятия | Язык квитанции об оплате | |
ClientIP | Нет | Максимум 15 цифр, 4 разделителя «.» | IP адрес покупателя | ||
TokenType | Нет | 1 – Apple Pay; | 1 | Идентификатор типа платежного токена.
| |
PaymentToken | Нет | JSON | Для типов 1-3 - платежный токен провайдера (Apple Pay, Samsung Pay) Для платежного токена Assist (тип 5) - {"Token":"<UUID>", "CustomerNumber":"<CustomerNumber>"} | ||
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 символов | Индекс предприятия связи покупателя | ||
isConvert | Нет | 0 - не конвертировать в базовую валюту; 1 - не конвертировать при возможности; 2 - всегда конвертировать | 1 | Флаг конвертации валюты платежа в базовую валюту | |
Format | Нет | 4 – SOAP | 5 | Формат выдачи результатов | |
Signature | Нет | строка | Формируется строка, сшитая из следующих параметров заказа: Merchant_ID;OrderNumber;OrderAmount;OrderCurrency, разделенных точкой с запятой. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64 | ||
RecurringIndicator | Нет | 1 – рекуррентный платеж 0 - обычный платеж | 0 | Признак рекуррентного платежа | |
RecurringMinAmount | Нет/Да | Число, 15 цифр (разделители «.», «,») | Минимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1 | ||
RecurringMaxAmount | Нет/Да | Число, 15 цифр (разделители «.», «,») | Максимальная сумма рекуррентных платежей. Обязателен при RecurringIndicator = 1 | ||
RecurringPeriod | Нет/Да | Число, 10 цифр | Периодичность рекуррентных платежей в днях. Обязателен при RecurringIndicator = 1 | ||
RecurringMaxDate | Нет/Да | Строковое представление даты в формате DD.MM.YYYY | Дата окончания рекуррентных платежей. Обязателен при RecurringIndicator = 1 |
Список параметров ответа:
Название | Значение |
Параметры заказа | |
ordernumber | Номер заказа |
billnumber | Уникальный номер заказа в системе АПК Ассист |
testmode | Тестовый режим |
ordercomment | Комментарий |
orderamount | Оригинальная сумма заказа |
ordercurrency | Оригинальная валюта заказа |
firstname | Имя плательщика |
lastname | Фамилия плательщика |
middlename | Отчество плательщика |
Email плательщика | |
orderdate | Дата заказа по Гринвичу (GMT) |
orderstate | Статус заказа |
packetdate | Дата формирования запроса по Гринвичу (GMT) |
signature |
|
checkvalue | uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency, orderstate (без разделителей), + -строковая склейка |
Параметры операции | |
billnumber | Расширенный формат billnumber |
operationtype | Тип операции |
operationstate | Состояние операции |
amount | Сумма операции |
currency | Валюта операции |
ipaddress | IP-адрес плательщика |
clientip | IP-адрес совершившего операцию |
meantype_id | ID платежного средства |
meantypename | Тип платежного средства |
meansubtype | Подтип платежного средства |
meannumber | Номер платежного средства |
cardholder | Держатель платежного средства |
issuebank | Название банка-эмитента |
bankcountry | Страна банка-эмитента |
responsecode | Код возврата |
message | Сообщение о результате операции |
customermessage | Сообщение о результате для покупателя |
recommendation | Рекомендация |
approvalcode | Код авторизации |
protocoltypename | Протокол |
processingname | Процессинг |
operationdate | Дата и время операции (GMT) |
authresult | Результат авторизации по 3D-Secure (Y - успешно, N - неуспешно, A - Attempt, U – неизвестно) |
authrequired | Результат проверки вовлеченности карты (1 – вовлечена, 0 – не вовлечена, -1 – неизвестно, null – ошибка при определении вовлеченности) |
slipno | Номер финансовой транзакции, отправляемый в процессинг |
| firstcode* | Первый код ошибки |
| secondcode* | Второй код ошибки |
| continueurl* | Адрес перехода на страницу аутентификации для покупателя |