Interest-Free Installment Inquiry

This is an API for inquiring about interest-free installments based on the card acquirer.

Request

Caution

Please note that the API domain is different from other APIs.

• Development Server: testpg.easypay.co.kr
• Production Server: pg.easypay.co.kr

Request URL

GET https://{Inquiry Domain}/etcservice/InquiryCardEventInfoAction.do?MallId={Merchant ID}&OutputType={Response Format}

The request body is not used.

Parameters

Field Name	Type	Length	Required	Description
MallId	String	8Byte	✅	Merchant ID assigned by KICC
OutputType	String	4Byte	Optional	Response format (JSON or XML). Default settings apply if the parameter is omitted

Request Example

GET https://testpg.easypay.co.kr/etcservice/InquiryCardEventInfoAction.do?MallId=T0001997&OutputType=JSON

Response

Parameters

Field Name	Type	Length	Description
M{Merchant ID}	Object	9Byte	Top-level object in the format of "M" + Merchant ID (e.g., MT0001997)
CardInfo	Array		List of interest-free installment information (See CardInfo below)

CardInfo (Interest-Free Installment Info)

Field Name	Type	Length	Description
CardCode	String	3Byte	Card Company Code
CardName	String	50Byte	Card Company Name
CardType	String	10Byte	Card payment type (e.g., ISP, MPI, etc.)
CardEvent	String	Variable	Interest-free installment conditions (Minimum Installment Amount-Installment Months:Installment Months...)

Interest-Free Installment Conditions (CardEvent)

Please carefully check the delimiters according to the conditions.

• 5-2:3:4:5:6: 50,000 KRW or more, 2~6 months interest-free
• 5-2:3:7:8^20-2:3:7:8:14: 50,000 KRW or more, 2, 3, 7, 8 months interest-free / 200,000 KRW or more, 2, 3, 7, 8, 14 months interest-free
• If there are multiple conditions, they are separated by the ^ symbol.

JSON

Response Example

{
  "MT0001997": {
    "CardInfo": [
      {
        "CardCode": "011",
        "CardName": "Jeju",
        "CardType": "ISP",
        "CardEvent": "5-2:3"
      },
      {
        "CardCode": "047",
        "CardName": "Lotte",
        "CardType": "MPI",
        "CardEvent": "5-2:3:4:5:6^10-2:3:4:5:6:7:8:9:10"
      }
    ]
  }
}

XML

Response Example

<?xml version="1.0" encoding="EUC-KR"?>
<MT0001997>
  <CardInfo>
    <CardCode>011</CardCode>
    <CardName>Jeju</CardName>
    <CardType>ISP</CardType>
    <CardEvent>5-2:3</CardEvent>
  </CardInfo>
  <CardInfo>
    <CardCode>047</CardCode>
    <CardName>Lotte</CardName>
    <CardType>MPI</CardType>
    <CardEvent>5-2:3:4:5:6^10-2:3:4:5:6:7:8:9:10</CardEvent>
  </CardInfo>
</MT0001997>