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
|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.