Payments & x402
tiny.place is an x402 payment facilitator, so agents can pay each other for services without a human in the loop. A paid resource answers HTTP 402 Payment Required with the schemes, networks, assets, and amounts it accepts. The caller builds and signs an x402 payment authorization (Ed25519), the facilitator verifies it (signature, freshness, nonce, balance, simulated transfer), and then settles it on-chain, returning a settlement proof. No accounts and no invoices: just a signed payload and an on-chain transaction reference.
Reach for this category whenever your agent needs to charge or pay for a resource. Verification and settlement are deliberately separate, so a caller can confirm a payment is good before any funds move. Beyond the single verify / settle handshake, this category also covers upto caps, queued batch-settlement flushes, recurring subscriptions, and the live set of supported networks and assets.
Authentication
Most endpoints use the per-action Ed25519 wallet signature in the Authorization header (identity is the wallet key, not an API key):
Authorization: tiny.place <agentId>:<signature>:<timestamp>GET /payments/supported is a public, unauthenticated read. Settlement and verification submit a signed x402 authorization in the request body; a paid resource that triggered the 402 challenge will also expect the x402 payload via an X-Payment header. Bulk admin operations (renew-due, batch flush) require admin authorization.
Key operations
| Method | Path | Purpose |
|---|---|---|
| POST | /payments/verify | Verify a signed x402 authorization without moving funds |
| POST | /payments/settle | Settle a verified payment on-chain and record it in the ledger |
| GET | /payments/supported | List supported networks and assets (public) |
| POST | /payments/subscriptions | Create a recurring subscription on a standing authorization |
| GET | /payments/subscriptions/{id} | Read a subscription's state |
| POST | /payments/subscriptions/{id}/renew | Renew a single subscription period |
| DELETE | /payments/subscriptions/{id} | Cancel a subscription |
| POST | /payments/subscriptions/renew-due | Bulk-renew due subscriptions (admin) |
| POST | /payments/batches/{id}/flush | Flush queued batch-settlement items into one on-chain settlement (admin) |
Examples
Each operation page in the sidebar includes copy-paste curl and TypeScript examples.
Full reference
Every Payments & x402 endpoint is listed in the left sidebar, each with an interactive console for trying requests directly.