Skip to main content

Troubleshoot failed payments

Find out why a card was declined or a charge did not go through, and get the invoice paid.

Written by Krasto Milchev

➤ Product: OfficeRnD Flex
➤ Who: Admins with access to Billing
➤ Where: On the Admin Portal, under Billing > Invoices
➤ Availability: All plans

A customer’s card was declined, or an invoice shows Failed after an automatic charge. You must know the reason before you act, because a declined card and a payment gateway error need different fixes. OfficeRnD Flex shows the reason that your payment gateway returned for each failed payment.

A payment fails when Flex charges a saved payment method through your payment gateway, and the payment gateway rejects the charge. A declined card is 1 of several reasons for a failed payment.


In this article:

  • Who gets an email when an automatic charge fails

  • Read the decline reason or error code from your payment gateway

  • Whether Flex charges a failed invoice again on its own

  • Not covered here: a payment that the bank reversed after it was paid. When to mark a payment as failed →


Before you begin

Connect a payment gateway. Flex charges invoices automatically only through a connected payment gateway. Connect a payment gateway →


What happens when a payment fails

When your payment gateway rejects a charge, Flex records the failed attempt on the invoice. Flex then does these 3 things:

  1. Sets the payment on the invoice to Failed.

  2. Sets the invoice status to Failed.

  3. Sends a failed payment email to the recipients that you selected under Settings > Billing > Invoicing in the We'll send notification if payment fails to section.

Flex does not charge the invoice again automatically. To collect the payment, first find out why the charge failed.


Find the reason for a failed payment

Flex shows the reason on the failed payment of the invoice. The reason text comes from your payment gateway.

Follow these steps to find the reason:

  1. Go to Billing > Invoices.

  2. Open the Failed tab to list the invoices with a failed payment.

  3. Click the invoice to open it.

  4. Find the payment with the Failed status.

  5. Hover over the error icon next to the payment. A tooltip shows the reason that your payment gateway returned.


Look up an error code

The reason text is short, and each payment gateway uses its own error codes (for example, No such PaymentMethod: 'card_1NSCktDCuLwmEnxz7yIRFd8m'). To find out what a code means, look it up in your payment gateway’s documentation:

If the documentation does not explain the error, contact your payment gateway’s support team. The payment gateway processes the charge, so its support team can see why the charge failed.


Collect the payment again

Fix the cause before you charge again. A new charge to the same payment method can fail for the same reason.

Reason in the tooltip

What to do

The card was declined, expired, or has insufficient funds

Ask the customer to update their payment method or contact their bank.

An error in your payment gateway account

Contact your payment gateway’s support team.

After you fix the cause, charge the invoice again with the customer’s stored payment details. Charge stored payment details →


FAQs

Does Flex charge a failed invoice again automatically?
Flex does not charge a failed invoice again automatically. After you fix the cause, charge the invoice again from the invoice page. Charge stored payment details →

Who receives an email when a payment fails?
Flex emails only the recipients that you select under We’ll send notification if payment fails to, in Settings > Billing > Invoicing. You can select these recipients:

  • Members: the member or company that Flex charged. For companies, it emails the billing persons.

  • Your organization’s email address. The checkbox shows the address itself. Flex takes this address from the Email field on the Company Info tab, under Settings > Account Details > Company & Billing Info.

If you select neither checkbox, Flex sends no failed payment email. Set up failed payment notifications →

Why does an invoice show as paid after the bank rejected the direct debit?
An invoice can show as paid when the bank rejects a direct debit after the payment gateway processed it. Some payment gateways do not send this rejection back to Flex, so the payment does not change to Failed. Set the payment to failed to correct the invoice balance. Decide when to set a payment to failed →

Did this answer your question?