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)

results matching ""

    No results matching ""