Skip to main content

How to Troubleshoot Payment Failures and Declined Transactions

What to do when a customer's payment fails, covering insufficient funds, transaction blocks, and payment method issues.

Written by Euri

Troubleshooting Payment Failures and Declined Transactions

Payment issues can arise for various reasons, such as insufficient funds, transaction blocks, or issues with the customer’s payment method. Below is a comprehensive guide to understanding and troubleshooting these scenarios effectively.

Common Payment Failures and Immediate Steps

1. Insufficient Funds

The customer’s payment failed due to insufficient funds.

2. Declined Transactions with Specific Codes (e.g., 'Do Not Honor')

Cause: A 'do not honor' error often indicates that the customer’s bank is blocking the transaction due to suspected fraud, especially for large purchases.

Steps to Resolve:

  1. Suggest the customer contact their bank directly to approve the transaction.

  2. Recommend trying a different payment method, such as another card or payment service.

Addressing a Valid Card Declined with a "Retry Later" Soft Decline

In situations where the customer's card is valid but Stripe returns a soft decline (for example, a 'try again later' or 'retry after some time' response):

  1. Prompt the customer to add a new card and attempt payment.

  2. If the customer only has one card, retry the payment once. Do not keep retrying. Repeated declines will auto-block the card in Stripe.

  3. If the card has been auto-blocked from repeated declines, text Support with the customer's name and order number so we can request to unblock the card.

  4. Advise the customer to contact their bank provider if the issue remains unresolved.

Best Practices for Effective Communication

When addressing payment concerns:

  • Maintain a customer-centric approach. Clear communication and providing actionable solutions can ease frustration.

  • Stay updated on common error codes to offer precise guidance.

Did this answer your question?