Skip to main content
The Facilitator Service keyless trial lets you settle real x402 payments without a Circle account. Facilitator Service creates a seller account for your payout address (payTo) on your first /settle call and keeps settling payments until you hit the trial limit.

Seller proof

With no API key to authenticate keyless requests, Facilitator Service relies on a seller proof: an EIP-712 signature from the key controlling payTo. The proof shows Facilitator Service that you own the payTo address. See Sign a seller proof for how to construct one.

The trial allowance

Each payTo has its own trial allowance on each supported blockchain, with testnet and mainnet counted separately. Each /settle call counts against that allowance. Once it’s exhausted, /settle responds with HTTP 403 registration_required. To continue settling, authenticate with a Circle API key.

Facilitator Service seller accounts

A seller account is the record Facilitator Service keeps for a payTo. It tracks payment history and, during the keyless trial, how much of the trial allowance you’ve consumed. Facilitator Service creates one automatically the first time you settle a payment for a new payTo. A new seller account has no Circle account attached. Settle once for that payTo with a Circle API key, and Facilitator Service binds the account to yours. There is no separate registration step. The trial allowance stops applying. Payment history carries over. If you don’t have a Circle account yet, create one in Circle Console and generate an API key.