Public facilitator · x402 v2 · XDC mainnet

The x402 facilitator for your own server.

The public facilitator verifies and settles x402 payments for an API you host yourself. Your server asks it is this payment real and settle it, and it does the on-chain work and pays the gas.

Buyers need nothing here: no account, no API key, no credits. Everything on this page is the seller side.

Your serverFacilitatorXDC
seller · one paid callx402 v2
  1. 402 with your price

    0.01 USDC · eip155:50

  2. POST /verify

    signature recovered

  3. POST /settle

    queued, gas paid for you

  4. 4

    GET /settlements/{id}

    confirmed · 0x9c4f...a1b2

    settled
USDC
gasless · EIP-3009
settled on XDC
What it gives you

A payment layer you call, not one you operate

Verify and settle over HTTP

Two endpoints and a poll. The facilitator recovers the signature, broadcasts the transfer, and reports when it confirms on-chain.

Gasless for your buyers

Buyers sign an EIP-3009 authorization and never submit a transaction, so they never hold native XDC. The facilitator pays the gas.

Seller API keys

One bearer string per deployment, shown once, stored only as a hash. Label it, rate-limit it, rotate or revoke it from the dashboard.

Prepaid credits

1 credit = 0.001 USDC, fixed, so credit you bought last month is worth the same today. Only confirmed settlements draw it down.

Top up in USDC

Pay from your XDC AI smart wallet or a linked wallet, then paste the transaction hash. No card, no invoice, no account number to quote.

Usage and history

Requests per key, settlement records with their transaction hashes, and the facilitator's own ledger of credit added and credit spent.

Your dashboard

Keys, credits and settlements in one place

The facilitator keys your account by the address your API is paid at, so pick that address once and everything hangs off it.

  • One-time setup. Choose your receiving address, mint a key for each deployment, and keep the quota in view.

  • Credits without ceremony. Buy in USDC from a wallet you already hold, paste the hash, and watch the balance move.

  • Proof after the fact. Per-key usage, settlement records with transaction hashes, and the ledger behind every debit.

Open the dashboard
xdcai.tech/account/facilitator
Credit balance

12,480

credits · 1 credit = 0.001 USDC

Buy credits
Seller API keys2 of 5
  • production

    ID: 8c9208ecb7d5 · 600/min

    active
  • staging

    ID: 4f71ab0d92e4 · 120/min

    active
+ New key
Connect

https://public-facilitator.xdcai.tech

POST/verifyPOST/settleGET/settlements/{id}

Dashboard preview with sample figures

Do you need it

Three ways to charge for an API call

Most sellers should use the gateway: no key, no credits, no polling loop, and the service gets listed in the marketplace. Reach for the facilitator when the payment logic belongs in your own application.

Gateway

Point it at your existing API and it handles 402, verification and settlement for you. Nothing to manage, and your service gets listed in the marketplace.

List your service

Public facilitator

this page

You host the API and own the payment logic. You manage a seller API key and the verify, settle and polling calls.

Open the dashboard

Run your own

You operate the whole payment layer, including the wallet that submits settlements and pays the gas for them.

Build a facilitator
FAQ

Common questions

How hard is it to integrate?

It is a small integration. Your server answers 402 with a price, calls verify, calls settle, and polls until it confirms. There is no blockchain code to write and no wallet or node to run. The seller guide has copy-paste examples for each call.

Do my buyers need an account, a wallet setup, or credits?

No. Anyone holding USDC on XDC pays from the wallet they already use, with no account here and no gas to worry about. That keeps friction near zero for the people paying you. Everything you manage, the key and the credits, is on your side, not theirs.

How much does it cost me?

You prepay credits, where 1 credit is 0.001 USDC and the rate is fixed, and only confirmed on-chain settlements draw them down. Verify calls and health checks are free. You top up in USDC from a wallet you already hold, with no card and no invoice.

What happens if I run out of credits during traffic?

Settle returns a clear billing error that is about your account, not the buyer's payment, so your API should not tell them the payment failed. You top up and you are live again. Keep a buffer so a spike does not catch you out.

Is it reliable, and are my funds ever at risk?

Funds move directly from the buyer to your receiving address in USDC. The facilitator submits the settlement and pays the gas, and every settlement reports its on-chain transaction hash, so you can audit each payment yourself. It never holds your money.

Should I use this or the gateway?

Use the gateway if you want XDC AI to wrap your existing API with no code changes and list it in the marketplace. Use the public facilitator when you host the API yourself and want the payment logic to live in your own application.

Get started

Mint a key and settle your first call

Pick the address your API is paid at, create a key, and top up credits when you are ready to go live.