Transaction Status Inquiry

👍

HTTPS POST / Server-to-Server

Sandbox endpoint : sandbox-pgw.2c2p.com/payment/4.1/transactionStatus
Run test with Swagger Editor

To go live, refer to: Live endpoint guide

The Transaction Status Inquiry API allows merchants to check the status of a transaction made through any merchant UI or mobile application.

Merchants should not use this API to check or acknowledge updated payment status. In such cases, merchants must use the Payment Inquiry API call from backend.

Transaction Status Inquiry Request


To prepare a transaction status inquiry request, refer to the guidelines below.

  1. Prepare payload data. The sample code below demonstrates the correct data structure for an API request.

For API specifications, refer to: Transaction Status Inquiry Request Parameters

{
    "paymentToken": "kSAops9Zwhos8hSTSeLTUcCrwcnrndJUZanGJy3fBEsXCiYmynwxHvK5h7XPBadJqD0nG7v65t5N2jPVrnwX2jL4nu+KKSegjUjERKCyWPg=",
    "clientID": "E380BEC2BFD727A4B6845133519F3AD7",
    "locale": "en",
    "additionalInfo": true
}

 

Transaction Status Inquiry Response


The sample code below demonstrates the data structure for an API response.

For API specifications, refer to: Transaction Status Inquiry Response Parameter

{
    "channelCode": "CC",
    "invoiceNo": "1523953661",
    "additionalInfo": {
        "merchantDetails": {
            "name": "HAPPY SHOP",
            "address": "#03-00 Tras street 089997",
            "email": "[email protected]",
            "logoUrl": "https://img.2c2p.com/merchant/jt01.png"
        },
        "transactionDetails": {
            "dateTime": "311220235959",
            "agentCode": "OCBC",
            "channelCode": "VI",
            "data": "411111XXXXXX1111",
            "amount": "1000.00",
            "currencyCode": "SGD",
            "invoiceNo": "1523953661",
            "description": "item 1"
        },
        "paymentResultDetails": {
            "code": "00",
            "description": "Transaction is successful.",
            "redirectImmediately": true,
            "autoRedirect": true,
            "autoRedirectTimer": 1000,
            "frontendReturnUrl": "https://merchant.com/resultpage/",
            "frontendReturnData": "base64dataABCDEF"
        }
    },
    "respCode": "2000",
    "respDesc": "Transaction is completed, please do payment inquiry request for full payment information."
}