Wallet Types
Wallet types define the kinds of wallets available on your tenant and the rules governing each one — including transaction limits, KYC requirements, supported currencies, and permitted operations.
Viewing Wallet Types
Navigate to Configuration > Wallet Types to view all wallet types configured under the tenant.
Clicking on a wallet type shows its full configuration, including:
| Attribute | Description |
|---|---|
| Name | The wallet type name (e.g., Digital Wallet, Card Wallet) |
| Currency | The base currency for this wallet type |
| Program Code | The card program this wallet type is associated with (for card-linked wallet types) |
| Daily debit transaction limit | Maximum total debits allowed per day |
| Monthly debit transaction limit | Maximum total debits allowed per month |
| KYC attributes | Which KYC checks are required before a wallet of this type can be activated |
| Minimum balance | The minimum balance that must be maintained |
Wallet Modes
Eclipse supports several wallet type modes. The mode determines what the wallet can be used for:
| Mode | Description |
|---|---|
| BANK_ACCOUNT | A digital wallet where the ledger, limits and all functionality are contained within Eclipse |
| CLOSED_LOOP_DIGITAL | ⚠️ Deprecated — use BANK_ACCOUNT for new wallet types |
| SYSTEM | Internal system wallets used for fee collection, float management, and settlement flows; only debitable by TENANT_SYSTEM, GLOBAL_ADMIN, or GLOBAL_FINANCE roles |
| STP_VOUCHER | Used for Scan to Pay voucher programs |
| PREPAID_RECEIVEONLY_CARD | Prepaid card wallet; receives card credits but does not originate debits independently |
| DEBIT_RECEIVEONLY_CARD | Debit card wallet; receives card credits but does not originate debits independently |
| CRYPTO | Stores an amount of a cryptocurrency on an exchange; debits and credits result in sales and buys on the crypto exchange |
| VALR | Read-only wallet for viewing crypto wallets on the VALR crypto exchange |
| MOMENTUM | Health wallet where the store of value sits on Momentum |
| DTB_EXTERNAL_SOV | Store of value sits on DTB Flexcube; all wallet operations proxy to DTB |
| BK_DEBIT_ACCOUNT | Placeholder representing a BK bank account; returns zero balance and errors on debit/credit/reservation |
| ZIM_POSTILION_CLOSED_LOOP | Closed-loop wallet backed by Postilion postcard for cards in Zimbabwe |
| RCS_FORWARDING_WALLET | Forwarding wallet for RCS; transactions are routed through to RCS rather than settled within Eclipse |
| PLUGGABLE | Custom wallet implementation loaded at runtime via the Eclipse plugin framework |
What Wallet Types Control
Wallet type attributes control:
- Transaction limits — daily/monthly caps on debits, credits, and transaction counts (see Limit Configuration)
- KYC requirements — which verification checks must pass before a wallet can be activated
- Fee logic — which fees apply (issuance fees, monthly fees, transaction fees) via Wallet Logic Sets
- Webhooks/Callbacks — the callback URLs triggered when transactions occur on wallets of this type
- Allowed operations — which services and payment gateways can interact with the wallet
NoteWallet types are configured by the EFT Corporation team during tenant onboarding. Contact [email protected] to request changes to wallet type configuration.