Testing & Troubleshooting
Test checklist
- Sandbox credentials work.
- A successful payment marks the order as paid.
- A failed payment leaves the order pending.
- The amount and currency match the receipt.
- A refund path is available.
Common problems
| Symptom | Likely cause | Fix |
|---|---|---|
| Order stays pending | Pesapal cannot reach your confirmation URL | Check the public URL and firewall |
| Payment rejected | Wrong key or secret | Re-enter the credentials |
| Amount mismatch | Currency conversion | Confirm the charged currency |
| Sandbox fails | Sandbox URL or key | Confirm you are using sandbox credentials |
| No Pesapal option at checkout | Gateway not enabled | Enable it in checkout settings |
Refunds
Refunds are handled in your Pesapal dashboard unless the plugin exposes them. Always refund the same way the payment was made.
Still stuck?
Our support team is ready to help you get set up.