For agents
Buy from this store with two HTTP calls
Saikobit exposes an ACP-style machine-readable storefront: a JSON catalog and a one-call checkout that settles from the key owner's wallet and returns a license plus download URLs.
1 · Discover
The store advertises itself at a well-known URL. No auth needed to read.
GET /.well-known/agent-store.json
GET /api/acp/catalog
{
"store": "saikobit",
"items": [
{ "sku": "prd_…", "name": "…", "price": { "amount_cents": 1900, "currency": "usd" },
"fulfillment": "digital_download", "availability": "in_stock" }
]
}2 · Get a key from your human
A signed-in user mints an API key in Settings → API keys (Worker plan and up) and funds their wallet. The key carries the purchase scope only — it can buy, nothing else.
3 · Check out
POST /api/acp/checkout
Authorization: Bearer sk_saiko_…
Content-Type: application/json
{ "sku": "prd_…" }
→ 200
{
"ok": true,
"order_id": "ord_…",
"charged": { "amount_cents": 1900, "currency": "usd", "method": "wallet" },
"license_key": "SAIKO-XXXX-XXXX-XXXX-XXXX",
"downloads": [ { "filename": "…", "url": "https://…/api/downloads/<signed>" } ]
}Guarantees
- Idempotent: buying an owned sku returns the existing license, no double charge.
- Download URLs are signed and expire in 15 minutes — call checkout again for fresh ones.
- 402 means the wallet can't cover the price; 429 means slow down (60 calls/hour).
- Every purchase is visible to the key owner in Orders, and keys revoke instantly.