{"uid":"cap_XrAT7unbTxQXXtk3SJ7Fn","slug":"botpay-token-settlement-endpoint-bae4b82e","name":"BotPay Token Settlement 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/token","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"status":"fulfilled","recipient":"0x0000000000000000000000000000000000000000","usdcAmount":"0.1","botpayAmount":"1","settlementTransaction":"0x...","fulfillmentTransaction":"0x..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_NcEcvJUbbEDuJLR9OUINW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Processes an x402 USDC payment and returns a settlement and fulfillment transaction record with BOTPAY token amount for AI agents and machines.","exampleAgentPrompt":"Submit a BotPay x402 payment of 0.1 USDC to recipient 0x0000000000000000000000000000000000000000 on Base and give me the settlement and fulfillment transaction hashes.","exampleUseCases":[{"title":"Agent pays for API access","prompt":"My AI agent just called a BotPay-gated API endpoint — process the 0.1 USDC x402 payment to recipient 0xAbCd...1234 on Base and confirm the settlement transaction hash."},{"title":"Machine-to-machine micropayment settlement","prompt":"My autonomous robot needs to settle a 0.1 USDC payment to 0xDead...Beef via BotPay's x402 infrastructure on Base — complete the transaction and return the BOTPAY token amount I receive."},{"title":"Automated service delivery payment","prompt":"After delivering the requested data service, finalize the BotPay payment of 0.1 USDC to address 0x1234...5678 and give me both the settlement and fulfillment transaction records so I can log them."}],"resultDescription":"A JSON object containing: status ('fulfilled'), recipient address, USDC amount paid (e.g. '0.1'), BOTPAY token amount received (e.g. '1'), settlement transaction hash, and fulfillment transaction hash — providing full on-chain confirmation of the payment.","failureModes":["Insufficient USDC balance causes payment rejection","Invalid or malformed recipient address returns an error","x402 payment header missing or malformed leads to authentication failure","Network congestion on Base causes transaction delay or timeout","Duplicate payment submission may be rejected as already processed","Invalid payment amount (not matching required 0.1 USDC) causes fulfillment failure"],"whenToPreferThis":"Choose this endpoint when an AI agent, robot, or connected machine needs to settle an x402-protocol USDC micropayment on the Base blockchain and receive BOTPAY token confirmation. It is purpose-built for the machine economy and agent-to-service payment flows, especially when you need both a settlement and fulfillment transaction hash for audit or logging purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:26.639Z","isFirstParty":false}