- SDK References
- Payment Protocol Adapters
- x402-sdk
x402-facilitator
On this page
Verify and settle supported x402 payments with @fastxyz/x402-facilitator
@fastxyz/x402-facilitator provides verification and settlement for supported Fast and EVM x402 payments. Its package README documents createFacilitatorServer(), createFacilitatorRoutes(), verify(), settle(), and the configuration expected for each network.
The server receives an X-PAYMENT payload and asks the facilitator to check it against the route’s requirement. The protected handler should run only after verification succeeds. A settlement operation may then submit or record the payment according to the network path; verification and settlement are distinct operations, particularly for EVM EIP-3009 authorizations.
| Route | Purpose |
|---|---|
POST /verify |
Validate a payment payload against a requirement |
POST /settle |
Settle the supported payment on its network |
GET /supported |
Advertise supported payment kinds |
createFacilitatorServer() mounts Express-compatible routes; createFacilitatorRoutes() returns route descriptors for an existing app. Configure the EVM chains, USDC addresses, Fast proxy, and Fast committee public keys that correspond to the actual deployment. A syntactically valid payload or verify response alone is not proof that an EVM transfer has settled; inspect the settlement result and handle uncertain outcomes before retrying.