Skip to main content
Easily view and manage your customer wallets through the Monieswitch dashboard. This guide walks you through the key operations available for customer wallets.

​
View Wallet Details

Access comprehensive information about any customer wallet directly from your dashboard. Navigate to the wallet list, select a customer wallet, and view complete details including balance, tier status, and transaction history. What You Can See:
  • Balance Information: Available balance, booked balance, and today’s transaction amount
  • Account Details: Unique account number, bank name, and account holder name
  • Tier Status: Current tier with daily limits and maximum balance capacity
  • KYC Information: Verification status, BVN (masked for security), NIN status, and date of birth
  • Transaction Activity: Recent transactions, spending patterns, and transaction history
How to Access:
  1. Navigate to Wallets from the sidebar under the CORE section
  2. Use the search bar to find the wallet by account number or customer name
  3. Click on the wallet row to open the detailed view with all information
The wallet details page provides real-time information and updates automatically when transactions occur.
For programmatic access, you can retrieve wallet details using our API:
View Wallet Details
curl --location 'https://nini.monieswitch.com/wallet/details?walletId=825d62fd-534d-460e-891a-94ac678b0b55' \
  --header 'Authorization: Bearer {{merchantAPIKey}}'
Response includes: Available/booked balance, daily limits, account details, tier status, KYC information, and transaction totals.See the API Reference for complete endpoint documentation.

​
View Wallet Balance

Quickly check a customer’s current balance without navigating away from the wallet list. Each wallet row displays the current balance, making it easy to monitor customer funds at a glance. Balance Types Explained:
  • Available Balance: Funds currently available for immediate transactions
  • Booked Balance: Total balance including pending/processing transactions
  • Total Balance: Combined balance including all sub-accounts (if any)
The wallet dashboard automatically refreshes to show real-time balance updates. You can also manually refresh using the refresh button in the top-right corner.
Balance information is updated in real-time as transactions are processed. Any incoming or outgoing transaction reflects immediately in the dashboard.
Retrieve balance information programmatically:
Get Wallet Balance
curl --location 'https://nini.monieswitch.com/wallet/customer/balance?walletId=520b2b20-c8ff-4154-94ce-64ae2f2de4e3' \
  --header 'Authorization: Bearer {{merchantAPIKey}}'
The response includes wallet balance, account details, tier status, and child account information.See the API Reference for complete documentation.

​
Check Transfer Charges

View the current fee structure for different transaction types. Fee information is displayed automatically when initiating transactions through the dashboard or can be queried via API. Current Fee Structure:
  • Wallet-to-wallet transfers: ₦0.00 (Completely Free)
  • Bank transfers (NIP): ₦10.00 - ₦50.00 per transaction
  • Merchant operations (Credit/Debit): ₦0.00 (No charges)
Fees are automatically calculated and displayed before you confirm any transaction. The exact charge depends on the transaction type, destination bank, and amount being transferred.
All fees are transparently displayed before transaction confirmation. There are no hidden charges.
Query current transfer charges:
Get Transfer Charges
curl --location 'https://nini.monieswitch.com/wallet/charges' \
  --header 'Authorization: Bearer {{merchantAPIKey}}'
Returns the applicable charges for different transaction types.See the API Reference for details.

​
What’s Next?

Wallet controls

Manage wallet status: freeze, unfreeze, upgrade tier

Wallet transactions

Credit, debit, and transfer funds between wallets

​
Start building

Learn how to manage, distribute and integrate your payment application with our API and SDKs.

Tutorials and guides

Learn how to work with Monieswitch and your favorite language or framework.

Monieswitch SDKs

Build seamless integrations with our official SDKs.
⌘I