Skip to content

EasyInvoice - Payee destination management page #205

@MantisClone

Description

@MantisClone

Problem

Payees need a frontend interface to connect their wallet and claim their destination preferences.

Proposed Solution

Create a "Claim Destination" flow as a standalone page:

User Flow:

  1. Payee connects wallet
  2. Payee selects chain and currency for receiving payments
  3. System generates destination ID from connected wallet + selections
  4. Payee signs EIP-712 message to claim destination
  5. System calls POST /v2/destinations/claim
  6. Display success with shareable destination ID

UI Concept:

┌─────────────────────────────────────────────┐
│  Claim Your Payment Destination             │
├─────────────────────────────────────────────┤
│  Connected: 0x742d35...35Cc                 │
│                                             │
│  Chain:    [Polygon     ▼]                  │
│  Currency: [USDC        ▼]                  │
│                                             │
│  Your Destination ID:                       │
│  ┌───────────────────────────────────────┐  │
│  │ polygon:0x742d35...35Cc:USDC    [📋]  │  │
│  └───────────────────────────────────────┘  │
│                                             │
│  [ Sign & Claim Destination ]               │
└─────────────────────────────────────────────┘

Implementation Notes

Build as a standalone page within this repository (decided Feb 2, 2026).

  • Not integrated with main Easy Invoice navigation
  • Simple, focused interface for wallet connection and payment preferences
  • Wallet connection state will be shared with Easy Invoice if both are open (acceptable tradeoff for now)

Rationale: Request Commerce's future is uncertain, and a standalone app would require too much boilerplate. Easy Invoice is the pragmatic choice.

Considerations

  • Only show chains/currencies that are supported
  • Validate destination ID format before signing
  • Handle wallet connection errors gracefully
  • Consider showing claim status for existing destinations

Dependencies

  • RequestNetwork/request-api#439 (POST /v2/destinations/claim endpoint)
  • RequestNetwork/request-api#440 (GET /v2/destinations/{id} endpoint)

Migrated from RequestNetwork/request-secure-payment#34

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    Status

    ✅ Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions