# Billing

## One rate, prepaid in USD

`GET /console/v2/billing/rate` returns the rate on its own:
`rate_nano_usd_per_minute: "5000000"` (**$0.005 per connected minute** — half
a cent), `metering_basis: "connected_minute_rounded_up"`, and a
`rate_version`. Every call rounds up to the next full minute. Cost is
`ceil(connected_seconds / 60) × rate` in integer nano-USD; a 59-second call
costs $0.005 (1 minute), a 61-second call costs $0.01 (2 minutes), and a
10-minute call costs $0.05.

Read the rate from this route rather than hard-coding it. A published rate
change is a new `rate_version`; sessions already admitted keep the version
they froze.

## Pure pay as you go

There is no monthly platform fee, no minimum spend, no seat fee, no
commitment, and no contract. You top up a prepaid wallet with whatever amount
you want, you spend what you use, and whatever is left stays yours.

Connected voice minutes are the only metered thing on this platform. Dvaarik
charges nothing for:

- creating projects, agents, or API keys;
- the console;
- the SDKs (`@dvaarik/node`, `dvaarik`, `@dvaarik/web`);
- webhook delivery, retries, and dead letters;
- the [playground](/playground), beyond its own connected minutes — a
  playground call is a real call, billed at the same rate as any other;
- post-call analysis. Insights run on **your** model under **your** provider
  account, so that provider bills you for those tokens and Dvaarik adds
  nothing on top;
- **text and chat.** We sell voice minutes only. A website chat bot built on
  your own model costs you nothing from us.

`GET /console/v2/billing/summary?project_id=…` returns the account wallet —
`balance_nano_usd`, `held_nano_usd`, `spendable_nano_usd`,
`lifetime_topup_nano_usd`, `low_balance_threshold_nano_usd`, `low_balance`
— together with the rate and the project's concurrency, request-rate, and
maximum-session limits. The wallet belongs to the account; it is reported
against one project.

## Holds and settlement

A session places a hold for its maximum duration when admitted. It is refused
with `402` when the spendable balance cannot cover that hold. When the session
ends, the hold is released and the connected seconds are settled exactly once.
`GET /console/v2/billing/transactions?limit=50&offset=0` lists the ledger
newest first; `amount_nano_usd` is null on archival rows from before USD.

## Top up

1. `GET /console/v2/billing/quote?amount_usd_cents=2500` — no fee, no markup:
   one cent buys exactly 10,000,000 nano-USD. Bounds are $10 to $2,000.
2. `POST /console/v2/billing/topup` with `{ "amount_usd_cents", "project_id" }`
   creates a Razorpay USD order and records it first; the response carries
   `order_id` and `razorpay_key_id`, which the console hands to Razorpay
   Checkout. `502` means the gateway did not create an order; `503` means the
   order could not be recorded and no checkout was returned.
3. The payment webhook credits the wallet. The console polls the summary until
   `lifetime_topup_nano_usd` grows; a successful Checkout alone is never
   treated as credit.

Whether international cards are accepted depends on Razorpay international-payment
enablement for the Dvaarik merchant account; the console reports the gateway's
answer rather than assuming it.

## Receipts

`GET /console/v2/billing/invoices` lists receipts for paid top-ups;
`GET /console/v2/billing/invoices/{invoice_id}.pdf` returns the PDF. A receipt
exists only once a payment has landed.

## What we store

Storage is not a line on your bill here, because there is almost nothing of
yours on our disks.

**Call recordings live in your own phone company's account.** When an agent
has `record_calls` enabled, Dvaarik asks your carrier to record the call.
The audio is written into your own carrier account under your own carrier
plan. Dvaarik stores only the carrier's reference to that recording, so you
fetch the audio from your carrier with your own credentials. We pay nothing to
store it, and you are not charged twice for storing it.

**Browser calls have no recording.** A browser call has no carrier in the
path, so there is no carrier to record it and no recording reference on the
call.

**Transcripts live in the Dvaarik database for 90 days and are then
deleted.** `store_transcript` controls whether one is written at all;
`retention_days` cannot extend a transcript past that 90-day window. Pull
anything you need to keep — through the API or your call webhook — inside it.

**The insight block survives the transcript.** The short post-call summary
produced by `insight_config` stays on the call record after the transcript
is deleted: it is small, and it is your business record of what the call was
about. It is generated on your own model, on your own provider account.

## Estimate the per-minute cost before you build

The platform fee is exact and published — $0.005 per connected minute,
rounded up to the next minute. What you cannot know from this API alone is
what your *chosen* speech, language-model, voice, or realtime provider will
charge for that same minute, because that is billed by them, on your account,
at whatever rate you negotiated.

The console's cost-estimate card (agent create/edit, the agent list, and the
[pricing](/pricing) calculator) renders a breakdown — Listen / Think / Speak
or Realtime, your carrier's rate typed in by hand, and the platform fee — from
a small table of public list prices in `src/lib/providerListPrices.ts`,
dated and sourced per provider. It is always an estimate: only the platform
fee row is exact, computed from the same nano-USD constants as the rest of
this page; every provider row can drift the moment that provider changes its
own price list.

---

Source: https://developers.dvaarik.com/docs/billing · every page as one file: https://developers.dvaarik.com/docs.md