# Personal Wallet Payment System Agent API

Base URL: `https://web8889.com`

## Current capabilities

- Hosted checkout for supported assets.
- Fixed-price payment links.
- Payment records with order IDs and transaction hashes.
- Merchant automation API for active Agent Pro merchants.
- Receipt printer job polling and acknowledgement.

## Authentication

Merchant automation endpoints use an Agent Pro API key:

```http
Authorization: Bearer mm_api_...
```

Never send a private key or seed phrase. The platform does not custody user funds. API keys should be kept server-side and revoked if exposed.

## Discovery

- `GET /api/public/agent-capabilities` — credential-free current capability document.
- `GET /openapi.json` — machine-readable API description.
- `GET /.well-known/agent.json` — agent discovery manifest.

## Available merchant endpoints

| Method | Endpoint | Access |
|---|---|---|
| GET | `/api/merchant/code-products` | Active Basic or higher subscription |
| POST | `/api/merchant/code-products` | Active Basic or higher subscription |
| POST | `/api/merchant/code-products/bulk` | Active Agent Pro subscription + API key |
| GET | `/api/merchant/printer/jobs?status=pending` | Active Agent Pro subscription + API key |
| POST | `/api/merchant/printer/jobs/{jobId}/printed` | Active Agent Pro subscription + API key |

## Payment model

EVM routes settle as Base USDC after checkout verification. Solana assets are shown only when a configured Solana receiving path exists. A successful payment is associated with an order ID and transaction hash. The buyer still signs the transaction in their own wallet.

## Not available yet

The following are planned and must not be assumed to be live:

- AgentPay Intent creation.
- Direct autonomous agent checkout.
- MCP/UCP integration.

See [OpenAPI](./openapi.json) for request and response schemas.