2.1. Форма запиту платежу
Ця форма відправляється Продавцем на сайт PaySoft через веб-браузер Клієнта (з одночасним переходом самого Клієнта).
Action - https://lmi.paysoft.solutions/ Для української мови 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_ID | Ні | Може містити букви англійського алфавіту, цифри та знак дефісу «-». Максимальна довжина – 25 символів. |
| Збереження реквізитів карти | LMI_CREATE_TOKEN | Ні | Приймає значення 0 або 1. Якщо дорівнює 1, то після успішної оплати реквізити картки буде збережено і повернено параметр LMI_PAYMENT_TOKEN. Див Списання зі збереженої карти |
| Оплата за збереженим токеном карти | LMI_PAYMENT_TOKEN | Ні | Передается вже збережений токен карти. Оплата буде здійснено з підтвердженням CVV та 3DSecure |
| Розщеплення платежу | LMI_SPLIT | Ні | Платіж з розщепленням суми на декількох одержувачів. У цьому параметрі вказується JSON масив з правилами розщеплення платежу. При використанні параметра LMI_SPLIT відбувається одне списання з клієнта і кілька зарахувань одержувачам. Приклад JSON рядка:[{"CompanyId": 1, "Amount": 20}, {"CompanyId": 2, "Amount": 12}] |
| Контрольний підпис | LMI_HASH | Ні | Контрольний підпис "Форми запиту платежу". Якщо в Кабінеті Продавця встановлено відповідні налаштування «Увімкнути перевірку підпису у формі запиту платежу», цей підпис використовуватиметься для перевірки цілісності отриманої інформації та однозначної ідентифікації відправника. Підпис є результатом хешування рядка, отриманого шляхом склеювання (без роздільників) значень наступних параметрів точно в зазначеному порядку: LMI_MERCHANT_ID LMI_PAYMENT_NO LMI_PAYMENT_AMOUNT LMI_SPLIT secretKey Алгоритм хешування та Secret Key встановлюються Продавцем у налаштуваннях в кабінеті і відомі лише продавцю та системі PaySoft. Рекомендований алгоритм шифрування є SHA256. |
| Тип оплати | PAYTYPE | Ні | Для LMI_PAYMENT_SYSTEM=21 обмежує тип оплати одним із способів. Може приймати значення: APPLEPAY, GOOGLEPAY |
| Додаткові параметри | Визначаються Продавцем | Ні | Всі поля форми, що не мають у назві префікса "LMI_", приймаються сервісом PaySoft Merchant Interface й передаються (транслюються) без змін на веб-сайт Продавця у всіх інших html-формах PaySoft Merchant Interface. |
- Лише один з параметрів LMI_PAYMENT_DESC або LMI_PAYMENT_DESC_BASE64 обов'язково повинен бути присутнім!
** - Обов’язковість поля визначається налаштуваннями у Кабінеті Продавця.