프로모션은 유입, 전환, 유지에 강력한 레버입니다. 동시에 만만치 않게 복잡합니다. 단순한 “10OFF” 코드가 금세 중복 할인, 고유 바우처, 무료 체험, 첫 주문 규칙, 파트너 캠페인, 갱신 인센티브, 구독 비례 정산(proration), 지역별 세금 특이점으로 확대됩니다. 초기에 제대로 설계하지 않으면 디버깅하기 어렵고 악용되기 쉬운 취약한 로직을 배포하게 됩니다.
이 가이드는 SaaS와 온라인 스토어를 위한 견고한 프로모션·쿠폰 시스템 아키텍처를 다룹니다. 데이터 모델, 할인 계산 파이프라인, 중복 적용(스태킹) 규칙, 구독 특수성, 보안과 남용 방지, UX, API, 애널리틱스, 테스트를 모두 포함합니다. 또한 자연어로 소프트웨어를 만드는 AI 플랫폼인 YeshBe와 함께 구현을 가속화할 수 있는 실전 프롬프트도 제공합니다. YeshBe는 기성 프로모션 모듈을 제공하지 않습니다. 대신 비즈니스에 맞춘 시스템을 직접 구축하도록 도와줍니다.
할인 유형보다 먼저, 프로모션 라이프사이클부터
대부분의 팀은 할인 수식(예: “20% 할인”)부터 구현하고 적격성은 나중에 생각합니다. 순서를 바꾸세요. 먼저, 프로모션이 시스템에서 존재하는 전체 라이프사이클을 정의합니다:
- 작성(Authoring): 마케터나 관리자(Admin)가 프로모션을 생성하고, 제약을 설정하고, 대상 오디언스를 연결하고, 코드를 생성합니다.
- 발견(Discovery): 사용자가 랜딩 페이지, 이메일, 인앱 넛지에서 혜택을 발견합니다.
- 검증(Validation): 장바구니, 체크아웃 또는 견적 흐름에서 적격성을 평가하고 가격을 계산합니다.
- 적용(Redemption): 주문, 구독 또는 인보이스에 혜택이 적용되고, 사용 한도가 차감됩니다.
- 측정(Measurement): 귀속과 리프트 분석을 통해 사용 내역을 캠페인에 연결합니다.
- 거버넌스(Governance): 감사, 변경 이력, 남용 플래그, 통제된 롤아웃을 다룹니다.
각 단계를 명시적으로 설계하세요. 많은 “엣지 케이스”는 실제로 엣지가 아니라 빠진 라이프사이클 단계입니다.
핵심 개념과 데이터 모델
최소이면서 유연한 모델은 보통 다음 엔터티를 포함합니다:
- Promotion: 상위 캠페인 또는 오퍼 정의(예: “Black Friday 2026”). 메타데이터, 적격성 규칙, 할인 액션, 유효 기간, 스태킹(중복 적용) 정책, 사용 한도를 보유합니다.
- Coupon (Code): 선택적 코드로 하나의 프로모션에 연결됩니다. 공개 코드(예: “BF2026”), 제한적 공유 코드, 수신자별 1회용 고유 코드가 가능합니다. 모든 로직을 코드 자체에 넣지 마세요.
- Condition: 적격성 규칙: 고객 첫 주문, 플랜 in [Pro, Team], 국가 in [US, CA], 최소 소계 ≥ $100, 채널 = email, 고객 세그먼트 = 학생 등.
- Action (Discount): 적격일 때의 동작: 퍼센트 할인, 정액 할인, N일 무료, 아이템 단위 할인, 주문 단위 할인, 배송비 할인(이커머스), 무료 애드온, 크레딧 잔액 등.
- Redemption: 특정 고객이 특정 과금 엔터티(장바구니/주문/구독/인보이스)에 해당 프로모션/쿠폰을 사용한 기록으로, 금액, 타임스탬프, 결과를 포함합니다.
관계형 스케치 예시:
{ promotions: { id, name, status, starts_at, ends_at, channel_restrictions, stacking_policy, max_redemptions_global, max_redemptions_per_customer, priority, currency_scope, discount_scope, created_by, created_at, updated_at }, promotion_conditions: { id, promotion_id, type, operator, value_json // e.g., type=customer.is_first_purchase, operator=equals, value_json=true // e.g., type=order.subtotal, operator=gte, value_json=10000 (cents) }, promotion_actions: { id, promotion_id, type, value_json // e.g., type=percent_off, value_json={"percent":20, "max_amount_cents":5000} // e.g., type=fixed_amount_off, value_json={"amount_cents":2000} // e.g., type=trial_extension_days, value_json={"days":14} }, coupons: { id, promotion_id, code_hash, code_hint, is_unique, max_redemptions, expires_at, created_by }, redemptions: { id, promotion_id, coupon_id, customer_id, order_id, subscription_id, applied_amount_cents, currency, status, error_code, created_at, idempotency_key } }왜 code_hash만 저장하고 평문 코드는 저장하지 않을까요? 내부 유출을 완화하고, 로그나 내보내기에서 실제 코드가 노출되는 일을 피하기 위해서입니다. 지원을 위한 조회용으로 code_hint(예: 마지막 4자)를 유지하세요.
주요 할인 액션과 적용 범위
- 주문 단위 퍼센트/정액 할인: 소계에 적용합니다(사전/사후 세금 적용은 비즈니스 규칙으로 정의; 지역별 요구사항이 다를 수 있음).
- 아이템 단위 할인: SKU, 플랜, 태그 등 적격 아이템에만 적용. 번들 또는 좌석(시트) 단위 할인에 유용합니다.
- 크레딧 잔액: 계정 크레딧을 적립해 이후 인보이스에서 차감. B2B 계약이나 고객 케어에 적합합니다.
- 체험(Trial) 연장: 구독 체험에 N일 무료를 추가합니다(무기한 누적 방지 장치가 필요).
- 무료 애드온/기능 언락: 일정 기간 계량형 또는 권한 기반 기능을 부여합니다.
scope를 명확히 모델링하세요: 주문, 라인 아이템, 구독, 인보이스, 계정 크레딧 등. 이는 혜택을 어떻게 계산·저장·만기 처리할지에 직접 영향을 줍니다.
적격성과 제약: 명시적으로
수식을 작성하기 전에, 마케팅과 재무가 필요로 하는 제약 조건을 목록화하세요:
- 기간 및 블랙아웃 기간
- 채널 제약(예: source=“email”일 때만 적용)과 허용 목록 리퍼러
- 고객 적격성(첫 주문, 특정 플랜 신규, 학생, 지역)
- 주문 임계값(최소 소계, 최소 좌석 수)
- 상품/플랜 포함·제외 목록
- 사용 한도(글로벌, 고객당, 코드당)
- 중복 적용 규칙(배타적 vs 결합 가능, 총 할인 상한)
조건을 구조화된 규칙으로 표현해 코드 변경 없이 추가·테스트·폐기가 가능하도록 하세요. 평가에 사용한 원시 입력(예: 장바구니 라인, 고객 속성)을 저장해 재생(replay)과 감사를 지원하세요.
계산 순서, 중복 적용, 라운딩
적용 순서에 따라 결과가 달라집니다. 예측 가능하도록 규칙을 공개하세요:
- 후보 프로모션 찾기: 상태, 기간, 채널, 테넌트, 통화로 필터링합니다.
- 조건 검증: 장바구니/구독 및 고객 컨텍스트에 대해 적격성을 평가합니다.
- 충돌 및 중복 적용 해결: 우선순위, 배타성, 상한으로 정렬합니다. 대표 패턴:
- “배타적” 프로모션은 다른 모든 것을 차단합니다.
- “결합 가능” 프로모션은 상한에 도달할 때까지 우선순위 순으로 적용합니다.
- 아이템 단위 할인과 주문 단위 할인 중 어느 것을 먼저 적용할지 하나를 정해 문서화하세요.
- 할인 계산: 적용되는 각 액션에 대해 할인 금액을 계산하고, 액션별 최대 상한을 준수합니다.
- 라운딩과 통화: 아이템의 최소 통화 단위에서 라운딩 후 합산하거나, 끝에서 한 번만 라운딩—하나를 선택해 일관되게 유지하세요. 다중 통화는 프로모션을 특정 통화로 범위 지정하거나, 표시용으로만 고정 환율을 사용하세요.
- 세금과 수수료: 할인 적용이 세금/수수료 전인지 후인지 결정합니다. 세금 처리는 관할 지역별로 상이할 수 있으니 세무 자문을 구하세요.
UI에서 내역을 노출해 고객이 무엇이 일어났는지 이해할 수 있게 하세요. 지원 이슈 트러블슈팅에도 도움이 됩니다.
구독: 체험, 비례 정산, 갱신
SaaS에는 고유한 고려사항이 있습니다:
- 체험(Trial) 프로모션: 체험을 연장하되 총 기간에 상한을 둡니다. 필요한 경우 합법적 범위 내에서 이메일/계정/결제수단 지문 등을 통해 고객당 제한을 추적해 “체험 반복” 악용을 방지하세요.
- 첫 사이클 할인: 첫 인보이스에만 적용되고 갱신 시 재적용되지 않도록 보장하세요.
- 반복 할인: N개 사이클 동안 적용(예: 3개월 30% 할인). 구독의 할인 상태에 잔여 사이클 수를 저장하세요.
- 비례 정산(proration): 사이클 중간 플랜 변경 시 남은 혜택을 재계산해야 합니다. 퍼센트를 비례 금액에 재적용할지, 혜택을 크레딧으로 전환할지 결정하세요.
- 업그레이드 vs 다운그레이드: 명확한 규칙이 필요합니다. 플랜 변경 시 할인이 유지되는지, 어떤 조건에서 유지/종료되는지 정의하세요.
보안과 남용 방지
인기 프로모션에는 창의적인 악용 시도가 따릅니다. 초기에 가드레일을 구축하세요:
- 코드 엔트로피와 레이트 리밋: 고유 바우처에는 충분히 길고 다양한 문자로 코드를 생성하세요. 코드 검증 시도를 레이트 리밋하고, 명백한 무차별 대입을 차단하세요.
- 코드 해시 저장: 평문 대신 해시(예: 비밀을 포함한 HMAC)로 저장하고 검증 시 해시를 비교하세요.
- 적격성 검증: “신규 고객 전용”이라면 플러스 주소 등 사소한 변경으로 우회되지 않도록 하세요. 결제수단 지문이나 과거 청구 이력 확인을 고려하되 오탐과 프라이버시를 주의하세요.
- 채널·도메인 제약: 특정 프로모션은 서명된 링크를 요구하거나, 파트너십의 경우 검증된 이메일 도메인으로 제한하세요.
- 멱등 적용: 모든 적용/제거 작업은 멱등 키를 사용해 재시도 중 이중 적용을 방지하세요.
- 감사 로그: 프로모션 생성/수정, 코드 내보내기, 사용 한도 변경을 기록하고, 역할/권한으로 접근을 제한하세요.
- 환불 정책: 환불 시 할인과의 상호작용을 명확히 정의해 “할인 차익”을 노린 악용을 방지하세요.
API와 연동 포인트
프런트엔드가 체크아웃, 셀프서브 구독 흐름, 영업 지원 견적 도구 중 무엇이든 간에, 명확한 API를 제공하세요:
- POST /pricing/estimate: 장바구니 또는 구독 상태를 입력받아 적용된 프로모션을 포함한 가격 내역을 반환합니다(읽기 전용, 부작용 없음).
- POST /promotions/validate: 코드를 검증하고 적격성 및 예상 할인 정보를 반환합니다.
- POST /orders/:id/apply-promotion: 멱등 키를 사용해 특정 보류 주문 또는 견적에 프로모션을 적용합니다.
- DELETE /orders/:id/promotion: 허용되는 경우 주문에서 적용된 프로모션을 제거합니다.
- Webhooks:promotion.redeemed, promotion.exhausted, promotion.expired를 통해 다운스트림 분석과 알림을 지원합니다.
견적 산출 단계는 부작용이 없어야 합니다. 실제로 주문이나 인보이스가 생성될 때만 사용 기록을 커밋하고 해당 엔터티에 사용 레코드를 연결하세요.
관리자 UI: 마케터를 돕되 운영 안전을 지키기
논엔지니어를 위한 명확한 관리자 UI에 투자하세요:
- 템플릿: “첫 구매 20% 할인”, “3개월 50% 할인”, “$100 크레딧”.
- 조건 빌더: 세그먼트, 임계값, 플랜 목록, 채널, 지역, 기간.
- 스태킹 정책 제어: 배타/결합, 우선순위, 상한.
- 미리보기와 시뮬레이션: 장바구니/구독 컨텍스트를 붙여넣고 게시 전에 결과를 확인합니다.
- 예약 게시: 시작/종료 시간과 타임존, 드라이런과 단계적 롤아웃.
- 변경 이력: 프로모션 정의의 버전 관리 및 변경 내역(diff).
- 코드 생성: 대량 고유 코드 생성, 1회용 서명 URL로 내보내기, 사용 분석.
지원 티켓을 줄이는 UX 디테일
- 최적 혜택 자동 적용: 여러 프로모션이 적용 가능하면 절감액이 가장 큰 것을 자동 적용하고 “가장 유리한 할인을 적용했습니다”라고 설명하세요.
- 명확한 오류 상태: “이 코드는 10월 3일 만료되었습니다”가 “유효하지 않은 코드”보다 낫습니다.
- 내역과 툴팁: 할인이 어떻게 계산되었는지 보여주고 약관을 링크하세요.
- 제거/교체 흐름: 클릭 한 번으로 프로모션을 제거하고, 더 큰 할인에서 더 작은 할인으로 바꾸려는 경우 경고하세요.
- 영수증의 읽기 전용 코드: 유출을 줄이기 위해 영수증에는 코드 힌트만 포함하세요.
애널리틱스와 측정
상관과 인과를 혼동하지 않으면서 효과를 측정하세요:
- 주문/인보이스에 프로모션 메타데이터 첨부: Promotion ID, Coupon ID, 전체 할인 내역.
- 프로모션별 성공 지표 정의: 전환, 증분 매출, 반복 할인에 대한 이탈(churn) 영향.
- 가능하면 홀드아웃: 통제가 가능한 경우 리프트 추정을 위한 실험을 수행하세요. 최소한 관련 기준선과 비교하세요.
- 귀속 필드: 채널, 캠페인, 랜딩 페이지, 리퍼러를 캡처해 사용 출처를 파악하세요.
테스트 전략: 결정론이 서프라이즈를 이깁니다
- 단위 테스트: 액션 타입과 조건 연산자별로. 라운딩, 상한, 임계값 엣지 포함.
- 속성 기반 테스트: 무작위 장바구니를 생성해 불변식(예: total ≥ 0, discount ≤ subtotal, 상한 준수)을 보장하세요.
- 골든 파일: 복잡한 스태킹 시나리오의 입력/출력을 저장하고 diff로 회귀를 탐지하세요.
- 타임 트래블: 시작/종료 시각과 타임존 경계에서의 동작을 테스트하세요.
- 동시성·멱등성: 동일 주문에 대한 재시도와 동시 적용을 시뮬레이션하세요.
건너뛰면 후회할 엣지 케이스
- 환불과 부분 환불: 할인 금액을 비례해 되돌릴지, 프로모션 비용으로 남길지 결정하세요.
- 반품(커머스): 번들에서 일부 아이템이 반품될 때 할인을 어떻게 재계산할지 정의하세요.
- 인보이스 재시도: 결제 실패 후 재시도 시 첫 사이클 할인이 재적용되지 않도록 하세요.
- 코드 노출: 로그, 분석 스크립트, URL이 평문 코드를 의도치 않게 저장하지 않도록 방지하세요.
- 멀티 테넌트 경계: 멀티 테넌트 플랫폼이라면 프로모션, 코드, 사용 기록을 테넌트 범위로 엄격히 분리하세요.
바로 활용할 YeshBe 프롬프트
YeshBe는 자연어로 소프트웨어를 만드는 플랫폼입니다. 이를 사용해 프로모션 엔진, 관리자 UI, API를 스캐폴딩하고 반복 개선하세요. 시작을 위한 실전 프롬프트는 다음과 같습니다:
SaaS 앱을 위한 프로모션 데이터 모델을 설계해 주세요. promotions, conditions, actions, coupons, redemptions를 포함하고, percent/fixed 할인, trial 연장, order vs subscription 범위를 지원합니다. 스태킹 정책, 우선순위, 상한 필드를 추가하세요.
장바구니나 구독 JSON을 받아 적용된 프로모션을 포함한 가격 내역을 반환하는 API 엔드포인트 POST /pricing/estimate를 만들어 주세요. 부작용은 없어야 합니다. 다중 통화와 아이템 단위 라운딩을 처리하세요.
프로모션을 작성하는 관리자 UI를 만들어 주세요: 조건 빌더, 액션 선택, 스태킹 제어, 스케줄링, 샘플 장바구니로 미리보기, 변경 이력. 게시 권한은 Admin만 갖도록 하고 모든 변경을 로깅하세요.
보안적인 쿠폰 코드 처리를 구현해 주세요: 충분한 엔트로피의 고유 코드 생성, 해시만 저장, 레이트 리밋을 사용한 검증, 적용/제거 작업에 멱등 키 포함.
프로모션 애널리틱스를 추가해 주세요: 프로모션·쿠폰별 사용량 추적, 주문에 귀속 메타데이터 첨부, 전환·매출 영향·상위 채널을 보여주는 대시보드 생성.
예시: pricing estimate 요청/응답
예측 가능한 계약은 통합과 디버깅을 쉽게 만듭니다.
// Request { "currency": "USD", "customer": { "id": "cus_123", "is_first_purchase": true, "country": "US" }, "lines": [ { "sku": "plan_pro", "quantity": 5, "unit_price_cents": 3000 }, { "sku": "addon_storage", "quantity": 1, "unit_price_cents": 1000 } ], "entered_code": "PRO20", "channel": "email", "context": { "trial_days_remaining": 0 } } // Response { "subtotal_cents": 16000, "discounts": [ { "promotion_id": "promo_abc", "coupon_hint": "…RO20", "scope": "order", "type": "percent_off", "amount_cents": 3200, "explanation": "20% off first purchase" } ], "total_discount_cents": 3200, "tax_cents": 0, "total_cents": 12800, "currency": "USD", "applied_promotions": ["promo_abc"], "messages": ["Best available discount applied"] }성능 고려사항
- 인덱싱: 상태, 기간, 테넌트, 통화 기준으로 인덱싱해 후보 프로모션을 빠르게 조회하세요.
- 조건 평가: 흔한 조건을 효율적인 프레디킷으로 컴파일하세요. 안전한 경우 고객/세션 단위로 캐시하세요.
- 사전 계산: 트래픽이 큰 캠페인은 적격 고객 목록이나 세그먼트를 미리 계산하고, 런타임에서 합리성 검사를 수행하세요.
- 결과 상한: 스태킹에 대해 합리적 상한(예: 최대 5개 프로모션)을 설정해 계산을 빠르고 예측 가능하게 유지하세요.
거버넌스, 버전 관리, 안전 장치
- 버전드 정의: 라이브 프로모션을 제자리 수정하지 마세요. 새 ID의 새 버전을 만들고 기존 버전을 종료하세요.
- 피처 플래그: 문제가 생기면 빠르게 비활성화할 수 있도록 롤아웃을 플래그 뒤에 감추세요.
- 백필·리플레이: 계산 버그를 수정한 경우, 인보이스를 소급 조정하거나 크레딧을 부여할지 여부와 방식을 결정하세요.
- 직무 분리: 영향이 큰 프로모션(예: 50% 초과 할인)은 검토/승인을 요구하세요.
지속 가능한 결정을 문서화하세요
시스템이 내리는 선택을 문서화해 향후 팀원과 지원 담당자가 결과를 설명할 수 있게 하세요:
- 아이템 단위 할인을 주문 단위 할인보다 먼저 적용합니다.
- 라인 수준에서 1센트 단위로 반올림하며, 절반은 올림합니다.
- 특정 지역 지정을 제외하면 세전 기준으로 할인을 적용합니다.
- 배타적 프로모션은 우선순위와 무관하게 다른 모든 프로모션을 무효화합니다.
- 반복 할인은 업그레이드 시 유지되지만 다운그레이드 시 유지되지 않습니다.
질문이 생기면 즉흥적으로 논쟁하지 말고 문서를 참조하세요.
실전 구축 체크리스트
- promotions, conditions, actions, coupons, redemptions를 포함한 데이터 모델.
- 스태킹 정책과 라운딩 규칙을 갖춘 결정적 계산 파이프라인.
- 안전한 코드 생성, 해시 저장, 레이트 리밋 검증.
- 적용/제거 멱등 API와 부작용 없는 견적 산출.
- 미리보기, 스케줄링, 버전 관리, 감사 로그가 있는 관리자 UI.
- 최적 혜택 자동 적용과 결과 설명을 제공하는 UX.
- 귀속 정보를 포함한 애널리틱스와 프로모션 성과 분석.
- 엣지 케이스, 기간, 동시성, 환불에 대한 테스트.
다음 단계에서의 발전 방향
- 세그먼트 동기화: CDP나 CRM과 연동해 고객 코호트를 타기팅하세요.
- 고유 코드 캠페인: 이메일로 서명된 1회용 코드를 생성·배포하세요.
- 파트너 프로모션: 파트너별 도메인 검증과 사용 한도를 갖춘 프로모션을 만드세요.
- 인앱 셀프서브 딜: 사용 신호를 기반으로 업그레이드 순간에 넛지 배너를 노출하세요.
AI로 빠르게 만들되, 로직은 투명하게
YeshBe의 Vibe Coding은 스캐폴딩과 반복을 가속하지만, 프로모션은 여전히 정교한 규칙, 신중한 모델링, 명시적 거버넌스가 필요합니다. 할인 엔진을 핵심 서브시스템처럼 다루세요: 문서화되고, 테스트되며, 관측 가능하고, 안전하게 진화할 수 있어야 합니다.
처음부터라면 체험 연장과 첫 사이클의 정액/퍼센트 할인부터 시작하세요. 계산 파이프라인에 자신이 생기면 스태킹과 아이템 단위 로직을 추가하세요. 최고의 프로모션 시스템은 마케터가 안심하고 사용할 수 있고, 엔지니어가 밤에 편히 잘 수 있게 해주는 시스템입니다.