Need help?

Response

Below table describes the fields in the response message.

Field

Description

status

Authorisation status:'A' indicates an authorised transaction. Any other value indicates that the request could not be processed.

code

If the transaction was authorised this contains the authorisation code from the card issuer. Otherwise it contains a code indicating why the transaction could not be processed.

message

The response message of the transaction reflects the authorisation or error message.

tranref

The payment gateway transaction reference allocated to this request.

cvv

Result of the CVV check:
Y = CVV matched OK
N = CVV not matched
X = CVV not checked
"E = Error unable to check CVV"

avs

Result of the AVS check:
Y = AVS matched OK
"P = Partial match (for example post-code only)"
N = AVS not matched
X = AVS not checked
"E = Error unable to check AVS"

networktranid

Payment network transaction id

cartid

Unique cartid value which will be passed in request

rrn

Retrieval reference rumber

The AVS check is currently only available for cards issued in the United Kingdom, United States of America or Canada.

Sample response

<?xml version="1.0" encoding="UTF-8"?>
<remote>
    <auth>
        <status>A</status>
        <code>213807</code>
        <message>Authorised</message>
        <tranref>042525252525</tranref>
        <cvv>Y</cvv>
        <avs>X</avs>
        <networktranid>123456789</networktranid>
        <cartid>abc123</cartid>
        <rrn>123456</rrn>
        <trace>4001/1092034/669028e9</trace>
    </auth>
    <payment>
        <code>VC</code>
        <description>Visa Credit ending 0008</description>
        <card_end>0008</card_end>
        <card_bin>123456</card_bin>
        <card_country>AE</card_country>
    </payment>
</remote>

Sample decline response

<Response>
    <Method>MPGS_RequestAuth</Method>
    <Trace>1675709/20241126/1234</Trace>
    <Error>
        <Message>DECLINED</Message>
        <Code>05</Code>
        <Note>Do not honour</Note>
    </Error>
    <Details>
        <AcquirerCSCResponseCode>NOT_PROCESSED</AcquirerCSCResponseCode>
        <CardType>VISA</CardType>
        <ECI>05</ECI>
        <OrderID>1674814.602454502.67ae1234</OrderID>
        <ReceiptNumber>43300000580</ReceiptNumber>
        <STAN>2612230</STAN>
        <TransactionNumber>5TG1234</TransactionNumber>
        <TransactionResponseCode>05</TransactionResponseCode>
    </Details>
</Response>