Cкрытый режим платежа, при котором все данные о заказе, о покупателе, о способе оплаты и платежном средстве передаются непосредственно предприятием, может быть выполнен с использованием карты или токена.
Для работы в данном режиме предусмотрен web-сервис silentpay.
URL запроса для скрытого режима оплаты:
https://<SERVER-NAME>/pay/silentpay.cfm
Параметры передаются методом POST в теле запроса в формате «ключ=значение», SOAP запросом, либо в формате JSON (swagger описание: https://docs.assist.ru/swagger/).
Список параметров, передаваемых в режиме silentpay:
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание | |
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | ||
Login | Да | Строка | Ваш логин | ||
Password | Да | Строка | Ваш пароль | ||
OrderNumber | Да/Нет | 128 символов | Номер заказа в системе расчетов предприятия. | ||
OrderAmount | Да | Число, 15 цифр (разделители «.», «,») | Сумма платежа в оригинальной валюте (например, 10.34) | ||
OrderCurrency | Нет | 3 символа | Валюта юр.лица или предприятия | Код валюты, в которой указана сумма платежа OrderAmount (RUB, USD, EUR) | |
OrderComment | Нет | 256 символов | Комментарий | ||
Delay | Нет | 0 – одностадийный механизм работы, | 0 | Признак авторизации банковской карты при двустадийном механизме работы | |
Language | Нет | RU – русский | Язык юр.лица или предприятия | Язык авторизационных страниц | |
ClientIP | Нет | IP адрес покупателя | |||
Cardtype | Нет | 1 – VISA | Идентификатор типа карты для оплаты. | ||
Cardnumber | Да | Номер карты | |||
Cardholder | Да | 70 символов без цифр. Разделитель – пробел. | Держатель карты. | ||
Expiremonth | Да | 1-12 | Месяц окончание действия карты | ||
Expireyear | Да | Год в формате YYYY | Год окончания действия карты | ||
Cvc2 | Да | CVC2 код | |||
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 | Нет | 1 – CSV | 1 | Формат выдачи результата. | |
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 | ||
CustomerNumber | Нет | 32 символа | Внутренний номер клиента предприятия (мерчанта) | ||
Disable3DS | Нет | 1 – проверять 3-D Secure согласно настройкам предприятия, 0 – проводить платеж без 3-D Secure. | 0 | Признак отключения 3-D Secure.
|
Пример запроса HTTP POST проведения платежа в скрытом режиме silentpay: