쿠폰

고객이 결제 시 사용할 수 있는 할인 코드를 생성하세요. 퍼센트 또는 고정 금액, 기간 제한 또는 사용 횟수 제한, 일회성 또는 반복 적용이 가능합니다.

쿠폰은 앱의 Admin > Commerce > Products 내 Coupons 섹션과 게시된 앱의 관리자 패널 Cupones 탭에서 관리할 수 있습니다.

쿠폰의 구성 요소

필드	설명
code	고객이 결제 시 입력하는 프로모션 코드 (예: LAUNCH20)
percent_off 또는 amount_off	둘 중 하나만 선택 가능합니다. 퍼센트는 1~100 사이 값이며, 금액은 최소 화폐 단위(센트)로 입력합니다.
currency	amount_off 할인에 필수입니다 (ISO 3자리 통화 코드). 생성 시 입력되어 Stripe로 전달되지만, 이후 API에서는 저장되거나 반환되지 않습니다.
duration	once (첫 번째 결제에만 적용), repeating (duration_in_months 기간 동안 적용), 또는 forever
duration_in_months	duration이 repeating일 때 필수입니다
max_redemptions	모든 고객에 걸친 총 사용 횟수 제한
redeem_by	이 날짜 이후에는 쿠폰이 더 이상 작동하지 않는 만료일
name	고객에게 표시되는 이름
active	삭제하지 않고 쿠폰을 활성화/비활성화할 수 있는 토글

쿠폰 만들기

Coupons 서브 탭에서 Add coupon을 클릭하고 필드를 입력하세요. 자주 사용하는 몇 가지 형태는 다음과 같습니다:

목적	설정
20% 영구 할인	percent_off: 20, duration forever
$10 할인, 1회 사용, 30일 후 만료	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by 30일 후
구독 첫 3개월 50% 할인	percent_off: 50, duration repeating, duration in months 3

또는 AI에게 직접 요청하세요: "Create a LAUNCH20 coupon for 20% off forever."

결제 시 쿠폰 적용

고객이 코드를 사용하는 방법은 두 가지입니다:

• Stripe 결제 페이지에서 — 프로모션 코드 입력란이 자동으로 표시되므로, 별도 작업 없이 고객이 코드를 입력할 수 있습니다.
• 직접 만든 장바구니에서 — 장바구니에 프로모션 코드 입력란을 추가하고, 고객이 입력한 값을 couponCode로 결제 호출에 전달하세요. 서버가 코드를 검증하고 commerce 데이터를 기반으로 할인 금액을 계산하며(브라우저가 제공하는 금액을 사용하지 않음), 주문에 기록하고 올바른 금액이 청구되도록 Stripe 쿠폰을 연결합니다.

AI에게 요청하세요: "Add a promo code field to the cart and apply it at checkout."

목록 조회, 수정, 비활성화

Coupons 서브 탭에는 모든 쿠폰과 각 쿠폰의 제한 횟수 대비 사용 횟수가 표시되므로, 캠페인 성과를 한눈에 파악할 수 있습니다. 아래에서 설명하듯이 편집 기능은 의도적으로 제한되어 있지만, 쿠폰을 삭제하지 않고 비활성화할 수 있으며, 비활성화하면 즉시 결제 시 해당 쿠폰이 작동하지 않습니다.

참고 사항 및 제한

• 코드와 할인 금액은 수정할 수 없습니다. 표시 name을 업데이트하거나 active를 토글할 수는 있지만, percent_off, amount_off, code 자체는 변경할 수 없습니다. 다른 조건이 필요하다면 새 쿠폰을 만드세요.
• times_redeemed 는 자동으로 증가하며 읽기 전용입니다 — 캠페인 성과 추적에 유용합니다.
• 쿠폰은 주문 단위가 아닌 고객 단위로 적용됩니다 — 쿠폰이 forever로 설정된 경우, 고객이 구독하면 모든 갱신 결제에 할인이 적용됩니다.