Errors /
"No network/scheme registered for x402 version: 2 which comply with the payment requirements"
The client has no wallet scheme registered for any option the seller offers.
| Reported by | the x402 client, before any payment is sent |
| Usually fixed by | the buyer or the seller, depending on the cause |
Cause
None of the options in the quote's accepts match a network and scheme registered on the client. The message lists what the seller offered and what the client supports.
Fix
- Buyer: register a scheme for one of the offered networks, for example
client.register("eip155:8453", new ExactEvmScheme(account)). - Seller: offer at least one widely supported option, such as USDC on Base.
- The wrong-network scenario offers only an unsupported network to test that your client reports this cleanly.
Reproduce it
The Unsupported network only scenario on this site exercises this situation.
About this reference
Causes are taken from the source of @x402/core 2.31. Other facilitators and later versions may use the same code for slightly different checks. See all x402 errors.