Troubleshooting Guide
Common issues and their solutions for Marz Pay
Common Issues
401 Unauthorized Error
Your API key is invalid or missing.
Solution: Check your API key and ensure it's included in the Authorization header
Invalid Phone Number
Phone numbers must be in the correct format.
Solution: Use format 256XXXXXXXXX (Uganda country code + 9 digits)
Insufficient Balance
Your account doesn't have enough balance for the transaction.
Solution: Add funds to your account or check your current balance
Payment Failed
The mobile money provider rejected the transaction.
Solution: Check the error message and try again, or contact support
Error Codes
| Code | Description | Solution |
|---|---|---|
| INVALID_PHONE | Invalid phone number format | Use 256XXXXXXXXX format |
| INSUFFICIENT_BALANCE | Account balance too low | Add funds to account |
| PROVIDER_UNAVAILABLE | Mobile money provider down | Try again later |
| INVALID_AMOUNT | Amount outside allowed range | Use amount between 100-1,000,000 UGX |
Still Need Help?
If you're still experiencing issues, our support team is here to help.