Route
/coupons/register쿠폰 등록사용자 모바일 · P1Payment scaffoldP1 35/70
/coupons/register
쿠폰 등록
Toss sandbox 연결 전 결제·환불·쿠폰 상태 화면
결제 성공/실패/환불/쿠폰·포인트 화면은 상태머신에 맞춰 먼저 나누고, 실제 결제키는 계정 수령 후 주입합니다.
서툰 우리의 옆자리Concept C — Social Event
안전한 결제/혜택 흐름
결제 화면은 신뢰 우선, 쿠폰과 포인트는 이벤트 참여 혜택처럼 보조한다.
쿠폰 등록
쿠폰 코드는 결과까지 바로 확인합니다
코드 입력 화면은 길게 만들지 않습니다. 입력 뒤 등록 결과와 적용 가능한 위치를 바로 보여줍니다.
공식 로고 반영정책 연결 전코드 등록
서툰 우리의 옆자리새 혜택 추가
입력 후 어디에 쓸 수 있는지
쿠폰 코드를 확인한 뒤 사용할 수 있는 행사와 결제 단계로 이어줍니다.
코드 입력조건 확인쿠폰함 이동
확인 흐름
코드와 조건을 함께 봅니다
실제 검증은 실연동 뒤 붙이고, 지금은 사용자에게 보여줄 결과 흐름만 잡습니다.
등록 결과 확인하기입력 정보
쿠폰 등록 항목
코드 입력 뒤 적용 가능 여부와 이동 버튼이 바로 보이게 둡니다.
- 쿠폰 코드코드 입력 · 필수
- 적용 전 확인상태 확인 · 필수
Template family
paymentFlow
Toss sandbox key 및 운영 정책 대기
01PaymentRow
02Amount summary
03Result state
04ConfirmDialog
UI primitives
공통 컴포넌트 슬롯
MobileShellPageHeaderPaymentRowSummaryCardStatusBadgeConfirmDialog
State contract
로딩·빈값·오류·차단·주요 행동
디자인과 실데이터를 기다리는 동안에도 모든 route가 같은 실패/대기/빈값 골격을 유지하도록 화면별 상태 계약을 고정합니다.
Loading
쿠폰 등록 불러오는 중
쿠폰 등록 화면은 사용자 데이터와 공통 primitive 계약을 동시에 기다리는 로딩 상태를 노출합니다.
Empty
쿠폰 등록에 표시할 항목이 없습니다
실제 사용자 데이터가 비어 있어도 레이아웃이 무너지지 않도록 안내문과 다음 행동을 유지합니다.
Error
쿠폰 등록 데이터를 확인하지 못했습니다
실제 계정·정책·결제 연동 전에는 외부 요청을 만들지 않고, 재시도·문의·뒤로가기 위치만 계약으로 고정합니다.
Blocked
쿠폰 등록 고객 입력 대기
priorityAfterP0, brandSkin, tossAccount, pricePolicy, refundPolicy, firebaseProject 항목이 확정되기 전까지 디자인과 실데이터를 잠그지 않습니다.
Success
쿠폰 등록이 완료됐어요
결제, 환불, 쿠폰, 포인트 흐름을 이어서 확인할 수 있습니다. 다음 단계는 쿠폰함에서 이어서 확인할 수 있어요.
Primary action
결제 상태 흐름 확인/couponscustomer input requiredRequired data
paymentIntentpricePolicyrefundPolicyprimitive:MobileShellprimitive:PageHeaderprimitive:PaymentRowprimitive:SummaryCardprimitive:StatusBadgeprimitive:ConfirmDialog
Customer input
priorityAfterP0brandSkintossAccountpricePolicyrefundPolicyfirebaseProject
Next routes
/coupons/meAction/Form contract
버튼·폼·상태전이 바인딩
`screen-action-contract.json` 기준 primary CTA, form field, 상태전이, provider 차단, audit requirement를 화면에 직접 표시합니다. 현재 경계는 fixture-only-no-provider-call이며 no provider calls before customer accounts 정책을 유지합니다.
Primary CTA
결제 상태 흐름 확인
쿠폰 등록 화면의 주 CTA를 submitForm contract로 고정합니다.
submitForm결제 상태 흐름 확인/couponsProvider block
no-provider-call-before-customer-accounts
Firebase·Toss·Storage·Auth production call은 고객 계정 수령 전까지 차단합니다.
Toss PaymentsCloud Firestore
Audit requirement
audit log not required
none
none결제 상태 흐름 확인을 누르면 결제 또는 혜택 확인으로 자연스럽게 이어집니다.
잠시만 기다리면 쿠폰 등록 상태가 화면에 정리됩니다.
결제, 환불, 쿠폰, 포인트 흐름을 이어서 확인할 수 있습니다. 다음 단계는 쿠폰함에서 이어서 확인할 수 있어요.
입력한 내용과 화면 안내를 확인한 뒤 결제 상태 흐름 확인을 다시 눌러 주세요.
결제 정책과 혜택 운영 기준 확인이 필요합니다. 준비되면 결제 상태 흐름 확인을 다시 진행할 수 있습니다.
사용자가 primary action을 실행합니다.
외부 provider 호출 없이 fixture 성공 상태를 표시합니다.
검증/fixture 오류 상태를 표시합니다.
고객 로고/계정/정책 blocker가 남아 있으면 blocked 상태를 유지합니다.
필수 입력이 해결되면 기본 상태로 돌아갑니다.
Fixture interaction runner
role·CTA·form·provider·audit 시뮬레이션
실 provider 호출 없이 primary CTA, role decision, form submit, state transition, audit requirement를 fixture-only로 점검합니다.
Role access
user6 denied rolesPrimary flow
결제 상태 흐름 확인/couponsForm submit
submitFixture2 required fields provided by fixtureAudit/provider
audit not required2 blocked providers, 0 callsFixture payload
화면별 최소 DTO preview
실제 Firebase/Toss/정책 원문 대신 사용할 최소 payload입니다. 화면 구조와 DTO 슬롯을 먼저 맞추고, 고객 계정·정책 수령 후 실제 데이터로 교체합니다.
Payload contract
paymentFlowpayload-coupons-registerserviceContentSummary
쿠폰 등록 화면에 표시할 최소 serviceContent fixture payload입니다. 실제 provider 호출 없이 layout과 DTO 슬롯만 확인합니다.
route-coupons-register-fixture금액
환불 정책
데모 결제건
Toss 실제 호출 전 금액/상태 표시
amount:79000method:fixtureprovider:no-call
Form fields
주문 ID · hidden · required결제 금액 · number · required
toss-sandbox-needed
idempotency planned
no raw card data