How meCash Wallets Work
A meCash wallet is a multi-currency digital wallet that lets you manage your funds globally. It's linked to a real bank account to ensure every transaction is secure and reliable.
With a meCash wallet, you can:
- 🏦 Manage Multiple Currencies: Handle transactions in various currencies (e.g., USD to NGN, NGN to CNY) from a single dashboard.
- 💸 Transact Globally: Hold, send, and receive money across borders.
- 🌍 Extensive Currency Support: Access over 12 currencies, including USD, EUR, XOF, and GBP.
- ⚡ Instant Transfers: Move funds instantly to bank accounts, mobile money wallets, or other meCash users.
Wallet Attributes
Each wallet is tied to a user and has the following core attributes:
| Attribute | Type | Description |
|---|---|---|
walletId | UUID | A unique identifier for the wallet. |
currency | String | The three-letter ISO currency code (e.g., NGN, USD). |
country | String | The two-letter ISO country code (e.g., NG, CN). |
balance | Decimal | The available funds in the wallet. We use a decimal type to ensure precision. |
Funding Your Wallet from the Dashboard
This guide walks you through funding your wallet directly from the meCash dashboard.
Step 1: Log in and Navigate to Wallets
Log in to your meCash account. From the sidebar navigation, click on Wallets.
Step 2: Select a Currency Wallet
Your wallets are organized by currency. Select the tab for the currency you wish to fund (e.g., NGN for Nigerian Naira).
Step 3: Initiate Funding
Click the Fund Wallet button located directly below your balance information for the selected currency.
Step 4: Get Account Details
A modal will display the Wallet Details, including the account name, account number, and bank name required to make a deposit.
Step 5: Transfer Funds
Copy the account details and use your banking app or online banking platform to transfer the desired amount to this account.
Step 6: Confirm Deposit
Once the transfer is processed by the bank, the funds will appear in your wallet. You can verify this by checking the updated balance and viewing the transaction history on your dashboard.
Note: Transfer times can vary depending on the banking network. Most local transfers are near-instant, but some may take longer.
🔒 Security & Data Consistency
Security and data integrity are fundamental to meCash.
- Authentication: All API operations must be authenticated using your unique API key.
- Traceability: Every transaction is logged and linked to a specific wallet ID for clear auditing.
- Atomic Updates: Wallet balances are updated atomically. This means operations are processed in a way that prevents race conditions, ensuring that concurrent transactions (e.g., a payment and a deposit happening at the same time) don't lead to an incorrect balance. Your funds are always consistent and accounted for.
✅ What's Next?
Now that you understand how to fund your wallet, you're ready to interact with it programmatically.
The next guide will show you how to retrieve all your wallets via the API using the GET /wallets endpoint.