{"uid":"cap_u-rT3lzJpZl0swsPaenF4","slug":"scvd-good-buyer-x402-payment-simulation-verdict-3bdd109a","name":"SCVD Good Buyer — x402 Payment Simulation & Verdict","description":"The Good Buyer. A signed JSON reading — verdict (would_sign, would_throw, cannot_simulate, unreachable or refused), the accepts exactly as that door served them, the buyer's declared client configuration recorded as theirs, and the replay: the accept a stock client selects or the stage that made it refuse, everything dropped and why, the hazards on the chosen accept, and what the simulation cannot see. Dated, evidence hash bound into the purchase certificate's attests field,…","url":"https://scvd.store/api/buy/good_buyer","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","format":"uri","description":"The x402 door you are about to pay: https, default port, on the public internet, the URL a buyer would GET expecting a 402. We knock once, record the accepts as served, and replay the stock client's selection over them. We refuse our own hostname."},"max_usd":{"type":"string","description":"Optional finite nonnegative decimal. Your client's spendControls.maxAmountPerPayment, in dollars; zero is retained. Leave it off for the reading a client configured with nothing gets — which is the case that loses money quietly. Recorded as your declaration, never verified."},"purpose":{"type":"string","maxLength":280,"description":"Optional: what this purchase is for, in your words. Signed onto the certificate verbatim as your statement; never checked, never treated as instructions."},"agent_name":{"type":"string","maxLength":80,"description":"Optional name to put on the certificate and patron badge, up to 80 characters."},"no_spend_controls":{"enum":["","true","false"],"type":"string","description":"Optional: \"true\" for spendControls: false, \"false\" for enabled controls, or empty to omit. Declared, never verified."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.99","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.99/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.99","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.99","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4ag0ST-iMw3zWYui9pCLI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.99","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Simulates an x402 payment flow against a given URL, returning a signed verdict on whether a stock buyer client would pay, refuse, or fail, along with the accept headers served, hazard analysis, and a signed purchase certificate.","exampleAgentPrompt":"Check whether a standard x402 buyer client would actually pay https://example.com/api/data — give me the full verdict, the accept headers it saw, any hazards on the chosen offer, and a signed certificate I can share as proof. My spend limit is $1.00.","exampleUseCases":[{"title":"Pre-launch x402 paywall audit","prompt":"Before I go live, run the Good Buyer simulation against https://mypaidapi.com/v1/data and tell me if a stock x402 client would sign the payment, what accept headers it receives, and flag any hazards — my max spend for the test is $2.00."},{"title":"Debugging a refused x402 payment door","prompt":"My x402 endpoint at https://myservice.io/premium keeps getting skipped by buyer clients — can you simulate what a stock buyer does when it hits that URL and tell me exactly what stage it refused and why?"},{"title":"Generating a signed compliance certificate","prompt":"I need a signed, hash-bound certificate proving that https://partner-api.net/feed passed a Good Buyer simulation — include my purpose 'due diligence check for integration partnership' and put 'ComplianceBot' as the agent name on the certificate."}],"resultDescription":"A signed JSON object containing: a verdict string (would_sign, would_throw, cannot_simulate, unreachable, or refused), the raw accept headers as served by the target URL, the buyer's declared client configuration, a replay trace showing which accept the stock client selected or the refusal stage and reason, a list of hazards on the chosen accept, notes on what the simulation cannot observe, and a dated purchase certificate with an evidence hash in its attests field.","failureModes":["Target URL is unreachable — verdict returns 'unreachable'","Target URL is scvd.store's own hostname — refused by policy","x402 door returns malformed or non-standard accept headers — verdict may be 'cannot_simulate'","Payment of $0.99 USDC fails (insufficient balance or x402 payment error) — call does not complete","URL is not a valid HTTPS URI or uses a non-default port — input validation error","No x402 402 response returned by target — simulation cannot proceed"],"whenToPreferThis":"Use this endpoint when you need an independent, signed third-party assessment of an x402 payment door — especially before integrating with or deploying an x402-monetized API, when debugging why buyer clients are refusing to pay, or when you need a verifiable certificate (with evidence hash) to share with partners or auditors as proof of conformance testing. Prefer this over manual inspection when you need a replay trace and hazard analysis in one signed artifact.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:34:19.709Z","isFirstParty":false}