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 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-free5-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
- XML
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"
}
]
}
}
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>