할인

​

할인 코드란?

• 유연한 할인: 비율 또는 고정 금액 할인
• 대상 제어: 제품 및 구독 주기에 따라 제한
• 캠페인 관리: 만료 날짜 및 사용 한도
• 원활한 결제: 결제 세션을 통한 UI 필드 및 API 지원
• 유연한 할인: 백분율 기반 또는 정액 기반 할인
• 중첩 가능한 코드: checkout, 결제 또는 subscription당 최대 20개 코드 적용
• 타겟 제어: 제품, subscription 주기 및 고객 자격에 따른 제한
• 캠페인 관리: 예약된 시작일, 만료일, 전체 및 고객별 사용 한도
• 통화별 가격 설정: 각 통화별 정액 차감액, 금액 상한 및 최소 소계 설정

​

대시보드 설정

​

Dashboard 설정

• Discount Name (필수): Dashboard에서 사용할 내부 레이블입니다.
• Code (필수): 고객이 checkout에서 입력하는 문자열입니다. 무작위 코드를 생성하거나 직접 입력할 수 있습니다(최소 3자, 자동으로 대문자 변환).
• Type (필수): Percentage(일정 비율 할인) 또는 Amount(정액 차감)입니다.
• Amount (필수): 백분율의 경우 Dashboard에서 할인할 비율입니다(예: 15(15%)). API에서는 동일한 값이 basis points로 표시됩니다(1500). 금액의 경우 코드의 기본 통화로 표시되는 정액 차감액입니다.
• Start Date (선택 사항): 향후 날짜에 코드가 활성화되도록 예약합니다. 즉시 활성화하려면 비워 두세요.
• Expiration Date (선택 사항): 해당 날짜 이후에는 코드를 사용할 수 없습니다.
• Usage Limit (선택 사항, Advanced 아래): 모든 고객을 대상으로 한 최대 총 사용 횟수입니다.
• Per-Customer Usage Limit (선택 사항, Advanced 아래): 단일 고객이 사용할 수 있는 최대 횟수입니다. 두 값을 모두 설정하는 경우 전체 사용 한도보다 작거나 같아야 합니다.
• Customer Eligibility (선택 사항): 사용 가능한 고객을 제한합니다 — 모든 고객, 첫 구매 고객, 기존 고객 또는 직접 선택한 목록 중에서 지정할 수 있습니다.
• Currency Options (선택 사항): 판매하는 각 통화별 할인 금액입니다. 통화별 옵션을 참조하세요.
• Product Restriction (선택 사항): 코드를 특정 제품으로 제한합니다.
• Subscription Cycle Limit (선택 사항, Advanced 아래): 할인이 적용되는 결제 주기 수입니다. 무기한으로 적용하려면 비워 두세요.
• Preserve on Plan Change (선택 사항): subscription의 플랜이 변경될 때 할인을 계속 활성 상태로 유지합니다(preserve_on_plan_change).
• Metadata (선택 사항): 내부 추적을 위한 사용자 지정 키–값 쌍을 추가합니다.
• Require a minimum order value (선택 사항, Advanced 아래): 코드가 적용되기 위한 통화별 최소 장바구니 소계입니다.

​

할인 유형

​

고객 자격

​

통화별 옵션

• Amount — Amount 할인인 경우 해당 통화로 표시되는 정액 차감액이며, Percentage 할인인 경우 최대 할인 상한입니다. API에서는 max_amount_possible에 매핑됩니다.
• Default — 하나의 통화를 기본 통화로 지정합니다. 설정되지 않은 통화는 이 기본 통화에서 환산됩니다.

• Minimum subtotal — 해당 통화의 장바구니 소계가 이 금액에 도달한 경우에만 코드가 적용됩니다. 0는 최소 금액이 없음을 의미합니다.

​

Checkout 경험

​

Discount Codes 중첩

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

API 관리

​

일반적인 사용 사례

• 도입 프로모션: 신규 상품을 위한 기간 한정 출시 프로모션
• 대량 구매 또는 B2B: 특정 상품 세트를 위한 계약 할인
• 고객 유지 전략: 이탈 방지 워크플로의 재유치 코드
• 시즌 캠페인: 휴일 또는 이벤트 기반 프로모션

​

통합 예시

​

Metadata를 사용하여 할인 생성

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Checkout Sessions에서 할인 적용

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

플랜 변경 중 할인 적용

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

할인 코드 필드 숨기기

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

모범 사례

• 명확한 이름 사용: 캠페인 이름과 일치하는 알아보기 쉬운 코드를 사용하세요.
• 기간 제한: 긴급성을 높이고 오용을 방지하려면 만료일을 추가하세요.
• 범위 현명하게 설정: 마진 누수를 방지하려면 특정 제품으로 제한하세요.
• 사전 검증: checkout을 확정하기 전에 코드 적용 가능 여부를 확인하세요.
• 영향 모니터링: 캠페인별 사용량과 전환을 추적하세요.