Skip to main content

Query Interest-free Installments

This API queries interest-free installment information provided by card acquirers.

Request​

Important: Domain Difference

Please note that the API domain for this service differs from other APIs.

  • Development Server: testpg.easypay.co.kr
  • Production Server: pg.easypay.co.kr
Request URL
POST https://{Domain}/etcservice/InquiryCardEventInfoAction.do
Content-type: application/json; charset=euc-kr

Parameters​

Field NameTypeLengthRequiredDescription
MallIdString8Byte✅Merchant ID assigned by KICC
OutputTypeString4Byte✅Response Format
Jackson JSON: "JSON", XML: "XML"
Request Example
{  
    "MallId": "{Merchant ID}", 
    "OutputType": "JSON"
}

Response​

Parameters​

Field NameTypeLengthRequiredDescription
MallIdString9Byte✅"M" + Merchant ID
(Prefix "M" is added to prevent JSON Root format errors)
CardInfoArrayInterest-free Installment Info (See CardInfo below)

CardInfo (Installment Info)​

Field NameTypeLengthRequiredDescription
CardCodeString3Byte✅Card Company Code
CardNameString50Byte✅Card Name
CardEventStringVariable✅Installment Conditions string.
Format: MinAmount + "-" + Month + ":" + Month + "^"
Parsing 'CardEvent' String

Please pay attention to the delimiters and units.

  • Unit: 10,000 KRW (e.g., '5' represents 50,000 KRW).
  • Delimiters: - (Amount separator), : (Month separator), ^ (Condition separator).

Examples:

  • 50,000 KRW+ for 2~6 months: 5-2:3:4:5:6
  • Condition 1 (50k+ for 23 mo) AND Condition 2 (100k+ for 46 mo): 5-2:3^10-4:5:6
Response Example
{
    "M{MerchantID}": {
        "CardInfo": [
            {
                "CardCode": "026",
                "CardName": "BC Card",
                "CardEvent": "5-2:3:4:5:6"
            },
            {
                "CardCode": "029",
                "CardName": "Shinhan Card",
                "CardEvent": "5-2:3:^10-4:5:6:7:8:9:10:11:12"
            }
        ]
    }
}