무이자할부정보
카드사별 무이자/부분무이자 할부 정책을 조회합니다. 결제 UI에서 할부 옵션을 노출하기 전에 사용하세요.
무이자할부
무이자할부정보 조회 API의 성공 응답은 InterestFreeInstallments 객체로 반환됩니다.
InterestFreeInstallments 객체
interface InterestFreeInstallmentsResponse {
period: {
/**
* 무이자 정책 시작일
* 형식: YYYY-MM-DD
*/
startDate: string
/**
* 무이자 정책 종료일
* 형식: YYYY-MM-DD
*/
endDate: string
}
/**
* 전체무이자 할부 카드 정책 목록
*/
interestFreeInstallmentCards: {
/**
* 카드사 코드
*/
issuer: CardCompany
/**
* 무이자할부 적용 최소 결제 금액(원)
*/
minimumAmount: number
installmentMonth: {
/**
* 지원 최소 할부 개월
*/
min: number
/**
* 지원 최대 할부 개월
*/
max: number
}
}[]
/**
* 부분무이자 할부 카드 정책 목록
*/
partialInterestFreeInstallmentCards: {
/**
* 카드사 코드
*/
issuer: CardCompany
/**
* 부분무이자 적용 최소 결제 금액(원)
*/
minimumAmount: number
plan: {
/**
* 전체 할부 개월 수
*/
month: number
customerInterestMonthRange: {
/**
* 고객 이자 부담 시작 회차
*/
start: number
/**
* 고객 이자 부담 종료 회차
*/
end: number
}
}[]
}[]
}무이자할부정보 조회
Request
GET https://api.candypay.co.kr/installments/interest-free-months요청 본문과 쿼리 파라미터는 없습니다.
Response
성공
아래는 응답 데이터의 일부 예시입니다.
{
"period": {
"startDate": "2026-02-01",
"endDate": "2026-02-29"
},
"interestFreeInstallmentCards": [
{
"issuer": "SAMSUNG",
"minimumAmount": 50000,
"installmentMonth": {
"min": 2,
"max": 6
}
},
{
"issuer": "HYUNDAI",
"minimumAmount": 50000,
"installmentMonth": {
"min": 2,
"max": 5
}
},
// ...
],
"partialInterestFreeInstallmentCards": [
{
"issuer": "SHINHAN",
"minimumAmount": 50000,
"plan": [
{
"month": 10,
"customerInterestMonthRange": {
"start": 1,
"end": 2
}
}
]
},
{
"issuer": "WOORI",
"minimumAmount": 50000,
"plan": [
{
"month": 12,
"customerInterestMonthRange": {
"start": 1,
"end": 3
}
}
]
},
// ...
]
}무이자할부정보 조회에 성공하면 InterestFreeInstallmentsResponse 객체가 반환됩니다.
실패
조회 데이터가 준비되지 않았거나 내부 처리 중 오류가 발생하면 500 Internal Server Error가 반환될 수 있습니다.
{
"statusCode": 500,
"message": "Not Found WELCOME_INSTALLED_CRWALLED"
}그 외 실패 응답 형식은 에러 객체를 참고하세요.
주의사항
- 크롤링 원본 형식이 예상과 다르면
period.startDate,period.endDate가 빈 문자열로 반환될 수 있습니다. - 크롤링 행 파싱 실패 시 카드 목록 배열 내부에
null항목이 포함될 수 있습니다.
Last updated on