Integration Guide
Multi-Tenancy
Tenant isolation model, hierarchy structure, and data partitioning in M2P Prepaid Platform.
Every partner operates within an isolated tenant. The X-TENANT-ID header ensures complete data isolation.
Isolation Guarantees
| Isolation Type | Description |
|---|---|
| Data | All collections/tables partitioned by tenant |
| Configuration | Products, BINs, corporates, and fees are tenant-specific |
| Limits | Transaction limits and wallet balances scoped per tenant |
| Audit | All audit logs scoped to originating tenant |
Hierarchy Structure
Each tenant has a configurable organizational hierarchy:
| Level | Description |
|---|---|
| Issuer | Top-level entity — bank, NBFC, or fintech |
| Corporate | Business unit or program under the issuer |
| Hierarchy | Sub-division (branch, department, region) |
| Product | Card/wallet product configuration |
| Customer | End customer / cardholder |
| Card / Wallet | Physical/virtual instrument linked to customer |
Products must be mapped to a corporate hierarchy before issuance. Use POST /v1/corporates/add-products/ for product-to-hierarchy mapping.