SOVEREIGN PAYMENT API

Zero-KYC. Edge-Native. Unkillable Bitcoin Infrastructure for AI Agents.

0. The Doctrine

This is not a traditional payment gateway. There are no dashboards, no KYC forms, and no centralized points of failure. This is a stateless, edge-native API that routes Bitcoin directly to your self-custodied wallets. We provide the routing logic; you hold the keys.

🤖 Built for AI Agents

Sub-second invoice generation. Deterministic address derivation. Webhook-driven fulfillment. Perfect for autonomous machine-to-machine economies.

🛡️ Zero Custody Risk

We never touch your private keys. You provide a BIP84 zpub. We derive the addresses. You sweep the funds.

1. Quickstart (60 Seconds)

Step 1: Onboard your Wallet

curl -X POST https://merchant-api-1x.flux-ext-capital401.workers.dev/v1/admin/onboard   -H "X-Admin-Secret: YOUR_SECRET"   -H "Content-Type: application/json"   -d '{
    "zpub": "zpub6rFR7y4Q2Aij...",
    "webhook_url": "https://your-agent.com/fulfill"
  }'

Response: {"status": "onboarded", "api_key": "mch_..."}

Step 2: Generate an Invoice

Use your api_key to generate a unique, single-use Bitcoin address for a specific USD amount.

curl -X POST https://merchant-api-1x.flux-ext-capital401.workers.dev/v1/checkout   -H "Authorization: Bearer mch_..."   -H "Content-Type: application/json"   -d '{"amount_usd": 15.50}'

Response: {"address": "bc1q...", "amount_sats": 23800, "opaqueId": "..."}

Step 3: Fulfill via Webhook

When the exact amount_sats hits the address, our edge Oracle fires a POST request to your webhook_url.

{
  "opaqueId": "uuid-from-step-2",
  "address": "bc1q...",
  "sats_received": 23800,
  "txid": "raw_txid...",
  "status": "confirmed"
}

2. Architecture & Limits

Rate Limits: 60 requests/minute per API key. Hard enforced at the edge.
Address Expiry: Unused addresses auto-expire after 7 days to preserve pool entropy.
Uptime: Hosted on Cloudflare Workers. 100% SLA by default.

3. Support & Doctrine

This infrastructure is sovereign. There is no support ticket system. If you lose your api_key, it is gone. If you fail to sweep your funds, they remain in your self-custodied wallet. Read the code. Trust the math.

[ END OF LINE ]