Skip to content

Frontend: Add Multi-Step Payment Flow Wizard for Complex Transactions #461

Description

@Smartdevs17

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

Metadata

Metadata

Assignees

Labels

200-points200 point issueStellar WaveIssues in the Stellar wave programdrips-waveIssues in the Drips Wave programhighHigh complexity issue

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions