Troubleshooting Online Payment Declines

Establish whether the gateway received the attempt

Record the order number, local time, amount, and exact customer-facing message. Compare the order notes against the gateway’s transaction record. A missing transaction can point to a storefront issue, while an approved gateway payment with a pending order points to a different workflow.

Separate isolated declines from site-wide patterns

Check whether the failure affects one payment or a group of browsers, regions, or checkout methods. Review the provider’s response category and any configuration change near the first failure. Avoid sending gateway codes or customer details in public support requests.

Make the next action clear

• Before asking the customer to retry, confirm whether a payment or authorization already exists.
• For a store-level failure, verify the result using approved test mode and capture a minimal error record for the vendor.
• For a verified payment with an out-of-sync order, follow the provider’s reconciliation procedure before fulfillment.