Skip to Content
레퍼런스부가 API무이자할부정보

무이자할부정보

카드사별 무이자/부분무이자 할부 정책을 조회합니다. 결제 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