Why Your Customer's Payment May Fail or Be Declined
Common Reasons for Failed Payments
When a payer's transaction doesn't go through, it's usually due to one of several common issues related to their card or bank settings. Understanding these reasons can help you guide your payers toward a successful payment.
Insufficient Funds
The payer's available balance may not cover the payment amount. This is one of the most frequent causes of failed payments.
Expired Card
The card being used has passed its expiration date and is no longer valid for transactions.
Online Payments Disabled
Some banks require cardholders to explicitly enable online or e-commerce transactions. If this feature is disabled, the payment will be declined.
International Transactions Blocked
The payer's bank may have restrictions on international purchases. If the card is issued outside Saudi Arabia and your account hasn't enabled international payments, the transaction will be blocked.
Failed 3D Secure Authentication
If the payer doesn't complete the 3D Secure verification step (such as entering an OTP sent by their bank), the payment cannot proceed.
Non-Saudi Cards and International Payment Settings
If your merchant account hasn't enabled international payments, any card issued outside Saudi Arabia will be automatically blocked from completing a transaction.
Payers using foreign cards should try a card issued from a Saudi bank, or contact you to confirm whether international payments are accepted.
What Payers Can Do
If a payer contacts you about a failed payment, guide them through these steps:
- Check their balance: Ensure sufficient funds are available to cover the payment.
- Contact their bank: Confirm that online payments and international transactions (if applicable) are enabled on their card.
- Try another payment method: Use a different card, preferably issued from a Saudi bank.
- Contact Stream Support: If the issue persists, reach out to Stream Support for assistance.
For more details on specific payment issues, don't hesitate to reach out—we're always available to help.
Seeing the actual failure reason
You no longer have to guess. Open the payment in your dashboard and you will see its attempts and the error returned for each one, so you can tell an expired card from an insufficient balance from a bank decline before you contact the customer.
One exception: when a payment is declined on suspicion of fraud, the reason shown is deliberately generic. That is a gateway rule, not missing information.