# BotPay x402 Payment Verification Test Endpoint

> BotPay x402 Payment Verification Test Endpoint is a paid API for AI agents from api.botpay.network, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Verifies an x402 USDC payment and returns a receipt with a next-action directive to connect to the BotPay MCP for AI agent transactions

## Facts

- Endpoint: GET https://api.botpay.network/test
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/botpay-x402-payment-verification-test-endpoint-d580b38b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WPx9jgcigP33rR5124RES

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability botpay-x402-payment-verification-test-endpoint-d580b38b
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

BotPay provides payment access, API discovery, automated service delivery, and settlement infrastructure for AI agents, applications, robots, and connected machines.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "message": "支付验证通过，可继续连接 MCP 进行交易下单。",
  "protocol": "x402",
  "resource": "/test",
  "receiptId": "pi_38ep4k",
  "nextAction": "connect_mcp",
  "paymentVerified": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/botpay-x402-payment-verification-test-endpoint-d580b38b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.botpay.network](https://www.zero.xyz/host/api.botpay.network/llms.txt)