Payment status request
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 | The Merchant can get the identifier in the Cabinet. | |
| 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 | |||
| Signature of request | LMI_HASH | Yes | The signature of the request is generated by hashing the original text of the XML request with an empty LMI\ _HASH value and the SecretKey using the algorithm specified in the Merchant Cabinet. The received signature is passed in the LMI_HASH tag. The recommended encryption algorithm is SHA256. Sign example |
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 result code | Retval | 1 – successful request 2 - invalid request type (POST expected) 1 - general error -2 - invalid authorization data -3 - invalid signature -4 - invalid order identifier -5 - transaction with the specified identifier was not found |
| Description of operation code | Retdesc | |
| Retdata/Transaction | Payment details | |
| Merchant ID | LMI_MERCHANT_ID | |
| Payment amount | LMI_PAYMENT_AMOUNT | |
| Merchant internal order number | 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 fee |
| Client details | LMI_PAYER_IDENTIFIER | Client’s payment data (e.g. bank card 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) |
| Signature | LMI_HASH | Control signature created similar to ‘Payment notification form’ |
| Payment status | State | 0 - payment is pending 1 - success payment 2 - payment canceled (funds are returned to the Client) 3 - payment is being processed 4 - payment is being verified 6 - payment is in Hold status, confirmation or cancellation pending 7 - payment deadline expired 8 - unsuccessful payment |
| Refunds | The list of refunds processed in this transaction | |
| Refund request number | RefundId | |
| Refund amount | RefundAmount | |
| Date of request | Created | |
| Status of refund | State | 0 - new application 1 - application being processed 2 - refund completed |
| Type of refund | Type | 1 – processed with refund interface |