Billing

AkaPhone sells prepaid credit packs. One credit is one device-minute. See Credits and plans for what each plan includes.

Packs#

Prices are in US dollars. Sales tax or VAT is added at checkout where it applies.

Buying credits#

In the dashboard#

Open Billing, choose a pack and click Buy. You are taken to a Lemon Squeezy checkout page. After paying you return to https://akaphone.abhgnx-417.workers.dev/billing?checkout=success, and the credits appear as soon as Lemon Squeezy confirms the order, normally within a few seconds.

Over the API#

POST /v1/billing/checkout returns a checkout URL for the pack. Open it in a browser to pay:

curl -X POST https://akaphone.abhgnx-417.workers.dev/v1/billing/checkout \
  -H "Authorization: Bearer $AKAPHONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pack": "1375"}'

const { url } = await fetch("https://akaphone.abhgnx-417.workers.dev/v1/billing/checkout", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AKAPHONE_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ pack: "1375" }),
}).then((r) => r.json());

import os, requests

url = requests.post(
    "https://akaphone.abhgnx-417.workers.dev/v1/billing/checkout",
    headers={"Authorization": f"Bearer {os.environ['AKAPHONE_API_KEY']}"},
    json={"pack": "1375"},
).json()["url"]

{ "url": "https://akaphone.lemonsqueezy.com/checkout/custom/4f1c0e7a-…" }

The checkout is tied to your account, so the credits go to the account that requested it, whoever pays.

Receipts and invoices#

Lemon Squeezy is the merchant of record. It emails the receipt to the address used at checkout and handles tax. For an invoice with your company details, use the link in that receipt email.

The ledger#

Every change to your balance is a row in the credit ledger: Billing › Credit ledger in the dashboard, or GET /v1/billing/ledger.

{
  "entries": [
    { "id": "led_01m5vqsywgmvjvevzqnbkz", "delta": -10, "kind": "usage", "ref": "dev_s6zr7mr4f2f1:w1", "created_at": "2026-10-26T09:24:09.000Z" },
    { "id": "led_01m5vqsywgmzjsatq42611", "delta": 1375, "kind": "purchase", "ref": "4821733", "created_at": "2026-10-26T09:02:51.000Z" },
    { "id": "led_01m5vqsywgadfgngs4y1q2", "delta": 60, "kind": "grant", "ref": "signup:usr_01m5vqsywg3mxj7dyxv9q9", "created_at": "2026-10-20T15:40:12.000Z" }
  ]
}

Your balance is the sum of the ledger minus minutes charged in the current, not yet written, 10-minute windows. GET /v1/me always returns the exact current balance.

Refunds#

Refunds are issued through Lemon Squeezy. Email hello@akaphone.com with the order number from your receipt. When a refund is processed:

• Credits are taken back in proportion to the amount refunded: refunding half of a 1,375-credit pack removes 688 credits (rounded). Further partial refunds of the same order take back only the difference.
• Your balance can go negative if you already used those credits. While it is negative (strictly, below 1) you cannot create devices, and running devices stop at their next minute.
• Refunding a Team pack, fully or partly, ends the Team plan immediately; you return to Dev.

Running out#

• Creating a device needs a balance of at least 1 credit, otherwise 402 insufficient_credits.
• While a device runs, the dashboard and stream viewers get a credits.low warning when the balance is 5 or less.
• When a minute is due and the balance is below 1, the device stops with reason credits. Your data on that device is gone, as with any stop, so snapshot anything you want to keep while you still have credits.