3. Interface of payment status request
This XML-interface enables Merchant anytime check the status of payment prior initiated via PaySoft Merchant Interface.
Action - https://api.paysoft.solutions/merchants/get-transaction
Method - POST
XML-request format:
<?xml version="1.0" encoding="UTF-8"?>
<Command>
<LMI_MERCHANT_ID></LMI_MERCHANT_ID>
<LMI_PAYMENT_NO></LMI_PAYMENT_NO>
<LMI_SYS_PAYMENT_ID></LMI_SYS_PAYMENT_ID>
<LMI_HASH></LMI_HASH>
</Command>
Name | XML-format | Description |
---|---|---|
Merchant ID | LMI_MERCHANT_ID | Merchant’s POS ID to which a payment from Client may be accepted. |
Order number | LMI_PAYMENT_NO | Order number in Merchant’s system – (LMI_PAYMENT_NO), or order number in PaySoft system - (LMI_SYS_PAYMENT_ID) must be indicated. |
LMI_SYS_PAYMENT_ID | ||
Control signature | LMI_HASH | Control signature of request which is created by encoding outgoing text of XML-request with blank field LMI_HASH and blank secret key SecretKey using algorithm chosen in Merchant’s cabinet. Received signature transferred at tag LMI_HASH. The recommended encoding algorithm is SHA256. |
XML-response format:
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Retval></Retval>
<Retdesc></Retdesc>
<Retdata>
<Transaction>
<LMI_MERCHANT_ID></LMI_MERCHANT_ID>
<LMI_PAYMENT_AMOUNT></LMI_PAYMENT_AMOUNT>
<LMI_PAYMENT_NO></LMI_PAYMENT_NO>
<LMI_PAYMENT_SYSTEM></LMI_PAYMENT_SYSTEM>
<LMI_MODE></LMI_MODE>
<LMI_PAYMENT_DESC></LMI_PAYMENT_DESC>
<LMI_SYS_PAYMENT_ID></LMI_SYS_PAYMENT_ID>
<LMI_SYS_PAYMENT_DATE></LMI_SYS_PAYMENT_DATE>
<LMI_PAID_AMOUNT></LMI_PAID_AMOUNT>
<LMI_PAYER_IDENTIFIER></LMI_PAYER_IDENTIFIER>
<LMI_PAYER_PHONE_NUMBER></LMI_PAYER_PHONE_NUMBER>
<LMI_PAYER_EMAIL></LMI_PAYER_EMAIL>
<LMI_HOLD_REFUND_AMOUNT></LMI_HOLD_REFUND_AMOUNT>
<LMI_HASH></LMI_HASH>
<State></State>
<Refunds>
<Refund>
<RefundId></RefundId>
<RefundAmount></RefundAmount>
<Created></Created>
<State></State>
<Type></Type>
</Refund>
</Refunds>
</Transaction>
</Retdata>
</Response>
Name | XML-format | Description |
---|---|---|
Operation code of request | Retval | 1 (one) – successful transaction |
Description of operation code | Retdesc | |
Retdata / Transaction | Data about payment stated in request. | |
Merchant ID | LMI_MERCHANT_ID | |
Payment amount | LMI_PAYMENT_AMOUNT | |
Internal number of order in accounting system of Merchant | LMI_PAYMENT_NO | |
Payment system ID | LMI_PAYMENT_SYSTEM | |
Test mode indicator | LMI_MODE | Indicates mode of received payment: 0 - working mode; 1 – test mode. |
Payment description | LMI_PAYMENT_DESC | |
Internal number of payment in PaySoft system | LMI_SYS_PAYMENT_ID | |
Date and time of receiving a payment | LMI_SYS_PAYMENT_DATE | |
Total amount | LMI_PAID_AMOUNT | Total paid amount including extra fees of Financial institution. |
Client details | LMI_PAYER_IDENTIFIER | Client’s payment data (e.g. banking card concealed number). Format depends on payment system which processed payment |
Client’s phone number | LMI_PAYER_PHONE_NUMBER | Client’s phone number in format 380xxxxxxxxx. |
Client’s email | LMI_PAYER_EMAIL | Client’s email. |
Refund Hold | LMI_HOLD_REFUND_AMOUNT | Refund which was return to client after confirmarion a transaction at Hold status (in case of confirmation a sum less than initial sum) |
Control signature | LMI_HASH | Control signature created similar to ‘Form of payment notification’ (see art. 2.3) |
Payment status | State | 0 – payment is expected |
Refunds | The list of refunds processed in this transaction | |
Refund request number | RefundId | |
Refund amount | RefundAmount | |
Date of request | Created | |
Status of request | State | 0 – new request |
Type of request | Type | 1 – fast refund – processed with refund interface (see art.5) |