{"uid":"cap_WPx9jgcigP33rR5124RES","slug":"botpay-x402-payment-verification-test-endpoint-d580b38b","name":"BotPay x402 Payment Verification Test Endpoint","description":"BotPay provides payment access, API discovery, automated service delivery, and settlement infrastructure for AI agents, applications, robots, and connected machines.","url":"https://api.botpay.network/test","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"message":"支付验证通过，可继续连接 MCP 进行交易下单。","protocol":"x402","resource":"/test","receiptId":"pi_38ep4k","nextAction":"connect_mcp","paymentVerified":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZS3bDUC0Cp_NjMcBhKTCz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies an x402 USDC payment and returns a receipt with a next-action directive to connect to the BotPay MCP for AI agent transactions","exampleAgentPrompt":"Test the BotPay x402 payment gateway to verify my USDC payment went through and get the receipt ID so I can connect to the MCP and start placing orders.","exampleUseCases":[{"title":"AI agent micropayment access verification","prompt":"I need to verify that my 0.1 USDC x402 payment to BotPay went through successfully — give me the receipt ID and confirm I can connect to the MCP to start trading."},{"title":"Testing x402 payment flow before production","prompt":"Can you run a test against BotPay's x402 endpoint to make sure the payment verification flow works end-to-end before I wire up my agent to it in production?"},{"title":"Gating a robot's API access behind payment","prompt":"My robot needs to confirm its USDC micropayment was settled on BotPay before it can proceed to the next step — verify the payment and tell me what action it should take next."}],"resultDescription":"Returns a JSON object confirming payment verification status (paymentVerified: true), the protocol used (x402), the resource path (/test), a receipt ID (e.g. pi_38ep4k), and a nextAction directive ('connect_mcp') instructing the agent to proceed to the BotPay MCP for further transaction actions. Response also includes a human-readable message confirming the payment passed.","failureModes":["Payment not yet confirmed — returns paymentVerified: false or HTTP 402 if no valid payment proof is attached","Malformed or missing x402 payment header — endpoint returns 402 Payment Required","Network or settlement delay on Base blockchain — payment receipt not yet available","Invalid USDC amount (not 0.1 USDC) — payment rejected","Expired or replayed payment proof — verification fails with error"],"whenToPreferThis":"Choose this endpoint when an AI agent, robot, or connected machine needs to verify an x402 USDC micropayment before being granted access to BotPay's MCP and downstream trading or ordering services. It is specifically suited to the x402 payment protocol on Base and is ideal for testing payment-gated API flows in machine-to-machine contexts. Prefer this over generic payment APIs when you need a receipt ID and a structured next-action directive pointing to MCP connectivity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:34:23.303Z","isFirstParty":false}