Card Installment Plan Info
HTTPS POST / Server-to-Server
https://sandbox-pgw.2c2p.com/payment/4.3/cardinstallmentplaninfo
https://pgw.2c2p.com/payment/4.3/cardinstallmentplaninfo
API Parameter
Card Installment Plan Info Request Parameter
Card Installment Plan Info Response Parameter
The Card Installment Plan Info API allows merchants to retrieve Installment Plan information.
Card Installment Plan Info Request
To prepare an API request, refer to the guidelines below.
- The sample code below demonstrates the correct structure for an API request.
{
"paymentToken": "kSAops9Zwhos8hSTSeLTUcCrwcnrndJUZanGJy3fBEsXCiYmynwxHvK5h7XPBadJqD0nG7v65t5N2jPVrnwX2jL4nu+KKSegjUjERKCyWPg=",
"securePayToken": "00acdvbILhNQDPn1**********t1KigCEq51QYqHps",
"bankCode": "Visa Insta"
}
curl --location --request POST 'https://sandbox-pgw.2c2p.com/payment/4.3/cardinstallmentplaninfo' \
--header 'Content-Type: application/json' \
--data-raw '{
"paymentToken": "kSAops9Zwhos8hSTSeLTUcCrwcnrndJUZanGJy3fBEsXCiYmynwxHvK5h7XPBadJqD0nG7v65t5N2jPVrnwX2jL4nu+KKSegjUjERKCyWPg=",
"securePayToken": "00acdvbILhNQDPn1**********t1KigCEq51QYqHps",
"bankCode": "Visa Insta"
}'
Card Installment Plan Info Response
The sample code below demonstrates the data structure for an API response.
{
"totalChannel": 1,
"name": "Installment Plan Payment",
"categoryCode": "GCARD",
"groupCode": "IPP",
"iconUrl": "https://d27uu9vmlo4gwh.cloudfront.net/images/v4/images/icon/ipp.png",
"channels": [
{
"sequenceNo": 1,
"name": "HSBC Hong Kong by Visa Instalment ",
"bankShortName": "Visa Insta",
"currencyCodes": [
"HKD"
],
"iconUrl": "https://d27uu9vmlo4gwh.cloudfront.net/images/v4/images/icon/Visa Insta.png",
"logoUrl": "https://d27uu9vmlo4gwh.cloudfront.net/images/v4/images/logo/Visa Insta.png",
"payment": {
"code": {
"channelCode": "IPP"
},
"input": {
"cardNo": "M",
"expiryDate": "M",
"securityCode": "M",
"name": "O",
"email": "O",
"customerNote": "I"
},
"validation": {
"cardNo": null,
"expiryDate": "^(2\\d{3}0?[1-9]|1[012])$",
"securityCode": "^[0-9]{3,4}$",
"name": "^(?!\\s*$)[-a-zA-Z' ''.']{1,}$",
"email": "^(([^<>()\\[\\]\\\\.,;:\\s@\"]+(\\.[^<>()\\[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))$",
"customerNote": "(.*?)",
"additional": {
"cardNo": {
"luhn": true,
"prefixes": [
"420184",
"492111",
"496604",
"436605"
]
},
"amount": null
}
},
"info": {
"terms": "I acknowledge that I agree to be bound by the Terms and Conditions of HSBC Credit Card Interest-free Merchant Instalment Plan. \n\n<a href="https://www.hsbc.com.hk/content/dam/hsbc/hk/docs/credit-cards/interest-free-instalment.pdf" target="_blank ">Terms and Conditions</a>",
"promoUrl": "https://d27uu9vmlo4gwh.cloudfront.net/images/ipppromologo/61.png?v=240930151009",
"plans": [
{
"sequenceNo": 1,
"period": 3,
"interestType": "M",
"interestRate": 0,
"monthlyAmount": 220,
"monthlyInterest": 0,
"currencyCode": "HKD",
"label": "3 months with 0% interest (monthly instalment amount 220.00 HKD)",
"terms": "https://www.hsbc.com.hk/content/dam/hsbc/hk/docs/credit-cards/interest-free-instalment.pdf",
"payLaterPeriod": null,
"IppAdditionalInfo": null,
"DecimalRoundingMode": null,
"processingFixedFee": 0,
"processingPercentage": 0,
"processingAmount": 0
},
{
"sequenceNo": 2,
"period": 6,
"interestType": "M",
"interestRate": 0,
"monthlyAmount": 110,
"monthlyInterest": 0,
"currencyCode": "HKD",
"label": "6 months with 0% interest (monthly instalment amount 110.00 HKD)",
"terms": "https://www.hsbc.com.hk/content/dam/hsbc/hk/docs/credit-cards/interest-free-instalment.pdf",
"payLaterPeriod": null,
"IppAdditionalInfo": null,
"DecimalRoundingMode": null,
"processingFixedFee": 0,
"processingPercentage": 0,
"processingAmount": 0
},
{
"sequenceNo": 3,
"period": 12,
"interestType": "M",
"interestRate": 0,
"monthlyAmount": 55,
"monthlyInterest": 0,
"currencyCode": "HKD",
"label": "12 months with 0% interest (monthly instalment amount 55.00 HKD)",
"terms": "https://www.hsbc.com.hk/content/dam/hsbc/hk/docs/credit-cards/interest-free-instalment.pdf",
"payLaterPeriod": null,
"IppAdditionalInfo": null,
"DecimalRoundingMode": null,
"processingFixedFee": 0,
"processingPercentage": 0,
"processingAmount": 0
}
],
"learnMoreUrl": "https://d27uu9vmlo4gwh.cloudfront.net/images/v4/images/visaipplearnmore/instalments.html",
"termsConsent": true
}
},
"isDown": false,
"CheckEligibleOption": true,
"ippProviderCode": "VISA",
"registrationStatus": "ONBOARDED",
"partnerMerchantRefID": "344344000000032",
"displayProcessingAmount": false
}
],
"validation": {
"cardNo": {
"prefixes": [
"420184",
"492111",
"496604",
"436605"
],
"regex": null
},
"cardTypes": [
{
"sequenceNo": 2,
"name": "VISA",
"prefixes": [
"4"
],
"regex": "^4[0-9]{12}(?:[0-9]{3})?$",
"iconUrl": "https://d27uu9vmlo4gwh.cloudfront.net/images/v4/images/icon/visa.png"
}
]
},
"configuration": {
"payment": {
"tokenize": false,
"tokenizeOnly": false,
"cardTokenOnly": false,
"immediatePayment": false,
"fx": {}
},
"notification": {
"facebook": false,
"whatsApp": false,
"line": false
}
},
"respCode": "0000",
"respDesc": "Success"
}
Updated 3 months ago