This guide walks through the end-to-end flow for receiving payments via the Request Network: creating a payment destination and Client ID in the Dashboard, registering a webhook for payment notifications, and creating a payment link — all using your wallet session.

Overview

The flow involves three services:

1. Dashboard (dashboard.request.network) — Sign in with your wallet, create payment destinations, and generate Client IDs
2. Auth API (auth.request.network) — Programmatic alternative for Client IDs, and the home of webhooks
3. Request API (api.request.network) — Create payment links (secure payments)

┌──────────────────────┐
│  1. Sign in with     │  dashboard.request.network
│     wallet           │
└──────────┬───────────┘
           │
           ▼
┌──────────────────────┐
│  2. Create Payee     │  dashboard.request.network
│     Destination      │
└──────────┬───────────┘
           │
           ▼
┌──────────────────────┐
│  3. Create Client ID │  dashboard.request.network
│                      │  (or auth.request.network/open-api)
└──────────┬───────────┘
           │
           ▼
┌──────────────────────┐
│  4. Register Webhook │  auth.request.network/open-api
│                      │  (POST /v1/webhook with x-client-id)
└──────────┬───────────┘
           │
           ▼
┌──────────────────────┐
│  5. Create Secure    │  api.request.network/open-api
│     Payment (link)   │
└──────────────────────┘

Your wallet session cookie (session_token) is shared across dashboard.request.network, auth.request.network, and api.request.network — so signing in once on the Dashboard gives you access to the API docs as well.

Prerequisites

• An EVM wallet (e.g. MetaMask) that will receive payments
• The ability to sign messages with that wallet

Step 1: Sign in with Your Wallet

1. Go to dashboard.request.network.
2. Connect your EVM wallet and sign the authentication message when prompted.
3. Once signed in, you will have an active wallet session. This sets a session_token cookie in your browser that is shared across Request Network services.

Note: Wallet sessions expire after 15 minutes. If your session expires during the following steps, return to the Dashboard and sign in again.

Step 2: Create a Payment Destination