The payment status page is the page the customer is redirected to when the transaction is finished. This page should display all relevant transaction details to the customer. Plse see below all required transaction information that should be displayed on the page and on the email confirmation.
- Transaction Result - describe transaction status by parsing the transaction response code and description. Those are present in the received server response.
- Transaction ID Our Payment Gateway will return this information as the MerchantTransactionId, which you may find in the response message recived.
- Amount and currency - The information should be displayed to the customer and it is found in the response message as amount and currency fields.
- Card details: Typically, you should parse and display: last four digits of the card used - last4Digits, and card type used in the paymentBrand field.
- Bank authorization code Each successful Live transaction receives a unique authorization code from the bank.
- Timestamp - Indicate the exact time when the trasaction was processed.
If you are not sure how should it be displayed to the customer, you may look at the example we did for you:
Status: 000.000.000 Transaction succeded
Order ID: 8210425021
Amount: 1000.00 RSD
Card Type: VISA ****1234
Bank Code: XXXXXX
Timestamp: 2017-02-20 11:53:34+****
Bellow you may find examples of postback messages received after the transaction:
EXCHANGE PLATFORM /v1 XML:
<?xml version="1.0" encoding="utf-8"?>
<callback xmlns="http://asxgw.com/Schema/V2/Callback">
<result>OK</result>
<referenceId>edcba123456789012345</referenceId>
<transactionId>YOUR_TRANSACTION_ID </transactionId>
<purchaseId>20170120-edcba123456789012345</purchaseId>
<transactionType>DEBIT</transactionType>
<merchantMetaData>YOUR_OPTIONAL_META_DATA</merchantMetaData>
<amount> 4.99 </amount>
<currency>USD</currency>
<extraData key="authCode">XXXXXX</extraData>
<returnData type="creditcardData">
<creditcardData>
<type>visa</type>
<cardHolder>Max Mustermann</cardHolder>
<expiryMonth>10</expiryMonth>
<expiryYear>2020</expiryYear>
<firstSixDigits>411111</firstSixDigits>
<lastFourDigits>1111</lastFourDigits>
<fingerprint>ABCXYZ...</fingerprint>
<threeDSecure>MANDATORY</threeDSecure>
<eci>05</eci>
<binBrand>VISA</binBrand>
<binBank>Issuing Bank</binBank>
<binCountry>AT</binCountry>
</creditcardData>
</returnData>
<customerData>
<identification>1111</identification>
<firstName>John</firstName>
<lastName>Smith</lastName>
<billingCountry>AT</billingCountry>
<email>[email protected]</email>
<ipAddress>123.123.123.123</ipAddress>
</customerData>
</callback>
EXCHANGE PLATFORM /v2 json:
{"result":"OK","uuid":"805b6ecda12xxxxxxx","merchantTransactionId":"YOUR_TRANSACTION_ID","purchaseId":"20201218-805b6ecda12e7552cd61","transactionType":"DEBIT","paymentMethod":"Creditcard","amount":"4.99","currency":"EUR","merchantMetaData":"YOUR_OPTIONAL_META_DATA","customer":{"identification":"1111","firstName":"John","lastName":"Smith","emailVerified":"false","ipAddress":"123.123.123.123"},"returnData":{"_TYPE":"cardData","type":"mastercard","cardHolder":"John Smith","expiryMonth":"01","expiryYear":"2020","firstSixDigits":"411111","lastFourDigits":"1111","fingerprint":"ABCXZY...","threeDSecure":"MANDATORY","eci":"02","binBrand":"MASTERCARD","binBank":"Issuing Bank","binType":"DEBIT","binLevel":"STANDARD","binCountry":"US"},"extraData":{"authCode":"XXXXXX"}}
{"result":"OK","uuid":"805b6ecda12xxxxxxx","merchantTransactionId":"YOUR_TRANSACTION_ID","purchaseId":"20201218-805b6ecda12e7552cd61","transactionType":"DEBIT","paymentMethod":"Creditcard","amount":"4.99","currency":"EUR","merchantMetaData":"YOUR_OPTIONAL_META_DATA","customer":{"identification":"1111","firstName":"John","lastName":"Smith","emailVerified":"false","ipAddress":"123.123.123.123"},"returnData":{"_TYPE":"cardData","type":"mastercard","cardHolder":"John Smith","expiryMonth":"01","expiryYear":"2020","firstSixDigits":"411111","lastFourDigits":"1111","fingerprint":"ABCXZY...","threeDSecure":"MANDATORY","eci":"02","binBrand":"MASTERCARD","binBank":"Issuing Bank","binType":"DEBIT","binLevel":"STANDARD","binCountry":"US"},"extraData":{"authCode":"XXXXXX"}}
OPEN PLATFORM:
payload{ "id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "paymentType":"DB", "paymentBrand":VISA", "amount":"1000.00", "currency":"RSD", "descriptor":"7567.4447.0226xxxxxxxxxxxxx", "merchantTransactionId:"8210425021xxxxxxxxxxxxxxx", "result{ "cvvResponse":"M", "code":"000.000000", "description" :"transactionsucceeded", }, "resultDetails{ "ConnectorTxID3":"XXXXXX00", "ConnectorTxID2":"xxxxxxxxx744470226********", "ConnectorTxID1":"XXXXXXXXXXXXXXXXXXXXX" }, "card{ "last4Digits":"1234", "holder":"Petar Petrovic", "expiryMonth":"12", "expiryYear":"2019" }, "customer{ "givenName":"Petar", "surname":"Petrovic", "ip":"XXXXXXXXXXXXXX" }, "threeDSecure{ "eci":"05", verificationId":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXX=", "xid":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX=" }, "customParametes{ "CTPE_DESCRIPTOR_TEMPLATE":"" }, "risk{ "score":"0" }, "buildNumber":"[email protected] 12:25:35 +****", "timestamp"2017-02-2011:53:34+****", "ndc":"XXXXXXXXXXXXXXXXXXXXXXXXXXXX.lon-vm-tx08" }