Форма запроса платежа
Эта форма отправляется Продавцом на сайт PaySoft через веб-браузер Клиента (с одновременным переходом самого Клиента).
Action - https://lmi.paysoft.solutions/ Для русского языка https://lmi.paysoft.solutions/ru/ Для украинского языка https://lmi.paysoft.solutions/uk/ Для англиского языка https://lmi.paysoft.solutions/en/
Method - POST
Параметры форми:
| Название | Название параметра в html-форме | Обязательный? | Описание |
|---|---|---|---|
| Идентификатор продавца | LMI_MERCHANT_ID | Да | Идентификатор магазина. Идентификатор Продавец может получить в Кабинете (https://merchant.paysoft.solutions). |
| Сумма платежа | LMI_PAYMENT_AMOUNT | Да | Сумма платежа, которую Продавец желает получить от Клиента. Сумма должна быть больше нуля, дробная часть отделяется точкой. |
| Внутренний номер заказа в системе учета Продавца | LMI_PAYMENT_NO | Нет | В этом поле Продавец определяет номер заказа в соответствии со своей системой учета. Несмотря на то, что параметр не является обязательным, рекомендуется всегда задавать его, поскольку он нужен для корректной работы других интерфейсов. Желательно использовать уникальный номер для каждого платежа. Номер может содержать буквы английского алфавита, цифры и знак дефиса «-». Максимальная длина - 64 символов. |
| Назначение платежа | LMI_PAYMENT_DESC | Да* | Описание товара или услуги. Формируется на стороне продавца. Если присутствует, добавляется в назначение платежа транзакции PaySoft. Максимальная длина - 255 символов, кодировка UTF-8. |
| Назначение платежа | LMI_PAYMENT_DESC_BASE64 | Да* | Описание товара или услуги в UTF-8 с последующим кодированием с помощью алгоритма Base64. Формируется на стороне продавца. Если присутствует, то результат декодирования будет подставлен вместо LMI_PAYMENT_DESC. Позволяет не зависеть от кодирования на сайте Продавца. |
| Замена Success URL | LMI_SUCCESS_URL | Нет | Если значение передано в форме, оно заменяет значение параметра "Success URL", установленное в настройках Кабинета. В противном случае, всегда используется значение Success URL, установленное в настройках. |
| Замена метода вызова Success URL | LMI_SUCCESS_METHOD | Нет | Если значение передано в форме, оно заменяет значение параметра "Метод вызова Success URL", установленное в настройках Кабинета. В противном случае, всегда используется значение, установленное в настройках. |
| Замена Fail URL | LMI_FAIL_URL | Нет | Если значение передано в форме, оно заменяет значение параметра "Fail URL", установленное в настройках Кабинета. В противном случае, всегда используется значение Fail URL, установленное в настройках. |
| Замена метода вызова Fail URL | LMI_FAIL_METHOD | Нет | Если значение передано в форме, оно заменяет значение параметра "Метод вызова Fail URL", установленное в настройках Кабинета. В противном случае, всегда используется значение, установленное в настройках. |
| Срок оплаты заказа | LMI_EXPIRES | Нет | Срок, в течение которого заказ может быть оплачен. Передается в формате YYYY-MM-DD hh:mm:ss. Если параметр пустой, время оплаты является неограниченным. |
| Идентификатор платежного инструмента | LMI_PAYMENT_SYSTEM | Нет | Идентификатор платежного инструмента, который Клиент выбрал для оплаты при формировании заказа на сайте продавца. Посмотреть перечень платежных инструментов можно в Кабинете. |
| Признак тестового режима | LMI_SIM_MODE | Нет | Указывает, как проводить транзакцию после оплаты: 0 - всегда успешно, 1 - всегда неуспешно (возврат средств клиенту), 2 - вариативно (80% успешно, 20% не успешно) |
| Номер телефона Клиента | LMI_PAYER_PHONE_NUMBER | Нет** | Номер телефона Клиента в формате 380xxxxxxxxx. |
| Электронный адрес Клиента | LMI_PAYER_EMAIL | Нет** | Электронный адреса Клиента |
| Фамилия Клиента | LMI_PAYER_SURNAME | Нет*** | Фамилия Клиента |
| Имя Клиента | LMI_PAYER_FIRSTNAME | Нет*** | Имя Клиента |
| Отчество Клиента | LMI_PAYER_PATRONYMIC | Нет*** | Отчество Клиента |
| Дата рождения Клиента | LMI_PAYER_BIRTHDAY | Нет*** | Дата рождения Клиента в формате ГГГГ-ММ-ДД |
| ИНН Клиента | LMI_PAYER_TAX_ID | Нет*** | ИНН |
| Страна Клиента | LMI_PAYER_COUNTRY | Нет** | ISO 3166-1 alpha-2 |
| Штат (только для США и Канады) | LMI_PAYER_STATE | Нет** | аббревиатура штата |
| Город | LMI_PAYER_CITY | Нет** | Город |
| Почтовый индекс | LMI_PAYER_ZIP | Нет** | Почтовый индекс |
| Адрес | LMI_PAYER_ADDRESS | Нет** | Адрес |
| Дата рождения Клиента | LMI_PAYER_BIRTHDAY | Нет*** | Дата рождения Клиента в формате ГГГГ-ММ-ДД |
| Идентификатор клиента на стороне Продавца | LMI_PAYER_ID | Нет | Может содержать буквы английского алфавита, цифры и знак дефиса «-». Максимальная длина 50 символов. |
| Сохранение реквизитов карты | LMI_CREATE_TOKEN | Нет | Флаг, принимает значение 0 или 1. Если равен 1, то после успешной оплаты реквизиты карты, будут сохранены и возвращен параметр LMI_PAYMENT_TOKEN. См Списание по сохраненной карте |
| Оплата по сохраненном токену карты | LMI_PAYMENT_TOKEN | Нет | Передается уже сохраненый токен карты. Оплата будет производится с подтверждением CVV и 3DSecure |
| Расщепление платежа | LMI_SPLIT | Нет | Платеж с расщеплением суммы на нескольких получателей. В этом параметре указывается JSON массив с правилами расщепления платежа. При использовании параметра LMI_SPLIT происходит одно списание с клиента и несколько зачислений получателям. Пример JSON строки:[{"CompanyId": 1, "Amount": 20,"CompanyName":"","Description":"","EDRPOU":"","IBAN":""}, {"CompanyId": 2, "Amount": 12,"CompanyName":"","Description":"","EDRPOU":"","IBAN":""}] |
| Тип оплаты | PAYTYPE | Нет | Для LMI_PAYMENT_SYSTEM=21 ограничивает тип оплаты одним из способов. Может прнимать значения: APPLEPAY, GOOGLEPAY |
| Контрольная подпись | LMI_HASH | Нет | Контрольная подпись "Формы запроса платежа". Если в Кабинете Продавца установлены соответствующие настройки «Включить проверку подписи формы запроса платежа», эта подпись будет использоваться для проверки целостности полученной информации и однозначной идентификации отправителя. Подпись является результатом хеширования строки, полученной путем склеивания (без разделителей) значений следующих параметров точно в указанном порядке: LMI_MERCHANT_ID LMI_PAYMENT_NO LMI_PAYMENT_AMOUNT LMI_SPLIT secretKey Алгоритм хеширования и Secret Key устанавливаются Продавцом в настройках его Кабинета, и известен только продавцу и системе PaySoft. Рекомендуемый алгоритм шифрования есть SHA256. |
| Дополнительные параметры | Определяются Продавцом | Нет | Все поля формы, не имеющие в названии префикса "LMI_", принимаются сервисом PaySoft Merchant Interface и передаются (транслируются) без изменений на веб-сайт Продавца во всех других html-формах PaySoft Merchant Interface. |
- Лишь один из параметров LMI_PAYMENT_DESC или LMI_PAYMENT_DESC_BASE64 обязательно должен присутствовать!
* - Обязательность поля определяется настройками в Кабинете продавца. \** - Могут быть обязательными для некоторых MCC