---
updatedAt: 2026-05-20T05:45:37.000Z
agentTools:
  projectIndex: https://developer.eftcorp.com/llms.txt
---

# 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.

![702](https://files.readme.io/e893bd7-Picture29.png "Picture29.png")

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](https://developer.eftcorp.com/docs/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

> 📘 Note
>
> Wallet types are configured by the EFT Corporation team during tenant onboarding. Contact <onboarding@eftcorp.com> to request changes to wallet type configuration.