2.2. Form of initial request
This form is sent by PayMaster 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 PayMaster 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 PayMaster 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.
Last updated