Payment Option Details

👍

HTTPS POST / Server-to-Server

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

Go live when you are ready, Live endpoint is provided.

Payment Option Details API allow merchant to get all the available payment option details in a single request.

Payment Option Details Request


Below sample request data show the data structure. Refer Payment Option Details Request Parameter for API Specification.

{
    "paymentToken": "kSAops9Zwhos8hSTSeLTUcCrwcnrndJUZanGJy3fBEsXCiYmynwxHvK5h7XPBadJqD0nG7v65t5N2jPVrnwX2jL4nu+KKSegjUjERKCyWPg=",
    "clientID": "E380BEC2BFD727A4B6845133519F3AD7",
    "locale": "en",
    "categoryCode": "GCARD",
    "groupCode": "CC"
}

 

Payment Option Details Response


Below sample response data show the data structure. Refer Payment Option Details Response Parameter for API Specification.

{
    "name": "XXX Payment",
    "categoryCode": "CATEGORY_CODE",
    "groupCode": "GROUP_CODE",
    "iconUrl": "https://img.2c2p.com/pgw/CATEGORY_CODE.png",
    "validation": {  //Payment channel validations
        "cardNo": {
            "prefixes": ["411111", "544444", "555555", "4", "54", "55"],
            "regex": "^4[0-9]{12}(?:[0-9]{3})?$"
        },
        "cardTypes": [{  //Allowed card type for installment payment plan
            "sequenceNo": 1,
            "name": "VISA",
            "prefixes": ["4"],
            "regex": "^(4[0-9]*)$",
            "iconUrl": "https://img.2c2p.com/pgw/vi.png"
        }]
    },
    "channels": [{  //List of enabled payment channels
        "sequenceNo": 1,
        "name": "VISA",  //Payment channel information for UI
        "currencyCodes": ["THB"],
        "iconUrl": "https://img.2c2p.com/pgw/icon/vi.png",
        "logoUrl": "https://img.2c2p.com/pgw/vi.png",
        "isDown" : false,
        "payment": {  //Payment context can provide an as-seemless-as-possible integration of the payment process into the UI-flow
            "code": {  //Payment code to be submitted on Do Payment request
                "channelCode": "CC",
                "agentCode": "SCB",
                "agentChannelCode": "ATM"
            },
            "input": {  //Input parameters which need to be retrieved from customer for UI
                "name": "M",
                "email": "O",
                "mobileNo": "O",
                "cardNo": "M",
                "expiryDate": "M",
                "securityCode": "M",
                "pin": "I",
                "token": "I",
                "accountNo": "I"
            },
            "validation": {  //Validation of customer input data of parameters
                "name": "^(?:[a-zA-Z0-9]+)?$",
                "email": "^[A-Z0-9._%+-][email protected][A-Z0-9.-]+\\.[A-Z]{2,6}$",
                "mobileNo": "[0-9]+",
                "cardNo": "^4[0-9]{12}(?:[0-9]{3})?$",
                "expiryDate": "^(2d{3}0?[1-9]|1[012])$",
                "securityCode": "^[0-9]{3}$",
                "pin": "^[0-9]{6}$",
                "token": "(.*?)",
                "accountNo": "[0-9]+",
                "additional": {  //Additional validation on parameters for identification or additional validation purpose
                    "cardNo": {
                        "luhn": true,
                        "prefixes": ["4"]
                    },
                    "amount" : {
                        "min" : 100,
                        "max" : 10000
                    }
                }
            },
            "info": {  //Payment Channel specific additional information
                "terms": "bank’s ipp terms and conditions",
                "promoUrl": "https://img.2c2p.com/pgw/promo.png",
                "plans": [{  //Installment Payment plan list
                    "sequenceNo": 1,
                    "period": 3,
                    "interestType": "M",
                    "interestRate": 0.0000,
                    "monthlyAmount": 0.16667,
                    "monthlyInterest": 0.00000,
                    "currencyCode": "SGD",
                    "label": "0% interest promotion (monthly installment amount 0.16667 SGD)"
                }, {
                    "sequenceNo": 2,
                    "period": 6,
                    "interestType": "C",
                    "interestRate": 1.0000,
                    "monthlyAmount": 0.16667,
                    "monthlyInterest": 0.00000,
                    "currencyCode": "SGD",
                    "label": "6 months with 1.0000% interest (monthly installment amount 0.16667 SGD)"
                }]
            }
        }
    }],
    "configuration": {
        "payment": {
            "immediatePayment": false,
            "tokenize": false,
            "tokenizeOnly": false,
            "cardTokenOnly": false,
            "fx": {
                "mcp": {
                    "active": true,
                    "terms": "MCP's terms and conditions."
                },
                "dcc": {
                    "active": false,
                    "terms": "DCC's terms and conditions."
                }
            }
        },
        "notification": {
            "facebook": true,
            "whatsApp": true,
            "line": true
        }
    },
    "respCode": "0000",
    "respDesc": "success"
}