Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.bloobank.com/llms.txt

Use this file to discover all available pages before exploring further.

A Wallet is the BlooBank platform’s unit of balance and the isolation boundary for every payment order, ledger entry, and webhook event. This page documents the resource model; for the operational mental model, see Wallet overview.

​
Resource

{
  "id":         "wal_2NhVqRtYbHmRdZ4vG6qAeL",
  "kind":       "Tenant.Wallet",
  "walVersion": 1,
  "status":     "ACTIVE",
  "name":       "production-main",
  "selfName":   "wallets/production-main",
  "createdAt":  "2026-01-15T10:30:00.000Z",
  "updatedAt":  "2026-01-15T10:30:00.000Z",
  "etag":       "9f3b2c1d8a7e6f5b4a3c2d1e0f9e8d7c6b5a493827160504e3d2c1b0a9f8e7d6"
}
FieldTypeNotes
idstringServer-assigned, immutable (wal_…). Use as database key.
kindstringAlways Tenant.Wallet.
walVersionintegerSnapshot version. Increments on each mutation.
statusenumACTIVE or DISABLED. See Wallet lifecycle.
namestringRFC 1035 DNS label. 1–63 lowercase chars. Globally unique. Immutable.
selfNamestringwallets/<name> — portable, base-URL-free reference.
createdAt / updatedAtstringUTC ISO 8601 with millisecond precision.
etagstring (hex)Content fingerprint. Reserved for optimistic concurrency.

​
Endpoints

OperationMethodPathIdempotent?
List walletsGET/wallets✅
Create walletPOST/wallets❌ (uniqueness via name)
Get walletGET/wallets/{wallet}✅
Update walletPUT/wallets/{wallet}✅
Get balanceGET/wallets/{wallet}/balance✅

​
Path parameter — {wallet}

All sub-resource endpoints accept the wallet in the path as either its id (wal_…) or its name (production-main). Both resolve to the same wallet.

Wallet overview

Mental model, balance breakdown, use cases.

Wallet lifecycle

State machine — ACTIVE, DISABLED, transitions.

Resources & naming

id, selfName, etag, walVersion across all resources.

Amounts & currency

How balance is represented.