# Key Highlights of x402 V2

By [Capminal](https://paragraph.com/@capminal) · 2025-12-17

x402, defai, ai, crypto, defi, aiagent

---

### **Multi-Chain and Fiat Support**

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.

### **Extensions**

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.

### **Expanded Network and Transport Compatibility**

Cleanly separates the specification, SDK, and facilitators, making it easier to integrate new networks, payment schemes, and transports. The protocol fits wherever agents operate.

### **Automatic API Discovery**

A new Discovery extension allows facilitators to automatically crawl and update pricing and routes, eliminating stale catalogs and manual updates.

### **Modernized HTTP Headers**

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.

### **Dynamic Routing**

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.

### **Modular SDK**

Features a simpler, plug-in model for adding new chains, schemes, facilitators, and business rules without modifying core code.

### **Backward Compatibility**

Ensures V1 applications continue to function seamlessly, while V2 provides enhanced capabilities. Facilitators can advertise support for both versions.

### **x402 V1 & V2 Comparison**

**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.

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.

  

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](https://www.x402.org/writing/x402-v2-launch)

---

*Originally published on [Capminal](https://paragraph.com/@capminal/key-highlights-of-x402-v2)*