Billing

Also for this capability: API · CLI · MCP · SDKs

Your org's balance, what it has spent, and the cards it pays with.

hanzo billing alerts list

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

Command	What it does
`hanzo billing balance`	Prepaid credit the caller's org can still spend
`hanzo billing credits`	Lists the caller's credit grants — every one of them, spent and lapsed and voided included.
`hanzo billing ledger`	Answers the org's own postings inside `range=`, each as a signed entry: a DEPOSIT CREDITS the wallet (positive, account…
`hanzo billing mode`	Moves this org between sandbox money and real money.
`hanzo billing payouts`	Answers the org's outbound payouts, newest first — amount, destination, status, and the failure reason where one…
`hanzo billing plans`	The plan catalog, priced with whatever offer is in force
`hanzo billing settings`	Answers the PUBLIC half of this org's processor configuration — the ids a browser needs to tokenize a card, and the…
`hanzo billing tier`	Answers which tier the caller is on, what it allows, and what is left to spend.
`hanzo billing transactions`	Answers one page of the caller's own ledger, newest first: what moved, how much, when, and what it was tagged with.
`hanzo billing wire`	Answers where to send a wire top-up: the receiving bank details, with the caller's own payment reference.

accounts

Command	What it does
`hanzo billing accounts list`	Answers the caller's billing accounts: the org itself, its currency, when it was opened, and the caller's own standing…
`hanzo billing accounts members <id>`	Answers one billing account's roster.

alerts

Command	What it does
`hanzo billing alerts authorize`	Answers whether one proposed spend fits inside this org's caps.
`hanzo billing alerts create`	Opens a spend cap on the caller's own org.
`hanzo billing alerts list`	Lists this org's spend caps: the ceiling, its scope, whether it enforces, and how much of it has been spent this period.
`hanzo billing alerts rm <id>`	Removes one of the caller's spend caps and answers 204.
`hanzo billing alerts update <id>`	Changes one spend cap: raise or lower the ceiling, flip enforcement, retune the rate limit.

credit-balance

Command	What it does
`hanzo billing credit-balance breakdown`	Answers that same spendable credit split by grant tag, with the earliest expiry under each and the total across all of…
`hanzo billing credit-balance get`	Answers what the caller can spend right now, one entry per currency.

crypto

Command	What it does
`hanzo billing crypto deposit create`	Issues a deposit address the caller can send crypto to, on the asset they ask for.
`hanzo billing crypto deposit get <id>`	Reads one of the caller's own deposit intents back — pending, confirming, or succeeded.
`hanzo billing crypto options`	Answers which chains and tokens the crypto rail accepts — what an asset picker renders.

invoices

Command	What it does
`hanzo billing invoices collect <id>`	Collect an issued invoice from credits, balance, then card
`hanzo billing invoices create`	Raise a draft invoice against a customer
`hanzo billing invoices get <id>`	Read one invoice
`hanzo billing invoices issue <id>`	Issue a draft invoice, making it collectible
`hanzo billing invoices list`	Lists the caller's invoices, newest first, with the count beside them.
`hanzo billing invoices pdf <id>`	Download one invoice as a PDF
`hanzo billing invoices void <id>`	Void a draft or issued invoice

methods

Command	What it does
`hanzo billing methods create`	Save a card or account for the caller
`hanzo billing methods list`	Cards and accounts on file for the caller
`hanzo billing methods rm <id>`	Removes one card or account the caller has saved.

portal

Command	What it does
`hanzo billing portal methods create`	Save a card or account for the caller
`hanzo billing portal methods list`	Cards and accounts on file for the caller
`hanzo billing portal methods rm <id>`	DetachPortalMethod is DetachMethod at the address a hosted checkout addresses it by.

recharge

Command	What it does
`hanzo billing recharge run-all`	Sweeps every org's auto-recharge and answers what it did.

Command	What it does
`hanzo billing subscribe card`	Buy a plan with a card

subscriptions

Command	What it does
`hanzo billing subscriptions cancel <id>`	End a subscription
`hanzo billing subscriptions list`	Lists the plans the caller holds, with the count beside them.
`hanzo billing subscriptions reactivate <id>`	Put a canceled subscription back on its plan

topup

Command	What it does
`hanzo billing topup create`	Charges a card the caller already saved and credits the balance.
`hanzo billing topup token`	Charges a single-use card token and credits the caller's balance.

usage

Command	What it does
`hanzo billing usage accounts`	Answers per-account totals for the linked provider accounts the gateway ROUTED this caller's traffic through —…
`hanzo billing usage get`	Every billed call the caller's org made, attributed to a product
`hanzo billing usage rollup`	Answers the caller's month: what their plan includes, what has been consumed against it, and the wallet beside it.

On this page