Understanding Test vs Live Mode
Build Safely. Launch Confidently.
The Monnify dashboard gives you total control over your integration by providing two distinct environments: a test mode for flawless technical setups, and a live mode for real-world transactions.
Knowing which environment you are operating in is crucial to prevent failed tests or accidental payouts.
- Test Mode (The Sandbox): This is a zero-risk simulation environment that mimics our live payment infrastructure, but without using actual funds.
Why you need it:
- Simulate transactions, test your API keys, validate your webhooks, and confirm accuracy before processing live payments.
- Generate sample invoices, simulate refunds, or train your finance staff on how to navigate the dashboard without risking real money.
- Live Mode (Production): This is where real business happens and actual customers interact with your payment flows.
What it means: Transactions are real. Every action here carries real-world financial weight.
How to Know Your Dashboard Mode
Before initiating a transaction, always check the Toggle Button at the top-right corner of your dashboard.
To switch between Test and Live environments, click the toggle button.
- Orange Toggle: You are in Test Mode (Sandbox). Safe to experiment.
- Green Toggle: You are Live (Production). Real money is moving.
Test vs Live (Sandbox vs. Production) URLs
To build safely, you will start in our Sandbox environment. Ensure your codebase points to the correct Base URL:
- Test Environment: https://sandbox.monnify.com
- Live Environment: https://api.monnify.com
Developer Warning: Always ensure your codebase is using the correct API keys for the correct environment. A common integration error is using Sandbox API keys while pointing to the Live endpoint URLs.