Page History
...
- сделать заявку для подключения платёжных средств для оплаты токенами (Apple Pay, Google Pay) в службу технической поддержки АПК Ассист support@assist.ru;
- интегрировать в код своей страницы:
- для получения шифрованного пакета с токеном и данными платежа:
- Payment Request API для Google Pay;
- ApplePay JS API для Apple Pay;
- для проведения оплаты – обращение к сервису TokenPay;
- для получения шифрованного пакета с токеном и данными платежа:
- получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для приёма платежей токенами при оплате товаров и услуг данному предприятию выполнены;
- подготовиться к приему платежей:
- при использовании Apple Pay создать и подписать сертификат Apple Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист;
- при использовании Google Pay необходимо зарегистрироваться в Google Pay API, получить уникальный идентификатор для использования в качестве параметра MerchantID, установить значение «assist» для параметра gateway и указать allowedCardAuthMethods = ["CRYPTOGRAM_3DS"] для организации схемы шифрования пакета данных с токеном или allowedCardAuthMethods = ["PAN_ONLY", "CRYPTOGRAM_3DS"], если необходимо также принимать платежи сохраненными в учетной записи Google нетокенизированными картами.
...
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
...
Order Comment
...
Нет
...
256 символов
...
Комментарий
...
Delay
...
Нет
...
0 – одностадийный механизм работы
1- двустадийный механизм
...
0
...
Признак авторизации кредитной карты при двустадийном механизме работы
...
Language
...
Нет
...
RU - русский,
EN - английский
...
Язык юр.лица или предприятия
...
Язык квитанции об оплате
...
ClientIP
...
Нет
...
Максимум 15 цифр, 4 разделителя «.»
...
IP адрес покупателя
...
TokenType
...
Нет
...
1 – Apple Pay;
2 – Google Pay;
3 – Samsung Pay
...
1
...
Идентификатор типа платежного токена
...
PaymentToken
...
Нет
...
JSON
...
Платежный токен
...
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 – JSON
...
5
...
Формат выдачи результатов
...
Signature
...
Нет
...
строка
...
Формируется строка по определенным правилам.
На базе этой строки алгоритмом 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
...
- для типа подписи MD5 – пусто;
- · для типа PGP – значение X, подписанное закрытым ключом АПК Ассист, закодированное в BASE64.
...
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
...
Результат аворизации по 3DSecure (Y - успешно, N - неуспешно, A - Attempt, U – неизвестно)
...
authrequired
...
Результат проверки вовлеченности карты (1 – вовлечена, 0 – не вовлечена, -1 – неизвестно, null – ошибка при определении вовлеченности)
...
slipno
...
Номер финансовой транзакции, отправляемый в процессинг
...
*Параметры выдаются только в случае проведения оплаты нетокенизированной картой для операций ECOM с переадресацией покупателя на страницу ввода CVC2 и, если необходимо, дополнительной аутентификацией 3DSecure. В этом случае параметры firstcode и secondcode принимают значения «3» и «115» соответственно.
| Warning |
|---|
Внимание! В рамках одного заказа может быть проведено несколько операций (оплаты, подтверждения оплаты, отмены). Более того, в рамках одного заказа может быть несколько операций оплаты, если некоторые из них были неуспешными. Успешная операция оплаты заказа может быть только одна. В этих случаях в ответе на запрос о результатах операций по номеру заказа может быть несколько вложенных операций для одного номера заказа. |
| Warning |
|---|
Внимание! В полученном ответе необходимо проверить значение параметра testmode. Если платеж был выполнен в тестовом режиме (testmode=1), то отгружать товар или оказывать услугу по текущему заказу не требуется. |
Пример результата запроса в формате JSON при оплате токенизированной картой:
| Code Block | ||
|---|---|---|
| ||
{"order":
{
"ordernumber":"26012015_4"
,"billnumber":"5899110210668265"
,"testmode":"0"
,"ordercomment":"тестовый платеж"
,"orderamount":"24.00"
,"ordercurrency":"RUB"
,"firstname":""
,"lastname":""
,"middlename":""
,"email":""
,"orderdate":"26.01.2015 17:25:39"
,"orderstate":"In Process"
,"fraud_state":""
,"fraud_reason":""
,"checkvalue":"85C6C974AADC1CADFCFD195730ED090B"
,"operations":[
{"billnumber":"5899110210668265.1"
,"operationtype":"100"
,"operationstate":"In Process"
,"amount":"24.00"
,"currency":"RUB"
,"clientip":"10.20.10.85"
,"ipaddress":"0.0.0.0"
,"meantype_id":"61"
,"meantypename":"SamsungPay"
,"meansubtype":""
,"meannumber":""
,"cardholder":""
,"issuebank":"UNKNOWN"
,"bankcountry":"UNKNOWN"
,"responsecode":"AS200"
,"message":""
,"customermessage":""
,"recommendation":""
,"approvalcode":""
,"protocoltypename":"NET"
,"processingname":""
,"operationdate":"26.01.2015 17:25:39"
,"authresult":""
,"authrequired":""
,"slipno":""}
]
}
,"packetdate":"26.01.2015 18:16:19"
} |
Пример результата запроса в формате JSON при оплате нетокенизированной картой:
| Code Block | ||
|---|---|---|
| ||
{"order":
{
"ordernumber":"2019.07.01-1226",
"billnumber":"516009019047110",
"testmode":"0",
"ordercomment":"Test 4 mode",
"orderamount":"101.45",
"ordercurrency":"RUB",
"firstname":"",
"lastname":"",
"middlename":"",
"email":"",
"orderdate":"01.07.2019 15:31:16",
"orderstate":"In Process",
"fraud_state":""
"fraud_reason":""
"checkvalue":"85C6C974AADC1CADFCFD195730ED090B"
"operations":[
{"billnumber":"516009019047110.1",
"operationtype":"100",
"operationstate":"New",
"amount":"101.45",
"currency":"RUB",
"clientip":"10.20.10.66",
"ipaddress":"127.0.0.1",
"meantype_id":"1",
"meantypename":"VISA",
"meansubtype":"Classic",
"meannumber":"411111****1111",
"cardholder":"N/A",
"cardexpirationdate":"12/24",
"issuebank":"New Assist Bank",
"bankcountry":"Россия",
"responsecode":"AS300",
"message":"",
"customermessage":"", "
"recommendation":"",
"approvalcode":"",
"protocoltypename":"NET",
"processingname":"UCS",
"operationdate":"01.07.2019 15:31:18",
"authresult":"",
"authrequired":"",
"slipno":""}
]
}
"packetdate":"26.01.2015 18:16:19",
"firstcode":"3",
"secondcode":"115",
"continueurl":"https://<SERVER_NAME>/pay/pay.cfm?CFSID=LiRNMzMiSFc3Wy0nWFdaQCJYTiQgCg%3D%3D"
} |
Дополнительно можно ознакомиться с вариантами организации платежей токенами с использованием разных провайдеров.
...