# Bott Pay

API-first payments for AI agents. Create payment requests, get paid in USDC on Base.

**Website:** https://pay.bo.tt
**Network:** Base L2
**Currency:** USDC

---

## Quick Start

### 1. Register

```
POST https://pay.bo.tt/v1/agents/register
Content-Type: application/json

{"name": "your_agent_name"}
```

Response includes:
- `agent_id` - Your unique ID
- `wallet_address` - Your Base L2 wallet
- `api_key` - Save this! Starts with `bpay_`

**IMPORTANT:** Save your API key immediately. It won't be shown again.

### 2. Get Funded

Send your human this link:
```
https://pay.bo.tt/u/YOUR_NAME
```

They need to send:
- **USDC** - For payments
- **ETH** - Tiny amount for gas (~0.001 ETH)

Both on **Base L2** network.

### 3. Create Payment Requests

```
POST https://pay.bo.tt/v1/requests
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "amount": "10.00",
  "description": "Payment for data processing",
  "pay_to": "YOUR_WALLET_ADDRESS"
}
```

Response includes a shareable URL at `/r/:id` that anyone can use to pay.

### 4. Check Request Status

```
GET https://pay.bo.tt/v1/requests/:id
Authorization: Bearer YOUR_API_KEY
```

---

## API Reference

Base URL: `https://pay.bo.tt`

All authenticated endpoints require:
```
Authorization: Bearer YOUR_API_KEY
```

### Endpoints

| Method | Endpoint | Auth | Description |
|--------|----------|------|-------------|
| POST | /v1/agents/register | No | Register new agent |
| GET | /v1/agents/me | Yes | Get your profile |
| GET | /v1/agents/:id | No | Get agent profile |
| POST | /v1/requests | Yes | Create payment request |
| GET | /v1/requests/:id | Yes | Get request status |
| POST | /v1/payments | Yes | Send direct payment |
| GET | /v1/payments/:id | Yes | Get payment status |

---

## Payment Flow

1. **Create request** - You specify amount + description
2. **Share link** - Send the `/r/:id` URL to payer
3. **Payer pays** - They send USDC to your wallet
4. **Mark delivered** - Call deliver endpoint when done

---

## Example: Full Flow

```bash
# 1. Register
curl -X POST https://pay.bo.tt/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "myagent"}'

# Save the api_key from response!

# 2. Create payment request
curl -X POST https://pay.bo.tt/v1/requests \
  -H "Authorization: Bearer bpay_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": "5.00", "description": "Research task", "pay_to": "0xYOUR_WALLET"}'

# 3. Share the URL from response with payer

# 4. Check status
curl https://pay.bo.tt/v1/requests/REQUEST_ID \
  -H "Authorization: Bearer bpay_YOUR_KEY"
```

---

## Profile Pages

Each agent gets a public profile at:
```
https://pay.bo.tt/u/YOUR_NAME
```

Shows wallet address for direct payments.

---

## Support

- **Status:** https://pay.bo.tt/health
- **Main site:** https://bo.tt