Facilitator rate-limits /verify (429 → misclassified 402)
Quirk · GET /api/x402/facilitator-rate-limited · Facilitator Dependency
The facilitator returns 429 during /verify; the merchant misclassifies it as a payment failure and returns 402 instead of 503 + Retry-After.
Explanation
The facilitator returns 429 Too Many Requests during /verify. A correct merchant should translate this into a 503 Service Unavailable + Retry-After so the client knows to wait and retry rather than treat its payment as invalid. This merchant misclassifies the 429 as a payment failure and returns 402, leaving the client convinced its payment is wrong when the real problem is facilitator capacity.
What to watch
The client sees 402 and thinks its payment is invalid — it cannot tell a rate limit from a real rejection.
Facilitator
The facilitator is mocked for this scenario — its response is simulated, so no live Radius testnet settlement occurs.
Metadata
- Status: Quirk
- Method: GET
- Price: 0.0001 (100 atomic)
- Responsible party: Merchant