Skip to main content

Wallets Overview

Multi-currency wallet management
Draft/reference namespace only. Wallet APIs are retained here for tenant-specific overlays and compatibility, not as the reviewed primitive BaaS default.

Overview

Wallet endpoints are a reference/compatibility layer for tenants that still expose stored-balance abstractions through Zentra. They are not part of the default reviewed primitive BaaS surface for every integration.
Use this namespace only if your tenant contract explicitly enables wallet overlays or you are supporting an older integration that has not yet moved to primitive account and ledger flows.

What This Surface Covers

  • Managed wallet creation and lookup for enabled tenants.
  • Overlay balance reads used by legacy or compatibility-oriented product shells.
  • Compatibility transaction history endpoints for tenants that have not fully migrated to primitive ledger reporting.

Before You Integrate

  • Confirm whether wallet balances are authoritative or derived for your tenant.
  • Keep all money values in minor units and preserve reference ids for auditability.
  • Validate close-out and migration behavior before using wallet overlays in live money movement journeys.

Get Wallet

Inspect a single wallet record and its overlay metadata.

Fund Wallet

Review the overlay funding contract and required reference handling.

Withdraw Wallet

Check withdrawal behavior, limits, and failure handling for enabled tenants.

Transactions

Check compatibility transaction history and pagination behavior.

Overlay Review

Confirm whether this namespace should remain enabled for your tenant.