CANDI/Use cases/AI and usage credits

Bill an AI product with usage credits Per-seat pricing does not fit a product whose cost per request is real and variable. Credits do — and they are the billing model most likely to be rebuilt badly in-house.

From 3.9% all in · No monthly fee · Test mode is open today

Why credits are hard

The hard part is not the balance. It is what happens when the same event arrives twice.

A credit balance looks like a number in a table until you run it in production. Then: a retried request double-debits a customer. A worker crashes between calling the model and writing the debit. Two concurrent requests both read the same balance and both decide there is enough. A refund has to put credits back without inventing them. A monthly grant has to land exactly once even if the scheduler fires twice.

Every one of those is a correctness bug that shows up as money being wrong, which is the category of bug customers do not forgive.

How CANDI does it

Idempotency is required, not optional. Because the alternative is silent double-spend.

  • Credit writes require a durable idempotency key, unique per account. A replayed request is recognised as the same write, not applied twice.
  • Every movement posts to a double-entry ledger in the same transaction as the balance change, so the books cannot disagree with the balance.
  • Prepaid top-ups and recurring grants use the same primitives as the rest of billing.
  • Refunds return credits through the ledger rather than by editing a number.
  • Signed webhooks when a balance moves or runs low, so you can prompt a top-up.

Money is handled as integer cents throughout, with one rounding path. There is no second place where a total gets re-derived slightly differently.

Before you build

What is live today. Test mode is the whole API.

Where CANDI actually is today. Live payments are not switched on yet, so nobody is taking live money through CANDI. Test mode is fully open — its own database, its own keys, the whole API, and Stripe onboarding, so you can connect a Stripe account and build the entire integration today. Stripe hosts the verification; CANDI never sees your identity documents.
Get started

Meter your product properly. Test mode opens the moment you sign up.

From 3.9% all in · No monthly fee · Test mode is open today

Questions

Answered plainly. Including the ones where the answer is no.

How do you stop a retried request from double-charging credits?

Credit writes require a durable idempotency key that is unique per account, so a replay is recognised as the same write rather than applied a second time.

Can I combine a subscription with usage credits?

Yes — a recurring grant plus metered debits is the same integration shape as any other billing object, because it is one API.

Do refunds restore credits?

Yes, through the same double-entry ledger the debits went through, rather than by editing a balance directly.

Can I bill live usage through CANDI today?

Not live yet — live payments are not switched on. The full credits API works in test mode now.