무이자할부정보

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

요청 본문은 없습니다. 인증 없이 조회하면 PAYSTORY의 무이자할부정보를 반환합니다.

pg 쿼리 파라미터를 지정하면 인증 없이도 해당 PG사의 정보를 반환합니다. pg에는 WELCOME 또는 PAYSTORY를 입력할 수 있습니다.

클라이언트 키를 함께 보내고 pg를 생략하면 키에 연결된 가맹점의 허용 PG사를 기준으로 적합한 PG사의 정보를 반환합니다.

GET https://api.candypay.co.kr/installments/interest-free-months?pg=WELCOME
Authorization: Basic {clientKey}:

pg를 지정한 경우에는 클라이언트 키 유무와 관계없이 지정한 PG사의 정보를 반환합니다.

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 항목이 포함될 수 있습니다.