Troubleshooting Failed Payment
Payment failures may come from an incorrect payment method, insufficient funds, provider timeout, bank decline, expired checkout session, network interruption, or a payment that is still pending confirmation. Avoid repeated attempts until you know the current status.
First Checks
- Confirm the invoice, plan, customer, amount, currency, and payment method are correct.
- Check the payment status: pending, failed, cancelled, expired, or completed.
- If the provider says pending, wait for confirmation before starting another payment.
- Confirm the payer has approved the charge on their bank, card, or mobile money channel.
- Try again only after the checkout session has clearly failed or expired.
What To Capture
- Invoice number, payment reference, payer name, timestamp, and provider message.
- Whether money left the payer account.
- Any receipt, bank message, or payment provider confirmation.
Support escalation
Open support guide
Need help with this topic?
Capture the module, record number, branch or warehouse, user, visible message, and what you expected to happen before contacting support.