QuickBooks Online ACH Return Codes: What Each Code Means and How to Resolve It
Quick Answer: An ACH "Pay Now" payment usually declines because of a bank-side issue, including insufficient funds, a closed or invalid account, or an authorization problem. When this happens, QuickBooks sends you an email with a rejection code (R##) explaining why, and most fixes involve either checking your account details or updating the deposit bank account tied to your QuickBooks Payments account.
When you click “Pay Now,” you expect to be able to… pay now. Fortunately, QuickBooks Payments sends an email each time an ACH payment is rejected, and that email includes a reference code, the reason for the decline, and the steps needed to fix it. This guide breaks down what those codes mean and how to get the issue resolved.
Note: This article covers ACH-specific declines only. If a customer's credit card is being declined instead, see Fix customer's declined credit card payments.
Why Did My ACH Payment Get Declined?
As ACH payments run through the banking network, declines almost always reflect something on the bank side rather than QuickBooks itself. Declines are often due to insufficient funds, a closed or invalid account number, a frozen account, or a requested stop-payment request.
Thankfully, each decline generates an "R##" rejection code, which we send you via email. This code tells you precisely what went wrong, and the steps you can take to resolve the issue.
What Do the R## Rejection Codes Mean?
Here's a breakdown of the most common ACH rejection codes, what they mean, and how you can best move forward.
| Code | What It Means | What To Do |
| R01/R09 | Insufficient or uncollected funds | Check your account balance, or contact support to pay by card instead |
| R02 | Account closed or inactive | |
| R03/R04 | No account found/invalid account number | |
| R05 | Unauthorized debit entry/the member didn’t authorize debit entry | |
| R06 | Intuit didn’t accept the payment | No action necessary – we’ll fix this! |
| R07 | Authorization was revoked by the customer/you stopped the deposit | Change your deposit bank account; corporate accounts should confirm with their bank that QuickBooks Payments debits are approved |
| R08 | You requested a stop payment with your bank | |
| R10/R29 | The entry wasn’t authorized with your bank | Work with your bank to authorize QuickBooks debits or change your deposit bank account |
| R11 | Check safekeeping entry return | No action needed. We’ll fix it! |
| R12 | Your bank or branch was sold to another institution | Update your account with your new routing and account numbers |
| R13 | Your bank can't participate in ACH, or the routing number is wrong | Update or change your deposit bank account |
| R14/R15 | Account holder is deceased | Send a death certificate if applicable. You may need to change the account entirely |
| R16 | Account frozen due to legal action or your bank. | Work with your bank and follow the provided procedures, then update your deposit account |
| R17 | Your bank rejected part of the item | No action needed – we’ll take care of it! |
| R20 | The account can't process ACH activity (e.g., it's a savings account) | Check the account type or switch to a checking or other transactional account |
| R21/R22 | Invalid company or individual ID number | No action needed — NACHA handles this |
| R23 | Refused due to amount, litigation, overpayment, or missing authorization | |
| R24 | Duplicate entry detected | No action needed – we’ll work to fix this issue. |
How Do I Fix a Declined ACH Payment?
The email QuickBooks sent when the payment was rejected is the best place to start. It names your specific code and the steps needed to resolve the issue. From there, most fixes fall into one of these three buckets:
- Check your account balance and details for codes pointing to fund or account-number issues (R01, R03, R04, R09).
- Update or switch your deposit bank account for codes pointing to a closed, frozen, or restricted account (R02, R05, R08, R13, R16, R20, R23).
- Contact your bank directly if the code involves an authorization revoked or disputed on your end (R07, R10, R29).
What If I Didn't Get a Rejection Email?
QuickBooks sends rejection emails to the contact address on file for your QuickBooks Payments account. We recommend checking your spam and promotions folders in case the email landed there.
What If My Code Isn't Listed Here?
The email you’ve received will still contain a set of instructions you can follow to resolve the issue. Please also feel free to contact QuickBooks support for help with any ACH rejection.
FAQ
Q: Can I retry an ACH "Pay Now" payment after it's declined? A: It depends on the code. Funds-related returns (R01, R09) can be retried once the balance is covered. Invalid or closed account returns (R02, R03, R04, R12) need corrected account details first — retrying the same numbers reproduces the same return. Authorization-related returns (R07, R10, R29) should not be retried until the customer has re-authorized, because reinitiating a debit that wasn't authorized is a rules violation rather than just a failed payment.
Q: Why does my ACH payment show as pending, then declined, days later? A: As ACH transfers take a few business days to clear through the banking network, a decline may surface after the payment initially appears successful.
Q: Is an ACH decline the same as a credit card decline? A: Not exactly. ACH declines come from the banking network and use R## codes, while credit card declines come from the card issuer and have different causes. Here’s a bit more info on how to fix declined credit card payments.
Q: Will I be charged a fee for a declined ACH payment? A: Not necessarily, but some rejection reasons, like insufficient funds, may incur a fee. Check the rejection email for more details.
Q: Can a savings account be used for ACH payments? A: We’re afraid not. Non-transactional accounts, including most savings accounts, are restricted under ACH rules (R20) and should be swapped for a checking account.
Key Takeaways
- Every ACH decline generates an R## code sent via email that outlines the issue and provides resolution steps.
- Most fixes involve either checking account details, switching your deposit bank account, or contacting your bank about authorization.
- Some codes (R06, R11, R17, R21, R22, R24) need no action and will be resolved automatically.
- If you haven’t received the rejection email, check your spam and promotions folders to make sure it didn’t land there.
Still running into a decline?
Leave a comment below! You can also contact QuickBooks support with your rejection code and case number, and they'll be happy to dive into it with you.