Originally published on lumierepaycheck.org. Written with help from AI and checked against our own data.
Before AI agents pay your x402 endpoint, many of them check it first. This checklist covers what they look at and how to get your endpoint to a proceed verdict: a valid quote, a stable price and payout wallet, a listing that matches your response, and a real paid test.
Why buyers check before they pay
With x402, your API answers a request with a 402 status code and a quote: the price, the network, the token and your payout wallet (payTo). The buyer's client signs a payment for that amount and calls again. There's no account and no API key.
That's simple, but payments in USDC can't be charged back. A quote only shows you're asking for money, and a settled payment only shows money moved. So agents use tools like Lumière PayCheck to check an endpoint before they pay. PayCheck monitors more than 138,000 x402 endpoints, including every endpoint listed in the x402 Bazaar, and gives each one a score from 0 to 100 and a verdict:
- Proceed: a real paid test delivered, and the endpoint is reliable in monitoring.
- Caution: something isn't confirmed yet, often because it hasn't been paid-tested. It doesn't mean "don't pay".
- Avoid: buyers shouldn't pay it.
1. Check your grade
Paste your endpoint URL at https://lumierepaycheck.org/check, or call GET /v1/score?url=<endpoint>. Both are free. You'll see whether your 402 quote is valid, whether your price and payout wallet are stable, and whether your endpoint answers.
Not listed yet? Add it at https://lumierepaycheck.org/sellers/add. It joins the catalog as soon as it answers a valid x402 quote.
2. Declare your payout wallet
A payout wallet that changes without warning can be a sign of a hijack, and PayCheck flags it. Declare your wallets so a change you make yourself is never mistaken for one. Publish them at https://<your-host>/.well-known/paycheck.json:
{ "payTo": ["0xYourBaseWallet", "YourSolanaWallet"] }
Or add a DNS TXT record at _paycheck.<your-host>: payto=0xYourBaseWallet,YourSolanaWallet.
3. Make your listing match your response
When PayCheck pays your endpoint, it compares the response with the example or schema in your x402 Bazaar listing. If your data arrives reshaped (fields nested under another key, a list where the listing shows one item, example fields you never return), the grade is capped at B. Update your listing's example to match your real response.
4. Get a paid test
Monitoring can't show that an endpoint really delivers once it's paid. Only a real paid test does. An endpoint that passes one shows "Paid and delivered", and every paid test comes with a receipt signed with our Ed25519 key. Anyone can look them up at GET /v1/test-receipts?url=<endpoint>.
You can fund a test of your own endpoint from its page with Verify your endpoint. You pay your own price once, our tester pays your endpoint that price at a random time within about 3 hours, so the money goes back to your payout wallet, and the result is public. Anything the test doesn't spend is refunded automatically. The full steps are in the seller guide: https://lumierepaycheck.org/docs/sellers#6-seller-funded-tests
5. Add known-answer tests (optional)
A schema check confirms your response has the right shape, not that the values are right. Add tests to the same paycheck.json, and paid checks will also compare the values at the JSON paths you choose, for a request whose answer is known. When every check passes, your endpoint page shows "values checked against known answers."
6. Add your badge
Every monitored endpoint has a public page and a badge that updates itself with its live grade. Copy the code from your endpoint's page and put it in your README or API docs, so buyers see your current grade before they integrate.
7. Check your setup
Run https://lumierepaycheck.org/sellers/check after any change to your paycheck.json. It shows what PayCheck read: your payout wallets, known-answer tests and anything else you declared. Your seller page at https://lumierepaycheck.org/sellers/<your-domain> shows all your endpoints and their verdicts in one place.
FAQ
What's the difference between caution and avoid?
Caution means something isn't confirmed yet, often that no paid test has run. Avoid means buyers shouldn't pay the endpoint.
How do I reach an A?
A passed paid test, 95% or better uptime, a stable payout wallet you've declared, and a listing that matches your response.
Does funding a test buy a better grade?
No. The grade comes only from what the test finds, and every funded test from the last 7 days and its result is listed on your endpoint's page.
Check your endpoint's grade for free: https://lumierepaycheck.org/check
Top comments (0)