Developer docs
Test mode & going live
Build and test your integration safely. This page is candid about what test mode is today and what still needs to happen before you take live payments.
ZOZOPAY is currently in test mode. The hosted checkout simulates payment outcomes and no real money moves. Do not treat any payment made today as a real charge.
What test mode does
- API keys are test keys, with a
fp_test_prefix. - The hosted checkout lets you choose whether a payment succeeds or fails, so you can test both paths.
- Payments carry a test reference and never touch a real bank account or card network.
- The rest of the platform behaves normally: statuses, settlements, chargebacks and risk alerts all work.
Testing your integration
- Create a payment link with a small amount using your test key.
- Open the checkout URL and pick a payment method and an outcome.
- Fetch the link and confirm the status changed to
SUCCESSorFAILED. - Try a repeat on the same link and confirm you get the "already used" response.
Before you go live
You will need these in place. Some depend on us, and we will tell you when they are ready.
- An approved account. Complete Merchant KYC first.
- A verified payout account. See Bank verification.
- Live API keys, which will be issued when live payments are enabled for your account.
- An integration that reads payment status by polling, since webhooks are not available yet.
Want to know when live payments open for your business? Talk to us or create an account to get started in test mode.