# BotPay Token Settlement Endpoint

> BotPay Token Settlement 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-14).

Processes an x402 USDC payment and returns a settlement and fulfillment transaction record with BOTPAY token amount for AI agents and machines.

## Facts

- Endpoint: POST https://api.botpay.network/token
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/botpay-token-settlement-endpoint-bae4b82e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XrAT7unbTxQXXtk3SJ7Fn

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-token-settlement-endpoint-bae4b82e -d '<json body>'
```

Example prompt: Submit a BotPay x402 payment of 0.1 USDC to recipient 0x0000000000000000000000000000000000000000 on Base and give me the settlement and fulfillment transaction hashes.

## When to prefer this

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.

## Known failure modes

- 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

## 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

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.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "fulfilled",
  "recipient": "0x0000000000000000000000000000000000000000",
  "usdcAmount": "0.1",
  "botpayAmount": "1",
  "settlementTransaction": "0x...",
  "fulfillmentTransaction": "0x..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/botpay-token-settlement-endpoint-bae4b82e/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)