x402 compatibility
Hosted supported path
| Property | Value |
|---|---|
| x402 protocol | V2 challenge and signed retry |
| Client packages exercised | @x402/fetch@2.19.0, @x402/evm@2.19.0 |
| Scheme | exact |
| Network | eip155:14 |
| Asset | USD₮0 |
| Authorization | EIP-3009 TransferWithAuthorization |
| Settlement | Integrated server-submitted settlement through X402Facilitator |
| Result | Protected HTTP response plus PAYMENT-RESPONSE |
Headers
| Header | Direction | Content |
|---|---|---|
PAYMENT-REQUIRED |
Server to client on HTTP 402 | Base64 JSON containing x402Version, resource and accepted payment options. |
PAYMENT-SIGNATURE |
Client to server on retry | Base64 JSON containing the accepted option, authorization and signature. |
PAYMENT-RESPONSE |
Server to client after settlement | Base64 JSON containing success, network, transaction, payer and receipt links when available. |
The server also emits legacy compatibility headers on some paths. New integrations should use the V2 headers above.
Response contract
A successful paid request must satisfy all of these conditions:
- the protected response is HTTP 2xx;
PAYMENT-RESPONSEdecodes withsuccess: true;transactionis present;networkiseip155:14for the hosted Flare path;receiptIdis present before the integration declares its evidence record complete.
The receipt itself can still be pending while background packaging and anchoring run.
Other source paths
Base USDC and native FLR adapters remain experimental. Read the live 402 challenge and accept only payment tuples your application explicitly allows.