Failed payments

A payment failed in PaymentIQ. What should you check?

A failed payment can have several causes: a bank refusal, a provider problem, a setting or an issue on your website. Here is how to narrow it down.

Independent guides by Payment Fluent. Not affiliated with PaymentIQ.

1. Find out who is affected

Check whether this is one customer's problem or something happening across many payments. Note when it started and which country, currency and payment method are involved.

  • Does the payment screen open?
  • Can the customer choose a payment method?
  • Does the payment fail before or after the customer is sent to their bank?

2. Open the transaction details

If a transaction exists in PaymentIQ, read its status, error information and history. Compare it with a successful payment using the same method around the same time.

  • If there is no PaymentIQ transaction, check what happened on the website or cashier before the request reached PaymentIQ.
  • Read the provider's response when one is available. A general message on the payment screen may not explain the cause.
  • Pending means a final result may still be outstanding. Check before treating it as a failure or asking the customer to try again.

3. Check what changed

Look for recent changes to payment rules, provider settings, the cashier or your website. Also check the official incident information available to your team. A change near the start of the problem is a clue, not proof.

  • Check whether the payment went to the expected provider.
  • Check whether the selected provider account supports the currency and payment method.
  • Test a proposed fix in a suitable test environment before changing live settings.

4. Give the right team a clear problem to solve

A useful support request explains what happened, what should have happened and what you already checked. Send it to the team responsible for that part of the payment process.

  • Include the affected method, environment, time and relevant transaction references through your company's approved support channel.
  • Keep passwords, card details and session tokens out of the message.
  • After a fix, check new payments to confirm that the problem is resolved.

Common questions

Does a failed payment mean PaymentIQ is down?

No. The bank may have refused it, a setting may be wrong, or another part of the payment process may have failed. The transaction details help identify where to look.

What should I include when contacting you?

A short explanation of what is going wrong and which payments are affected. Do not send passwords, card details or customer records in the contact form.

Independent consulting

Still cannot find the cause?

I can trace the payment across your website, cashier, PaymentIQ and provider, then help your team work out what needs fixing.

Get help with failed paymentsSee how I can help

Written by Payment Fluent · Independent payment consulting

Other useful guides

Each guide explains the basics, gives concrete examples and shows what to check.