Quickstart

This page gets you set up quickly as a merchant (server) or a buyer (client). Choose your language and framework below to get started.

Scroll to the end to see all supported blockchain networks.

Servers (Merchants)

TypeScript
Python

Express

Quickstart for building an x402-enabled server with Express.

Hono

Quickstart for building an x402-enabled server with Hono.

NextJS

NextJS server quickstart is coming soon.

Clients (Buyers)

TypeScript
Python

Axios

Quickstart for building an x402 client with Axios.

Fetch

Quickstart for building an x402 client with Fetch.

Facilitator

All PayAI starter templates include @payai/facilitator, which automatically connects to the PayAI facilitator at https://facilitator.payai.network. No manual URL configuration needed.

import { facilitator } from "@payai/facilitator";
import { HTTPFacilitatorClient } from "@x402/core/server";

const facilitatorClient = new HTTPFacilitatorClient(facilitator);

The facilitator works immediately on the free tier. When you’re ready for production, set PAYAI_API_KEY_ID and PAYAI_API_KEY_SECRET environment variables to authenticate — see Facilitator Pricing. The PayAI facilitator supports the following endpoints:

/supported - see which networks and schemes are supported
/verify - verify that a payment is valid
/settle - settle the payment
/discovery/resources - view the bazaar, a marketplace of merchants

Read the reference for more information on the facilitator endpoints and responses.

Supported networks

The PayAI facilitator supports x402 on the following networks:

Network Name	V1 Network String	V2 CAIP-2 ID
Arbitrum One	`arbitrum`	`eip155:42161`
Arbitrum Sepolia	`arbitrum-sepolia`	`eip155:421614`
Avalanche	`avalanche`	`eip155:43114`
Avalanche Fuji	`avalanche-fuji`	`eip155:43113`
Base	`base`	`eip155:8453`
Base Sepolia	`base-sepolia`	`eip155:84532`
Polygon	`polygon`	`eip155:137`
Polygon Amoy	`polygon-amoy`	`eip155:80002`
Sei	`sei`	`eip155:1329`
Sei Testnet	`sei-testnet`	`eip155:713715`
SKALE Base	`skale-base`	`eip155:1187947933`
SKALE Base Sepolia	`skale-base-sepolia`	`eip155:324705682`
Solana	`solana`	`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`
Solana Devnet	`solana-devnet`	`solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`
X Layer	`xlayer`	`eip155:196`
X Layer Testnet	`xlayer-testnet`	`eip155:1952`

Need help?

Join our Community

Have questions or want to connect with other developers? Join our Discord server.

PayAI

x402

x402 Merchants

x402 Clients

x402 Facilitator

x402 Reference

Guides

X402 Echo Merchant

Project Info

Servers (Merchants)

Express

Hono

NextJS

FastAPI

Flask

Clients (Buyers)

Axios

Fetch

httpx

requests

Facilitator

Supported networks

Need help?

Join our Community

​Servers (Merchants)

Express

Hono

NextJS

FastAPI

Flask

​Clients (Buyers)

Axios

Fetch

httpx

requests

​Facilitator

​Supported networks

​Need help?

Join our Community

Servers (Merchants)

Clients (Buyers)

Facilitator

Supported networks

Need help?