Concept · L3

Wallet — L3.

A Tenant's balance on Ainfera; Inferences debit the Wallet and each debit emits a Receipt.

[02]What it isOne-paragraph definition

The Wallet is the settlement primitive. It holds a balance, is topped up by the Tenant, and is debited per Inference at pass-through Provider cost plus a thin Ainfera fee. Every debit is a signed Receipt and a ledger entry.

[03]Where it shows upAPI · SDK · Audit log

Where it shows up.

API: GET /v1/wallet · POST /v1/wallet/topup · GET /v1/wallet/ledger
SDK: from ainfera import Wallet
Audit log: appears as ledger.debited, wallet.topped_up events

[04]Code exampleWorking snippet

Code example.

wallet = client.wallet.get()
print(wallet.balance_usd)

# Top up
client.wallet.topup(amount_usd=50.00)

# Every Inference debits the Wallet
out = client.inferences.create(agent_card=card, model="claude-opus-4-7",
    messages=[{"role": "user", "content": "hi"}])
print(out.receipt.amount_usd)

[05]RelatedOther concepts · full ontology

Spec alignment

Receipt structure is designed to satisfy financial-audit and Annex IV record-keeping requirements.