Why x402r?
Standard x402 payments are immediate and irreversible. x402r adds:- Escrow deposits — Funds held in smart contracts until conditions are met
- Refund windows — Configurable time periods for buyers to request refunds
- Dispute resolution — Arbiter system for handling contested transactions
How It Works
Who Is This For?
Clients (Payers)
Request refunds, freeze suspicious payments, and track payment state.
Merchants (Receivers)
Release funds, process refunds, and manage escrow periods.
Arbiters
Resolve disputes, approve/deny refund requests, and integrate AI decision-making.
Get Started
Protocol Overview
Understand how x402r extends the x402 protocol.
Smart Contracts
Explore the escrow and payment operator contracts.
SDK Quickstart
Start building with the TypeScript SDK.
Deploy an Operator
Deploy your own PaymentOperator on Base.
Architecture
x402r consists of three main components:| Component | Purpose |
|---|---|
| PaymentOperator | Manages payment authorization, release, charge, and refunds |
| RefundRequest | Handles refund request lifecycle and approvals |
| EscrowPeriod | Tracks escrow timing for time-based release conditions |
Supported Networks
| Network | Chain ID | Status |
|---|---|---|
| Base Sepolia | 84532 | Supported |
| Base Mainnet | 8453 | Supported |