Skip to content

docs(fxrp): convert x402 payments flow diagram to Mermaid #1233

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
0xreflexivity merged 1 commit into from
Feb 25, 2026
+14 −28
Merged

docs(fxrp): convert x402 payments flow diagram to Mermaid #1233

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 14 additions & 28 deletions docs/fxrp/token-interactions/03-x402-payments.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,34 +42,20 @@ The x402 implementation consists of four components:

## EIP-3009 Payment Flow

```
┌─────────┐ 1. Request Resource ┌─────────────┐
│ Agent │ ─────────────────────────────▶│ Server │
│ │ ◀───────────────────────────── │ │
│ │ 2. 402 + Payment Req │ │
│ │ │ │
│ │ 3. Sign EIP-712 Auth │ │
│ │ (off-chain signature) │ │
│ │ │ │
│ │ 4. Request + X-Payment │ │
│ │ ─────────────────────────────▶│ │
│ │ ┌───────────┴─────────────┤
│ │ 5. settlePayment() │
│ │ │ │
│ │ ▼ │
│ │ ┌─────────────┐ │
│ │ │ Facilitator │ │
│ │ └──────┬──────┘ │
│ │ │ │
│ │ 6. transferWithAuthorization │
│ │ │ │
│ │ ▼ │
│ │ ┌─────────────┐ │
│ │ │ MockUSDT0 │ │
│ │ └─────────────┘ │
│ │ │ │
│ │ ◀───────────────────────────── │ │
└─────────┘ 7. 200 OK + Resource └─────────────┘
```mermaid
sequenceDiagram
participant Agent
participant Server
participant Facilitator
participant MockUSDT0
Agent->>Server: 1. Request Resource
Server-->>Agent: 2. 402 + Payment Req
Agent->>Agent: 3. Sign EIP-712 Auth<br/>(off-chain signature)
Agent->>Server: 4. Request + X-Payment header
Server->>Facilitator: 5. settlePayment()
Facilitator->>MockUSDT0: 6. transferWithAuthorization()
Server-->>Agent: 7. 200 OK + Resource
```

The flow works as follows:
Expand Down
Loading