Skip to main content

Interest-Free Installment Inquiry

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

주의사항
  • Excessive API calls may result in temporary restrictions on service usage. If abnormal usage persists, access may be restricted without prior notice.

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 NameTypeLengthRequiredDescription
MallIdString8Byte✅Merchant ID assigned by KICC
OutputTypeString4ByteOptionalResponse 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 NameTypeLengthDescription
M{Merchant ID}Object9ByteTop-level object in the format of "M" + Merchant ID (e.g., MT0001997)
CardInfoArray List of interest-free installment information (See CardInfo below)

CardInfo (Interest-Free Installment Info)​

Field NameTypeLengthDescription
CardCodeString3ByteCard Company Code
CardNameString50ByteCard Company Name
CardTypeString10ByteCard payment type (e.g., ISP, MPI, etc.)
CardEventStringVariableInterest-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.
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"
      }
    ]
  }
}