Skip to content

When an in-progress payment fails, Payments Direct displays an error state in the payments list and on the payment details page. This page describes what payment failure looks like in the Payments Direct UI and explains the most common failure reasons and their details.

For step-by-step guidance on what to do when a payment fails, see Handle payment errors and failures.

What failure looks like in the UI

When a payment fails, the payment's status indicator changes to an error state in the payments list. Selecting the failed payment opens the payment details view, where an error message is displayed. The error message includes:

  • A unique error code that you can provide to technical support.
  • An error description with details about the failure.
  • Actionable information under What you can do indicating how to resolve the issue.

Error message example

Error message example

Any funds that were reserved to complete the payment are released back to your available balance when the payment fails.

Common payment failure reasons

The following table describes commonly occurring payment failures. This is not a complete list.

Failure reasonFailure details
Insufficient fundsThe available balance in your account is less than the payment amount you specified in your payment request.
Past-due invoiceYour account has a past-due invoice.
Transaction limit reachedYou have already reached the number of transactions you're allowed to make in a 24-hour period.
Transaction amount limit exceededThe payment amount you specified is higher than your account's transaction limit.
Inactive beneficiaryThe payment beneficiary you specified is inactive.
Mismatched identityThe identity ID you provided for the payment beneficiary is not associated with a beneficiary-type identity.