x402 Facilitator

The facilitator verifies payment signatures and settles transactions on-chain.

What is a Facilitator?

In the x402 protocol, a facilitator is a trusted third-party service that bridges signed payment authorizations to on-chain settlement. The facilitator enables gasless payments — payers sign EIP-712 authorizations off-chain, and the facilitator submits the actual blockchain transaction.

The facilitator:

  1. Receives payment payloads from payees (servers)
  2. Verifies EIP-712 signatures against payment requirements
  3. Checks authorization validity (nonce, time bounds)
  4. Executes the on-chain transfer
  5. Returns settlement confirmation (tx hash, block number)

Primer Facilitator

Primer operates a public facilitator for Base networks:

endpoint
https://x402.primer.systems

Supported Networks

Network CAIP-2 ID Status
Base Mainnet eip155:8453 Supported
Base Sepolia eip155:84532 Supported
Default in SDK. The Primer facilitator is the default for Base networks — no configuration required.

API Endpoints

Endpoint Description
POST /verify Verify payment signature without settling
POST /settle Verify and execute payment on-chain
GET /supported List supported schemes and networks
GET /health Health check and configuration status
GET /contracts Get Prism contract addresses

Token Support

EIP-3009 Tokens (USDC, EURC)

Tokens implementing EIP-3009 support native gasless transfers via transferWithAuthorization. The facilitator calls this function directly on the token contract — no additional contracts required.

Standard ERC-20 via Prism

For tokens without EIP-3009 support, the Primer facilitator uses our Prism settlement contract. Prism enables gasless ERC-20 transfers through a signature-based flow:

  1. Payer approves Prism contract once (requires gas)
  2. Payer signs EIP-712 authorization for each payment
  3. Facilitator calls settleERC20() on Prism
  4. Prism transfers tokens from payer to payee

The facilitator auto-detects token type — if the token implements EIP-3009, it uses direct transfer; otherwise, it routes through Prism.

Payment Scheme

The Primer facilitator supports the exact scheme — the standard x402 payment method where the payer transfers a specific amount for each request.

Primer Pay →