할인

​

할인 코드란?

• 계절 캠페인: 블랙 프라이데이, 제품 출시 또는 기념일
• 획득 제안: 첫 구매 인센티브 또는 추천 보상
• 유지: 기존 고객을 위한 재유치 또는 충성도 보상
• B2B 거래: 계약된 또는 협상된 가격을 통한 비공식 코드

​

주요 이점

• 유연한 할인: 비율 또는 고정 금액 할인
• 대상 제어: 제품 및 구독 주기에 따라 제한
• 캠페인 관리: 만료 날짜 및 사용 한도
• 원활한 결제: 결제 세션을 통한 UI 필드 및 API 지원
• 유연한 할인: 백분율 또는 고정 금액 할인
• 중첩 가능한 코드: checkout, payment 또는 subscription당 최대 20개의 코드를 적용하고, 별도의 전용 코드를 만들지 않고 캠페인을 결합할 수 있습니다(예: WELCOME10 + BLACKFRIDAY20)
• 세분화된 제어: product, subscription cycles 및 customer eligibility에 따라 제한
• 캠페인 관리: 예약된 시작일, 만료일, 전체 및 고객별 사용 한도
• 통화별 가격 책정: 통화별 고정 차감액, 금액 상한 및 최소 소계를 설정
• 원활한 checkout: checkout sessions를 통한 UI 필드 및 API 지원

​

대시보드 설정

​

대시보드 설정

• Discount Name (필수): 내부 및 대시보드 표시 이름
• Code (필수): 고객이 checkout에서 입력하는 문자열입니다. 제공된 버튼을 사용해 무작위 코드를 생성할 수도 있습니다.
• Type (필수): Percentage(일정 비율 할인) 또는 Amount(고정 금액 차감) 중에서 선택
• Amount (필수): Percentage 할인의 백분율 값 또는 Amount 할인의 고정 금액
• Start Date (선택 사항): 코드가 나중에 활성화되도록 예약합니다. 즉시 활성화하려면 비워 둡니다.
• Expiration Date (선택 사항): 이 날짜 이후 코드가 무효화됩니다.
• Usage Limit (선택 사항): 모든 고객을 대상으로 한 최대 총 사용 횟수
• Per-Customer Usage Limit (선택 사항): 단일 고객이 사용할 수 있는 최대 횟수입니다. 두 한도를 모두 설정하는 경우 전체 사용 한도보다 작거나 같아야 합니다.
• Customer Eligibility (선택 사항): 코드를 사용할 수 있는 대상을 제한합니다 — 모든 고객, 신규 고객, 기존 고객 또는 직접 선택한 목록
• Currency Options (선택 사항): 통화별 값 — Per-Currency Options 참조
• Product Restriction (선택 사항): 선택한 product에만 적용되도록 제한
• Subscription Cycle Limit (선택 사항): 할인이 적용되는 billing cycle 수
• Preserve on Plan Change (선택 사항): subscription의 plan이 변경되어도 할인을 활성 상태로 유지 (preserve_on_plan_change)
• Metadata (선택 사항): 내부 추적 또는 통합을 위한 사용자 지정 key–value 쌍 추가

​

할인 유형

​

고객 자격

​

통화별 옵션

• Amount — Amount 할인에서는 차감액 자체이고, Percentage 할인에서는 코드가 차감할 수 있는 최대 금액입니다. API의 max_amount_possible에 매핑됩니다.
• Minimum subtotal — cart가 이 소계에 도달한 경우에만 코드가 적용됩니다. 0는 최소 금액이 없음을 의미합니다.
• Default — 구성되지 않은 다른 통화가 변환될 기준으로 사용할 기본 항목을 하나 지정할 수 있습니다.

​

Checkout 경험

1. 고객이 checkout 필드에 코드를 입력합니다.
2. 자격을 충족하는 할인이 적용되고 합계가 즉시 업데이트됩니다.

​

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 관리

​

일반적인 사용 사례

• Intro offers: 신규 product를 위한 기간 한정 출시 프로모션
• Bulk 또는 B2B: 특정 product 세트를 위한 계약 할인
• Retention 전략: churn-prevention workflow에서 고객 재유치를 위한 코드
• Seasonal campaigns: holiday 또는 event 기반 프로모션

​

통합 예시

​

Metadata를 사용한 discount 생성

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

​

Checkout Sessions에서 discount 적용

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'
});

​

plan 변경 중 discount 적용

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'
});

​

모범 사례

• 명확한 이름 사용: campaign 이름과 일치하는 알아보기 쉬운 코드 사용
• 기간 제한: 긴급성을 높이고 오용을 방지하도록 만료일 추가
• 범위 신중하게 설정: margin leakage를 방지하기 위해 특정 product로 제한
• 조기 검증: checkout을 확정하기 전에 코드 적용 가능 여부 확인
• 영향 모니터링: campaign별 사용량 및 전환 추적