2.2. Форма предварительного запроса
Эта форма отправляется PaySoft на Result URL Продавца непосредственно перед приемом платежа. Данная форма передается, если в настройках Кабинета продавца установлен флажок "Отправлять предварительный запрос". Рекомендуем установить этот флажок и всегда обрабатывать "Форму предварительного запроса"!
Action - Result URL
Method - POST
Параметры формы:
| Название | Название параметра в html-форме | Описание |
|---|---|---|
| Индикатор предварительного запроса | LMI_PREREQUEST | Значение всегда равное 1. |
| Идентификатор продавца | LMI_MERCHANT_ID | Идентификатор магазина. Идентификатор Продавец может получить в Кабинете (https://merchant.paysoft.solutions). |
| Сумма платежа | LMI_PAYMENT_AMOUNT | Сумма, которую собирается оплатить Клиент. |
| Внутренний номер заказа в системе учета Продавца | LMI_PAYMENT_NO | Номер заказа в соответствии с системой учета Продавца, полученный от Продавца в «Форме запроса платежа». |
| Признак тестового режима | LMI_MODE | Указывает, в каком режиме принимается платеж: 0 - рабочий режим; 1 - тестовый режим. |
| Идентификатор платежного инструмента | LMI_PAYMENT_SYSTEM | Идентификатор платежного инструмента, с помощью которого будет выполнен платеж. |
| Назначение платежа | LMI_PAYMENT_DESC | Описание товара/работы/услуги, которая оплачивается. Максимальная длина - 255 символов. Кодирование - UTF8. |
| Номер телефона Клиента | LMI_PAYER_PHONE_NUMBER | Номер телефона Клиента в формате 380xxxxxxxxx. |
| Электронный адрес Клиента | LMI_PAYER_EMAIL | Электронна адрес Клиента. |
| Дополнительные параметры | Визначаються Продавцем | Все поля, полученные от Продавца в "Форме запроса платежа", не имеющие префикса "LMI_". |
Рекомендуется не игнорировать данные, полученные от PaySoft Merchant Interface в "Форме предварительного запроса", и использовать их для проверок. Продавец должен убедиться, что платеж, который будет принят, является санкционированным и его характеристики не были подменены Клиентом в злонамеренных целях.
В частности, рекомендуется:
- Проверить правильность идентификатора Продавца (LMI_MERCHANT_ID).
- Проверить наличие заказа с указанным номером (LMI_PAYMENT_NO) в базе данных Продавца, а также тот факт, что внутренний статус этого заказа в системе учета Продавца позволяет принять платеж за этот заказ.
- Убедитесь, что сумма (LMI_PAYMENT_AMOUNT) соответствует заказу и не была изменена Клиентом.
- Проверить целостность и полноту Дополнительных параметров, установленных Продавцом, если это необходимо.
В случае если все необходимые проверки пройдены, веб-сайт Продавца должен вернуть слово "YES" в ответ на эту форму в теле http-ответа (например, echo "YES" для PHP или HttpContext.Current.Response.Write ( "YES") для ASP.NET). Любая строка, кроме "YES", воспринимается как ошибка, отображается Клиенту визуально в интерфейсе PaySoft, а платеж не принимается. Если сайт Продавца недоступен или возвращает в ответ пустую строку, прием платежа также не производится.