{"uid":"cap_LOD6cvwY4eZnvgQmc3S6E","slug":"beggar-bot-payment-verification-v1-verify-d6a5b7f8","name":"Beggar Bot Payment Verification - /v1/verify","description":"Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.","url":"https://beggar-bot-demand.beggarbot.workers.dev/v1/verify?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["payer","payee","amount","invoice"],"properties":{"payee":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"payee address"},"payer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"payer address"},"amount":{"type":"string","description":"USDC decimal amount, e.g. 0.01"},"invoice":{"type":"string","description":"invoice id echo [\\w.:-]{1,64}"},"network":{"enum":["base","base-sepolia"],"type":"string","description":"base (default) or base-sepolia"},"lookback_blocks":{"type":"string","description":"blocks to scan (max 5000 mainnet)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json"},"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_g4QlYZzfORZsxrKD5QVbI","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":"Verifies that a USDC payment was made on Base mainnet (or Base Sepolia) by checking on-chain for a matching transaction given payer, payee, amount, and invoice ID","exampleAgentPrompt":"Check whether wallet 0xAbCd...1234 actually paid 0.01 USDC to 0x7192...40e7 on Base mainnet for invoice ID 'order-789' — I need to confirm the payment went through before I release the download.","exampleUseCases":[{"title":"Confirm micropayment before delivering content","prompt":"Before I send the premium report to this user, check if wallet 0xA1B2...3456 paid 0.01 USDC to payee 0x7192...40e7 on Base mainnet with invoice ID 'report-2024-06'."},{"title":"Audit x402 API payment receipts","prompt":"I need to verify that wallet 0xDEAD...BEEF sent 0.01 USDC to 0x7192...40e7 on Base mainnet referencing invoice 'api-call-001' — scan the last 1000 blocks."},{"title":"Test payment flow on Base Sepolia","prompt":"Can you check if address 0xTest...0001 successfully paid 0.01 USDC to 0x7192...40e7 on base-sepolia for invoice 'test-invoice-42' so I can confirm my integration is working?"}],"resultDescription":"A JSON object indicating whether a matching on-chain USDC payment was found for the given payer, payee, amount, and invoice ID, along with relevant transaction details if verified.","failureModes":["Payment not found within the scanned block range — may need to increase lookback_blocks or wait for more blocks","Invalid Ethereum address format for payer or payee returns a validation error","Invoice ID exceeds 64 characters or contains disallowed characters","Network mismatch if payment was made on mainnet but base-sepolia was specified","Lookback block limit exceeded (max 5000 on mainnet) returns an error","x402 payment not made or incorrect amount causes the call itself to return 402 before verification runs","RPC or Cloudflare Worker timeout for large block scans"],"whenToPreferThis":"Use this endpoint when you need to confirm that a specific USDC payment was made on Base mainnet or Base Sepolia for a known invoice ID, payer, and payee — especially in x402 pay-per-call agent workflows where you need trustless on-chain confirmation before releasing a resource or granting access. Prefer this over off-chain payment records when cryptographic on-chain proof is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:34.058Z","isFirstParty":false,"canonicalSlug":"beggar-bot-payment-verification-v1-verify-d6a5b7f8"}