메인 콘텐츠로 건너뛰기
Discount codes overview cover
할인 코드는 타겟 프로모션 및 인센티브를 실행할 수 있게 해줍니다. 비율 또는 고정 금액 할인을 생성하고, 한도 및 만료일을 설정하며, 제품에 제한을 두고, 체크아웃에서 원활하게 적용할 수 있습니다.

Checkout Sessions

호스티드 체크아웃 중에 discount_code 및 UI 컨트롤을 사용하여 코드를 적용하세요.

Validate Discount

할인 ID로 유효성을 확인하세요.

Get Discount by Code

코드 이름(예: “SAVE20”)을 사용해 할인을 조회하고 유효성을 확인하세요.

Create Discount (API)

프로그래밍 방식으로 새로운 할인 코드를 생성하세요.

List & Update Discounts

기존 할인을 찾아보고, 필요에 따라 업데이트하거나 삭제하세요.

​
할인 코드란?

할인 코드는 결제 시 주문 총액을 줄여주는 프로모션 토큰입니다. 다음과 같은 경우에 적합합니다:
  • 계절 캠페인: 블랙 프라이데이, 제품 출시 또는 기념일
  • 획득 제안: 첫 구매 인센티브 또는 추천 보상
  • 유지: 기존 고객을 위한 재유치 또는 충성도 보상
  • B2B 거래: 계약된 또는 협상된 가격을 통한 비공식 코드

​
주요 이점

  • 유연한 할인: 비율 또는 고정 금액 할인
  • 대상 제어: 제품 및 구독 주기에 따라 제한
  • 캠페인 관리: 만료 날짜 및 사용 한도
  • 원활한 결제: 결제 세션을 통한 UI 필드 및 API 지원

​
할인 코드 생성

Dodo Payments 대시보드에서 할인 코드를 생성한 후, 호스팅된 결제 또는 API를 통해 적용합니다.

​
대시보드 설정

  • 할인 이름 (필수): 내부 및 대시보드 표시 이름
  • 코드 (필수): 고객이 결제 시 입력하는 문자열
  • 유형 및 금액 (필수): 비율 또는 고정 금액 값을 설정하거나 제공된 버튼을 사용하여 무작위 코드를 생성합니다.
  • 만료 날짜 (선택 사항): 코드가 무효가 되는 날짜
  • 사용 한도 (선택 사항): 모든 고객에 대한 최대 총 사용 횟수
  • 제품 제한 (선택 사항): 선택한 제품에만 적용 가능하도록 제한
  • 구독 주기 제한 (선택 사항): 할인이 적용되는 청구 주기 수
  • 할인 이름 (필수): 내부 및 대시보드에 표시되는 이름
  • 코드 (필수): 고객이 결제 시 입력하는 문자열
  • 유형 및 금액 (필수): 백분율 또는 고정 금액 값을 설정하거나 제공된 버튼을 사용하여 무작위 코드를 생성합니다.
  • 만료 날짜 (선택 사항): 코드가 무효화되는 날짜
  • 사용 제한 (선택 사항): 모든 고객에 걸친 최대 총 사용 횟수
  • 제품 제한 (선택 사항): 선택한 제품에 대한 적용 제한
  • 구독 주기 제한 (선택 사항): 할인이 적용되는 청구 주기의 수
  • 메타데이터 (선택 사항): 내부 추적 또는 통합을 위한 사용자 정의 키-값 쌍을 첨부합니다.

​
결제 경험

  1. 쇼핑객이 결제 필드에 코드를 입력합니다.
  2. 적격 할인 적용 후 총액이 즉시 업데이트됩니다.
Checkout Sessions에서 코드를 미리 적용하려면 discount_code를 전달하고, 입력 필드를 표시하려면 feature_flags.allow_discount_code를 설정하세요.

​
API 관리

유형과 금액을 지정하여 프로그래밍 방식으로 할인 코드를 생성하세요.

API Reference

할인 생성 API를 확인하세요.
관리 및 감사 목적으로 모든 할인 목록을 가져오거나 세부 정보를 조회하세요.

API Reference

목록 조회 및 검색 API를 살펴보세요.
내부 ID 대신 사람이 읽을 수 있는 코드(예: “SAVE20”)로 할인을 조회하세요.

API Reference

코드 이름으로 할인을 조회하세요.
금액, 만료 또는 제한과 같은 할인 구성을 수정하세요.

API Reference

할인 세부 정보를 업데이트하는 방법을 알아보세요.
할인을 적용하기 전에 유효하고 적용 가능한지 확인하세요.

API Reference

할인 사용을 검증하세요.
더 이상 필요하지 않은 할인을 비활성화하거나 제거하세요.

API Reference

할인을 삭제하세요.

​
일반적인 사용 사례

  • 소개 제안: 신제품에 대한 한정 시간 출시 프로모션
  • 대량 또는 B2B: 선택된 제품 세트에 대한 계약 할인
  • 유지 전략: 이탈 방지 워크플로우에서 재유치 코드
  • 계절 캠페인: 휴일 또는 이벤트 기반 프로모션

​
통합 예시

​
결제 세션에서 할인 적용

할인을 미리 적용하고 코드 입력 UI를 표시합니다.

​
메타데이터가 있는 할인 생성

내부 추적을 위한 사용자 정의 키-값 쌍을 첨부합니다. 
const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});
메타데이터를 사용하여 캠페인, 출처 또는 내부 참조 ID별로 할인을 태그 지정하여 추후 사용 내역을 조정하고 ROI를 측정할 수 있습니다.

​
결제 세션에서 할인 적용

할인을 미리 적용하고 코드 입력 UI를 표시합니다. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​
요금제 변경 중 할인 적용

고객이 구독을 업그레이드하거나 다운그레이드할 때 프로모션 가격을 제공합니다. 
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
구독에 이미 preserve_on_plan_change=true 할인이 있고 새 코드를 전달하지 않으면 기존 할인은 새 제품에 적용되는 경우 자동으로 유지됩니다.

​
사전 적용 없이 할인 코드 입력 활성화

고객이 사전 입력 없이 결제 시 코드를 입력할 수 있도록 합니다. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

​
모범 사례

  • 명확하게 이름 지정: 캠페인 이름과 일치하는 인식 가능한 코드 사용
  • 시간 제한: 긴급성을 높이고 잘못된 사용을 방지하기 위해 만료 추가
  • 신중하게 범위 설정: 특정 제품에 한정하여 마진 손실을 방지
  • 조기에 검증: 결제 확인 전에 코드 적용 가능성 확인
  • 영향 모니터링: 캠페인별 사용 및 전환 추적
할인 코드는 획득 및 유지에 강력한 수단입니다. 단순하고 명확한 제안으로 시작하고 철저히 검증하며 성능에 따라 반복하십시오.
Last modified on April 20, 2026