{"uid":"cap_lhZ1GS-Y7bNyh60YOuP--","slug":"tollex-x402-payment-simulation-837b2e0d","name":"Tollex x402 Payment Simulation","description":"Tollex lets software agents buy APIs and tools under rules you set: it finds a capability that fits, checks your policy before anything is signed, pays with x402 in USDC on Base or USDG on Robinhood Chain, reconciles uncertain payments and returns a signed receipt.","url":"https://api.tollex.org/tools/x402_simulate_payment?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","examples":["https://merchant.example/v1/quote"],"maxLength":2048},"payer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"requirements":{"type":"object","properties":{"asset":{"type":"string"},"payTo":{"type":"string"},"amount":{"type":"string"},"scheme":{"type":"string"},"network":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"}},"additionalProperties":true}}},"responseSchema":{"type":"json","example":{"tool":{"id":"x402_simulate_payment","version":"1.0.0","provider":"tollex.robinhood-chain"},"result":{"payer":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","results":[{"amount":"7800","scheme":"exact","reasons":[],"wouldSucceed":true}],"gasSponsoredApprovalOffered":false},"evidence":[],"untrustedOutput":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0079","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.0079/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0chYTeXGYcY0mSHJOsxpq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0079","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Simulates an x402 micropayment for a given URL and payer address, validating payment requirements and returning a signed receipt without executing a real transaction","exampleAgentPrompt":"Before my agent actually pays, simulate an x402 USDC payment to https://merchant.example/v1/quote from wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base and show me the signed receipt so I can confirm everything looks right.","exampleUseCases":[{"title":"Preflight check before agent API purchase","prompt":"Before spending any real USDC, simulate the x402 payment from my wallet 0x1234567890abcdef1234567890abcdef12345678 to https://api.someservice.io/endpoint and tell me if the amount and network match what I expect."},{"title":"Policy compliance dry-run for autonomous agent","prompt":"My agent wants to buy a data API. Simulate the x402 payment to https://data.provider.com/v1/query from 0xDeAdBeEf00000000000000000000000000000001 with USDC on Base so I can check the payment requirements against my spending policy before it commits."},{"title":"Debugging a failed x402 payment flow","prompt":"An x402 payment to https://tools.merchant.xyz/search from wallet 0xFf00Ff00Ff00Ff00Ff00Ff00Ff00Ff00Ff00Ff00 keeps failing — can you simulate it and show me the signed receipt and any reconciliation details so I can figure out what's going wrong?"}],"resultDescription":"Returns a simulated payment outcome including validated payment requirements, reconciliation status, and a signed receipt — without debiting any real funds. Includes details such as the asset, amount, scheme, network, and whether the payment simulation succeeded or encountered a policy or parameter mismatch.","failureModes":["Invalid payer address format (must be 0x-prefixed 40-char hex) returns a validation error","Merchant URL returns no x402 payment requirements or is unreachable","Payment amount or asset in requirements object does not match merchant expectations","Network mismatch between specified network and merchant's accepted networks","Timeout exceeded when fetching payment requirements from merchant URL","Malformed requirements object causes schema validation failure"],"whenToPreferThis":"Use this endpoint when an AI agent needs to preflight or dry-run an x402 micropayment before committing real funds — ideal for policy checks, debugging failed payment flows, or testing merchant compatibility. Prefer this over direct payment endpoints when you need a signed receipt for audit purposes without financial side effects, or when validating that payment parameters (asset, network, amount) align with a merchant's requirements before an agent autonomously purchases a capability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:20.924Z","isFirstParty":false,"canonicalSlug":"tollex-x402-payment-simulation-837b2e0d"}