Skip to main content

Server Integration

Adding payment requirements to your API

Client Integration

Paying for x402-protected APIs

Agent Self-Provisioning

An AI agent that needs a facilitator endpoint

​
Base URL

All requests go through: 
https://x402.renvoy.ai

​
Path prefixes

The path prefix determines authentication and tier routing:
PrefixAuthNetworkUse case
/sandbox/...None (IP-limited)Base Sepolia, Solana DevnetDevelopment and testing
/v1/<key>/...API keyBase + Sepolia, SolanaProduction
/v1/<key>/flash/...API keyBase + Sepolia, Solana~200ms settlement (Growth+). On Base, uses Flashblocks for ~200ms finality. Solana achieves comparable speed natively.

​
Facilitator URL in your server config

Your server needs a facilitator URL. This is what you pass to HTTPFacilitatorClient: 
// Sandbox (free, testnet)
const facilitator = new HTTPFacilitatorClient({
  url: "https://x402.renvoy.ai/sandbox",
});

// Production (with API key)
const facilitator = new HTTPFacilitatorClient({
  url: "https://x402.renvoy.ai/v1/YOUR_API_KEY",
});
The facilitator exposes two core endpoints at this base URL:
  • POST /settle — settle a payment on-chain
  • POST /verify — verify a payment signature without settling
The @x402/express middleware calls these automatically.