ZenoPay API Payment Simulationv1.0
ZenoPay Payment Simulation
This interactive demo allows you to test the ZenoPay payment flow without processing real transactions. Use this simulation to:
- Understand the complete payment workflow from initiation to completion
- Test different payment scenarios (success, failure, timeouts)
- See how webhook notifications work in real-time
- Verify your integration logic before going live
Note: This is a simulation only - no real money is transferred. For production integration,
refer to our Guzzle, cURL, or Native PHP
documentation depending on your implementation approach.
How to Use This Simulation
- Fill in the payment form with test data
- Submit the payment to trigger the simulated USSD prompt
- Enter "0000" as the PIN when prompted (simulated authentication)
- Observe the webhook notification and status check responses
Payment Form Simulation
Below is a complete payment form example that demonstrates how to integrate ZenoPay payments into your website.
Complete Your Payment
Webhook Simulation
After a successful payment simulation, the webhook data will appear below:
Received Webhook Data:
No webhook data received yet
Payment Status Check:
No status check performed yet
Support & Resources
Get help with integration, troubleshooting, and account management through our comprehensive support channels.
Support Channels
| Support Channel | Contact Information | Response Time |
|---|---|---|
| Email Support | support@zenopay.net | 24 hours |
| 0793166166 | Business hours (8AM - 5PM EAT) | |
| Documentation | zenopay-docs.netlify.app | 24/7 |
Common Integration Issues
| Issue | Solution |
|---|---|
| Invalid API Key | Ensure your API key is correctly set in the request headers as x-api-key: YOUR_API_KEY |
| Phone Number Format | Use Tanzanian format (0744001122) without country code or + sign |
| Webhook Not Receiving | Check your webhook URL is publicly accessible and returns 200 OK. Test with webhook.site first. |
| SSL Certificate | Ensure your webhook endpoint uses valid SSL certificate (Let's Encrypt offers free certificates) |
| Timeout Issues | Set request timeout to at least 60 seconds for payment requests |
| Payment Status Not Updating | Mobile money payments can take several minutes to complete. Use webhooks or poll the status endpoint periodically. |
Additional Resources
- ZenoPay Website - Official ZenoPay website
- ZenoPay GitHub Repository - Official GitHub page for various ZenoPay repositories
- Quickstart - Guzzle Documentation - A quick introduction to Guzzle and introductory examples.
- Webhook Best Practices - How to properly implement and secure webhooks
Isaiah's Integration Tip
When debugging API issues, I always recommend including these in your support requests:
- Test API key (mask the first few characters for security)
- Request samples (both successful and failing ones)
- Timestamps in UTC format
- Expected vs actual behavior
This helps me reproduce and resolve issues much faster. Feel free to follow me on LinkedIn!