Context
Complex payments (multi-party, multi-chain, escrow, subscriptions) require step-by-step configuration that is confusing in a single form.
Current Limitation/Problem
Payment creation forms try to handle all transaction types in one view, resulting in a cluttered interface with conditional fields that confuse users.
Expected Outcome
A step-by-step payment wizard that adapts to the transaction type, guiding users through each stage: select type, configure parameters, review, and confirm. Progress is saved across sessions.
Acceptance Criteria
- Wizard adapts steps based on payment type (simple, escrow, subscription, batch)
- Progress indicator with step navigation (back/skip/next)
- Form state preserved on page refresh (localStorage)
- Real-time validation per step with inline errors
- Summary/review step before confirmation
- Support for draft saving and resuming later
- Responsive design with mobile-optimized layout
- Analytics tracking step completion rates and dropoffs
Technical Scope
frontend/src/app/payments/create/ - wizard route
frontend/src/components/payments/wizard/ - wizard step components
frontend/src/components/payments/wizard/steps/ - individual steps
- Zustand store for wizard state with localStorage persistence
- React Hook Form with Zod validation per step
- Edge cases: browser back/forward, concurrent wizard sessions, validation cross-dependencies
Context
Complex payments (multi-party, multi-chain, escrow, subscriptions) require step-by-step configuration that is confusing in a single form.
Current Limitation/Problem
Payment creation forms try to handle all transaction types in one view, resulting in a cluttered interface with conditional fields that confuse users.
Expected Outcome
A step-by-step payment wizard that adapts to the transaction type, guiding users through each stage: select type, configure parameters, review, and confirm. Progress is saved across sessions.
Acceptance Criteria
Technical Scope
frontend/src/app/payments/create/- wizard routefrontend/src/components/payments/wizard/- wizard step componentsfrontend/src/components/payments/wizard/steps/- individual steps