<100 subscribers


Standardizes network and asset formats, allowing servers to accept stablecoins across various networks and even fiat currencies through the same interface, without needing custom logic for each.
Introduces optional structured data passing between clients, servers, and facilitators. This enables features like identity verification, multiple discovery mechanisms, and more, while letting developers extend the protocol without forking the main specification.
Cleanly separates the specification, SDK, and facilitators, making it easier to integrate new networks, payment schemes, and transports. The protocol fits wherever agents operate.
A new Discovery extension allows facilitators to automatically crawl and update pricing and routes, eliminating stale catalogs and manual updates.
Replaces deprecated X-* headers with cleaner, more compatible names such as PAYMENT-REQUIRED, PAYMENT-SIGNATURE, and PAYMENT-RESPONSE, improving integration with proxies, infrastructure, and frameworks.
The "payTo" field can now be an on-chain address, a role (e.g., "merchant"), or a callback that selects the recipient per request. This supports new use cases like x402-enabled marketplaces, multi-tenant APIs, and multi-chain catalogs.
Features a simpler, plug-in model for adding new chains, schemes, facilitators, and business rules without modifying core code.
Ensures V1 applications continue to function seamlessly, while V2 provides enhanced capabilities. Facilitators can advertise support for both versions.
Aspect | x402 V1 | x402 V2 Enhancements |
|---|---|---|
Payment Model | Single-call exact payments only. | Adds subscriptions, prepaids, multi-step, dynamic pricing. |
Identity/Access | No identity; full payment per call. | Wallet-based sessions for repeated access; SIWx extension. |
Headers/Data | Deprecated X-* headers; body for payments. | Modern headers (e.g., PAYMENT-REQUIRED); frees body for content. |
Networks/Assets | Limited chains. | CAIP-standardized multi-chain, stablecoins, fiat (e.g., ACH, cards). |
Extensibility | Requires forking spec. | Optional extensions for data passing (e.g., identity, discovery). |
Discovery/Routing | Manual catalogs; static recipients. | Auto-discovery; dynamic payTo (addresses, roles, callbacks) for marketplaces/APIs. |
SDK/Architecture | Tighter coupling; less modular. |
Overall, x402 V2 enhances flexibility, power, and ease of use for paid APIs and agentic payments, building on millions of payments processed and extensive community feedback.
For the full specification and details, refer to the launch blog at https://www.x402.org/writing/x402-v2-launch
Standardizes network and asset formats, allowing servers to accept stablecoins across various networks and even fiat currencies through the same interface, without needing custom logic for each.
Introduces optional structured data passing between clients, servers, and facilitators. This enables features like identity verification, multiple discovery mechanisms, and more, while letting developers extend the protocol without forking the main specification.
Cleanly separates the specification, SDK, and facilitators, making it easier to integrate new networks, payment schemes, and transports. The protocol fits wherever agents operate.
A new Discovery extension allows facilitators to automatically crawl and update pricing and routes, eliminating stale catalogs and manual updates.
Replaces deprecated X-* headers with cleaner, more compatible names such as PAYMENT-REQUIRED, PAYMENT-SIGNATURE, and PAYMENT-RESPONSE, improving integration with proxies, infrastructure, and frameworks.
The "payTo" field can now be an on-chain address, a role (e.g., "merchant"), or a callback that selects the recipient per request. This supports new use cases like x402-enabled marketplaces, multi-tenant APIs, and multi-chain catalogs.
Features a simpler, plug-in model for adding new chains, schemes, facilitators, and business rules without modifying core code.
Ensures V1 applications continue to function seamlessly, while V2 provides enhanced capabilities. Facilitators can advertise support for both versions.
Aspect | x402 V1 | x402 V2 Enhancements |
|---|---|---|
Payment Model | Single-call exact payments only. | Adds subscriptions, prepaids, multi-step, dynamic pricing. |
Identity/Access | No identity; full payment per call. | Wallet-based sessions for repeated access; SIWx extension. |
Headers/Data | Deprecated X-* headers; body for payments. | Modern headers (e.g., PAYMENT-REQUIRED); frees body for content. |
Networks/Assets | Limited chains. | CAIP-standardized multi-chain, stablecoins, fiat (e.g., ACH, cards). |
Extensibility | Requires forking spec. | Optional extensions for data passing (e.g., identity, discovery). |
Discovery/Routing | Manual catalogs; static recipients. | Auto-discovery; dynamic payTo (addresses, roles, callbacks) for marketplaces/APIs. |
SDK/Architecture | Tighter coupling; less modular. |
Overall, x402 V2 enhances flexibility, power, and ease of use for paid APIs and agentic payments, building on millions of payments processed and extensive community feedback.
For the full specification and details, refer to the launch blog at https://www.x402.org/writing/x402-v2-launch
Modular plugins for chains/schemes; lifecycle hooks. |
Facilitators | Single-focus; manual handling. | Multi-facilitator prefs; auto-selection/sync. |
Dev Experience | More custom logic; higher latency. | Simpler config; supports high-frequency (e.g., LLMs); unified for agents/humans. |
Modular plugins for chains/schemes; lifecycle hooks. |
Facilitators | Single-focus; manual handling. | Multi-facilitator prefs; auto-selection/sync. |
Dev Experience | More custom logic; higher latency. | Simpler config; supports high-frequency (e.g., LLMs); unified for agents/humans. |
Share Dialog
Share Dialog
1 comment
We’ve just dropped a new blog: x402 V2 Key Highlights 🔥 This post breaks down everything you need to know about x402 V2, this version expands the protocol beyond single-call, exact payments. It's related to some next update from Capminal x402. The content is carefully curated from Coinbase x402 official docs and insights shared by erik.eth. Think of it as a TL;DR for what’s coming next in the x402 ecosystem. Type to DeFAI 🦡 #x402 #x402v2 https://paragraph.com/@capminal/key-highlights-of-x402-v2