Skip to content

EasyInvoice - Payee destination management page #205

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions