Skip to content
Infrastructure

Multi-Tenant Architecture: What It Actually Takes to Run Wallet-as-a-Service at Scale

Multi-tenant architecture is what lets one Wallet-as-a-Service platform serve many banks and merchants safely. Here's what that actually requires.

Aurea Hub Product Team1 min read

What "multi-tenant" means in a Wallet-as-a-Service platform

A multi-tenant Wallet-as-a-Service platform runs one codebase and one infrastructure stack that serves many separate banks, payment institutions or merchants at once, each with its own branding, users and ledger, without any tenant seeing another tenant's data or funds.

The alternative, a single-tenant deployment per client, means a separate environment, a separate database and a separate compliance review for every new bank onboarded, which does not scale past a handful of clients.

Isolating data and funds between tenants

Isolation has to hold at three layers: the database, with tenant ID enforced on every query rather than only in application logic; the ledger, with each tenant's client funds held in segregated sub-accounts, never commingled even when pooled at the banking partner level; and access control, so a support engineer troubleshooting one bank's issue cannot query another bank's customer records by accident.

Segregation at the ledger layer matters most to a bank's own auditors: a wallet platform that cannot produce a clean, tenant-by-tenant reconciliation on demand is not ready for a regulated client, regardless of how clean its API looks.

What breaks when multi-tenancy is bolted on later

Retrofitting isolation onto a platform built for a single client usually means adding a tenant identifier column to existing tables and hoping every query remembers to filter on it. That pattern produces the two failure modes regulators care about most: a query that leaks one tenant's records into another tenant's report, and a migration that silently mixes ledger balances during a schema change.

Building multi-tenancy in from the first schema, rather than adding it after the first client, is what allows a Wallet-as-a-Service platform to onboard a second, third and tenth bank without repeating the compliance review from scratch each time.

Was this helpful?

We update articles based on your feedback. Tell us what we got right — or where we missed.

Get help