Altradits

Power your app with Lightning.

Create invoices to your own Lightning address. Verify settlement. Get webhooks. Your customers pay you straight. Altradits never holds their money.

Start in the sandboxRead the reference

What you can build

Anything that takes Lightning payments, without running a node.

How it works

  1. Register your own Lightning address. Prove it with a 1 sat challenge payment from the wallet behind it.
  2. Your app asks the API for an invoice. It fetches one from your address and checks the exact amount and description.
  3. Your customer pays your address straight. The sats never pass through Altradits.
  4. You poll settlement or wait for a webhook. Signed, retried, logged.
Payment flow diagram Your app asks the API for an invoice. The API fetches it from your wallet. Your customer pays your wallet straight. Settlement and webhooks flow back. Your appyour code Altradits APIchecks, tracks Your walletyour address invoice? fetch invoice BOLT11 webhook Customerany wallet sats, straight to you

Pricing

One charge. No tiers, no seats, no hidden fees.

0.5% of settled volume, prepaid in sats. Top up your fee balance (100 sats minimum). Each settled payment deducts 0.5% rounded up, minimum 1 sat. The statement shows every top-up and fee. Credits are non-refundable, except on account close: unused balance pays out to a verified destination within 7 days.

The sandbox is free. Test keys, test invoices, test webhooks, free test credit. Nothing real moves.

Quickstart

  1. Get a sandbox key. Sign in on the dashboard with your email. Create a test key. It starts with ak_test_ and can never touch mainnet.
  2. Create an invoice. To the simulator address, free.

curl

curl -X POST https://altradits.com/api/dev/v1/invoices \
  -H "Authorization: Bearer ak_test_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-123" \
  -d '{"destinationId":"DEST_ID","sats":5000,"memo":"order 123"}'

JavaScript

const res = await fetch("https://altradits.com/api/dev/v1/invoices", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ak_test_your_key_here",
    "Content-Type": "application/json",
    "Idempotency-Key": "order-123"
  },
  body: JSON.stringify({ destinationId: "DEST_ID", sats: 5000, memo: "order 123" })
});
const { invoice } = await res.json();
// Show invoice.bolt11 as a QR. Your customer pays your address straight.
  1. Settle it and receive a webhook. In the sandbox, play the customer with one call. Register a webhook URL first, then watch the signed invoice.settled POST arrive.
curl -X POST https://altradits.com/api/dev/v1/sandbox/settle \
  -H "Authorization: Bearer ak_test_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"invoiceId":"INV_ID"}'

Endpoints

Every endpoint is in the reference. Every reply carries a request id. Every error carries a stable code.

GroupStatusWhat it does
Accounts, keys, destinationsLiveEmail sign-in, scoped API keys, your own addresses with ownership proof.
Invoices, verify by hashLiveExact-amount invoices in sats or fiat, settlement checks.
WebhooksLiveSigned invoice.settled POSTs, retried and logged.
Top-ups, balance, statementLivePrepaid fee balance in sats, full usage ledger.
Sandbox simulatorSandbox onlyFree test destination and one-call settlement. Test keys only.
Account close and refund payoutPlannedSelf-serve close with the unused balance paid out. For now, ask through the contact form (a $1 spam shield applies).

Limits

Security

Support

Questions about the API: write through the contact form (a $1 spam shield applies) and quote the request id from the reply. The health endpoint names whether the API and the sandbox are on.

Open the dashboardRead the reference