Docs

Expanding x402 payments to 26 new chains

Joaquim Verges

We've extended the x402 protocol to support passing arbitrary chain ids, and expanded support to 13 new mainnets and 13 new testnets. You can now accept internet-native payments across a total of 35 chains.

In v5.109.0 of the thirdweb SDK, we've introduced new APIs to verify and settle payments and updated our client side API for multichain support.

Here's an example of using settlePayment within a Next.js API route:

// Usage in a Next.js API route
import { settlePayment, facilitator } from "thirdweb/x402";
import { createThirdwebClient } from "thirdweb";
 
const client = createThirdwebClient({
  secretKey: process.env.THIRDWEB_SECRET_KEY,
});
 
const thirdwebFacilitator = facilitator({
  client,
  serverWalletAddress: "0x1234567890123456789012345678901234567890",
});
 
export async function GET(request: Request) {
  // verify and settle the payment
  const result = await settlePayment({
    paymentData: request.headers.get("x-payment"),
    resourceUrl: "https://api.example.com/premium-content",
    method: "GET",
    payTo: "0x1234567890123456789012345678901234567890",
    network: "eip155:42161", // CAIP-2 format: "eip155:<chain_id>"
    price: "$0.10", // or specific token
    facilitator: thirdwebFacilitator,
  });
 
  if (result.status === 200) {
    // Payment verified and settled successfully
    return Response.json({ data: "premium content" });
  } else {
    // Payment required
    return Response.json(result.responseBody, {
      status: result.status,
      headers: result.responseHeaders,
    });
  }
}

You can pass any chain id as the network property using the CAIP-2 notation: eip155:<chain_id>. The thirdweb facilitator will handle settling payments on the given chain using the specified token, otherwise defaults to USDC.

Simply call settlePayment in your endpoint handler, middleware or agentic tool to process a payment everytime your API is called.

Here's the list of new chains supported (mainnet + testnet)

  • Arbitrum One
  • Celo
  • Ethereum mainnet
  • HyperEVM
  • Linea
  • Optimism
  • Plume
  • Polygon
  • Sonic
  • Unichain
  • World Chain
  • XDC

Learn more:

Happy building! 🛠️