{"uid":"cap_MVaORFkAjoLV4EIAcYfRe","slug":"x402-doctor-diagnose-x402-payment-endpoint-ec454433","name":"x402 Doctor – Diagnose x402 Payment Endpoint","description":"Why is my x402 endpoint broken? Diagnose and debug an x402 payment endpoint (or MCP server) when payments fail: checks the 402 challenge, accepts[] (network, payTo, amount, asset), resource URL, Solana settlement readiness, which wallets and agents can pay, Bazaar/OpenAPI discovery and the browser paywall. Returns every check with a fix hint. Read-only: never pays. Bulk: 1000 credits for $0.80 via /api/v1/credits.","url":"https://x402-doctor.fizzl.eu/api/v1/diagnose?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"The x402 endpoint to diagnose (public http(s) URL)."},"method":{"enum":["GET","POST"],"type":"string","description":"HTTP method of the endpoint. Default: try GET, then POST."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["url","overall","checks"],"properties":{"url":{"type":"string"},"checks":{"type":"array","items":{"type":"object","required":["id","status","message"],"properties":{"id":{"type":"string"},"hint":{"type":"string"},"group":{"enum":["challenge","accepts","resource","settlement","wallets","discovery","browser"],"type":"string"},"status":{"enum":["pass","warn","fail","info","skip"],"type":"string"},"message":{"type":"string"}}}},"method":{"enum":["GET","POST",null],"type":["string","null"]},"overall":{"enum":["pass","warn","fail"],"type":"string"},"wallets":{"type":"array","items":{"type":"object","properties":{"no":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"network":{"type":"string"}}}},"yes":{"type":"array","items":{"type":"string"}},"agent":{"type":"boolean"},"wallet":{"type":"string"}}},"description":"Which wallets can pay: per wallet, the networks where payment works (yes) and where it fails, with the reason (no)."},"challenge":{"type":["object","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vs9859KpWGrctHc3BgGHj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Diagnoses and debugs an x402 payment endpoint by running a suite of read-only checks across the 402 challenge, accepts configuration, resource URL, Solana settlement readiness, wallet/agent compatibility, and discovery/browser paywall setup, returning each check with a status and fix hint.","exampleAgentPrompt":"Can you diagnose why my x402 payment endpoint at https://my-api.example.com/premium-data is broken — check the 402 challenge, accepts config, Solana settlement readiness, and tell me which wallets and agents can actually pay it?","exampleUseCases":[{"title":"Debugging a failing AI agent payment","prompt":"My AI agent keeps failing to pay my x402 endpoint at https://api.myapp.com/data — can you run a full diagnosis on it using GET and tell me exactly what's misconfigured and how to fix it?"},{"title":"Pre-launch x402 integration checklist","prompt":"Before I launch, can you check my new x402 paywall at https://tools.mysite.com/api/report to make sure the challenge, Solana settlement, wallet compatibility, and Bazaar discovery are all set up correctly?"},{"title":"Identifying which wallets can pay","prompt":"I want to know which crypto wallets and AI agents can successfully pay my x402 endpoint at https://x402.myservice.io/generate — please run the diagnosis and list the ones that work and the ones that fail with reasons."}],"resultDescription":"Returns an overall pass/warn/fail status, a list of individual checks (each with an id, group, status, message, and optional fix hint), the detected HTTP method, the parsed 402 challenge object, and a per-wallet breakdown showing which networks allow payment and which fail with reasons.","failureModes":["Target URL is not publicly reachable (network timeout or DNS failure)","Endpoint does not return a 402 response at all (not an x402 endpoint)","Malformed or missing 402 challenge header prevents check execution","Solana RPC unavailable causing settlement checks to be skipped","Invalid URL format provided as input"],"whenToPreferThis":"Use this endpoint when an x402-protected API or MCP server is behaving unexpectedly — payments failing, agents unable to transact, or the paywall not rendering in browsers. It is the go-to read-only diagnostic tool covering every layer of the x402 stack (challenge format, accepts[] config, settlement, wallet compatibility, and discovery) in a single call, without ever executing a real payment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:12.823Z","isFirstParty":false,"canonicalSlug":"x402-doctor-diagnose-x402-payment-endpoint-ec454433"}