2.2. Form of initial request
This form is sent by PaySoft to Result URL of Merchant prior to receiving a payment. This from is sent in case a checkbox ‘Send initial request’ in Merchant’s Cabinet settings is selected. It is recommended to select this checkbox and always process ‘Form of initial request’!
Action - Result URL
Method - POST
Form features:
| Name | html-format | Description |
|---|---|---|
| Indicator of initial request | LMI_PREREQUEST | Value always equals 1. |
| Merchant ID | LMI_MERCHANT_ID | Merchant’s POS ID to receive payment. |
| Payment amount | LMI_PAYMENT_AMOUNT | Amount for Client to pay. |
| Internal order number in accounting system of Merchant | LMI_PAYMENT_NO | Internal order number in accounting system of Merchant received from Merchant in ‘Payment request form’. |
| Test mode indicator | LMI_MODE | Indicates mode to receive payment: 0 - working mode; 1 – test mode. |
| Payment system ID | LMI_PAYMENT_SYSTEM | Payment system ID to receive payment. |
| Payment description | LMI_PAYMENT_DESC | Description of a paid service/work/good. The maximum length is 255 symbols. Unicode - UTF8. |
| Client’s phone number | LMI_PAYER_PHONE_NUMBER | Client’s phone number in format 380xxxxxxxxx. |
| Client’s email | LMI_PAYER_EMAIL | Client’s email. |
| Additional features | Defined by Merchant | All fields received from Merchant in ‘Form of payment request’ without prefix "LMI". |
It is recommended not to ignore data received from PaySoft Merchant Interface in ‘Form of initial request’ and use it for check-ups. Merchant must ensure that future payment is approved and its parameters were not falsified by Client with criminal purpose.
In particular, it is recommended:
- Check accuracy of Merchant ID (LMI_MERCHANT_ID).
- Check order with a specified number (LMI_PAYMENT_NO) in Merchant’s database, and the fact that internal number of order in Merchant’s accounting system enables him to accept payment for this order.
- Make sure that payment amount (LMI_PAYMENT_AMOUNT) corresponds to order and was not changed by Client.
- Check integrity and correctness of Additional features set by Merchant if necessary.
In case all necessary check-ups are done, website of Merchant must send ‘YES’ in response to this form in http-format (e.g. echo "YES" for PHP or HttpContext.Current.Response.Write("YES") for ASP.NET).
Any answer different from ‘YES’ is considered a mistake and showed to Client in PaySoft interface, while payment is not accepted. If Merchant’s website is unable to access or sends a blank line in response, payment is also not accepted.