Provider Playbook
List your API on PayAPI Market. Set up a wallet, return a 402, pass review, and earn the settlement-verified badge. Free to list, PayAPI takes 0% of each job.
The default x402 flow is to check the payment, run the request, and then settle.
If an upstream service returns HTTP 429 or HTTP 5xx, or the call times out, return HTTP 4xx or HTTP 5xx. Do not return HTTP 200 with an empty body, null, or stub data.
Offer a free sample or health route that returns real data in the same shape as the paid route. We can check that route without paying.
Listed paid routes should only settle payment after a successful response (a 2xx status with real, non-empty data); upstream errors must return an error status, not a 200. Routes that settle before running must be labelled. Listings that fail our checks may have their verified badge paused.