A customer tells you they paid the invoice, but your dashboard still shows an unpaid balance. Or they click the payment button and get “card declined” while your crew is waiting to schedule the job. An online invoice payment failure is frustrating, but it does not always mean the customer lacks funds—and it does not always mean your invoice is overdue.
For a plumbing, HVAC, electrical, landscaping or other home-service business, the best response is to identify what actually failed, protect the customer from duplicate charges, and offer one clear next step. This guide provides a practical troubleshooting workflow, a worked deposit-and-final-payment example, and customer-ready messages. The examples are educational; the exact controls and payment methods available depend on your invoicing provider and connected processor.
First: identify which payment problem you actually have
Do not treat every unpaid-looking invoice as a card decline. There are at least five different situations:
| What you see | What it might mean | First check |
|---|---|---|
| “Card declined” or payment failed | The card transaction was not approved or could not complete | Processor transaction status and decline guidance |
| Payment page will not open | Expired link, browser issue, wrong URL or access problem | Open the current invoice’s official payment page |
| “Authentication required” | Customer must complete an issuer verification step | Ask the customer to complete the secure on-page authentication |
| Bank payment says “processing” | ACH payment may not yet have a final outcome | Payment method, processing status and settlement guidance |
| Invoice paid, bank deposit missing | Customer payment and merchant payout are separate events | Check payout status, not a new customer charge |
Before taking any action, open the invoice record and the corresponding transaction in your authorized payment system. Confirm the customer, invoice number, amount, currency, payment method, time and current status. If the customer says they were charged, check for a successful or pending transaction before issuing another payment request.
Step 1: confirm the invoice and amount are correct
Look at the approved estimate, any change orders, deposit receipt, issued invoice and payments already applied. A card may fail because the attempted amount exceeds the card's available limit, but you should first make sure the requested amount is actually what the customer owes. For service businesses, deposit credits are a frequent source of confusion.
Check whether the invoice is still open, whether the payment link corresponds to its current version, and whether the customer is using a genuine link issued by your business. Do not create a new invoice simply because the customer reports an error; that can leave two payable documents for the same work.
When a job involves an estimate deposit, see how to display the paid deposit on the final invoice. If the work has already been approved and the deposit paid, review the estimate-to-invoice workflow before altering the payment request.
Step 2: check whether the card was declined—and what the reason actually says
Payment processors may expose a decline code or an action recommendation, but not every issuer shares a precise explanation. Stripe’s official decline-code reference documents examples such as insufficient_funds, expired_card, incorrect_cvc, authentication_required and do_not_honor. These codes are not a universal translation table for every provider.
| Decline category | Appropriate next step |
|---|---|
| Expired card or incorrect details | Customer re-enters current details on the secure payment page or chooses another card |
| Insufficient funds or spending limit | Customer uses an alternative permitted payment method or contacts their issuer |
| Authentication required | Customer completes the verification flow in the provider’s secure checkout |
| Generic decline / do not honor | Customer contacts the card issuer or tries a different valid method; do not guess the reason |
| Possible duplicate transaction | Search payment history before attempting another charge |
| Issuer temporarily unavailable | Follow processor retry guidance and check for a prior successful attempt first |
Do not tell a customer “your account has insufficient funds” unless your provider explicitly supplies that diagnosis and you have a legitimate reason to communicate it. A generic decline is not evidence of financial hardship. Avoid repeated rapid retries: some failures require a different card, issuer approval or authentication, and excessive attempts can create security or fraud concerns.
Step 3: troubleshoot the invoice link without collecting sensitive card data
If the customer cannot load the page, first verify that you sent the latest official invoice URL and that the invoice remains payable. Ask them to open the link directly, use an updated browser, or try another device or network. Do not instruct them to bypass browser security warnings or send card numbers by text or email.
If the link is genuinely invalid, regenerate or resend the same invoice’s official payment request if your provider supports that workflow. Make sure the customer understands which link is current. A payment page that loads but rejects a card needs different troubleshooting than a page that returns a 404 or displays the wrong invoice.
Square’s U.S. invoice troubleshooting guidance recommends checking browsers, payment information and the issuer, and notes that its system may cancel an invoice after excessive failed attempts. That is a Square-specific behavior, not proof that all providers do the same.
Step 4: separate a failed card payment from a pending ACH payment
U.S. bank-account payments are not always confirmed immediately. ACH Direct Debit is a delayed-notification method; Stripe’s ACH documentation says acknowledgment of success or failure can take up to four business days, with settlement and payout timing varying by eligibility and setup. A submitted bank debit is not the same as a fully settled payment.
When the payment status is processing, do not immediately tell the customer it failed or demand another full payment. Confirm the provider's final status and whether an ACH return has been received. If a bank debit is returned, use the processor’s return reason and instructions to decide whether corrected account information, a new authorization or a different payment method is required.
Never promise that switching to ACH will make the funds arrive instantly. Likewise, a card transaction marked successful does not mean the contractor's bank account has already received the payout. For the distinction between customer payment, settlement and bank payout, see how invoice payments reach your business bank account.
Worked example: a failed $1,380 final invoice payment
Imagine a contractor has an approved $1,680 repair project. The customer already paid a lawful, contractually agreed $300 deposit, leaving $1,380 to collect when the job is complete. These amounts are purely illustrative and are not deposit guidance for any particular state or contract.
The customer tries to pay the $1,380 final balance by card, but the processor records a failed attempt. No funds were collected on that attempt. The contractor should not mark the invoice paid or issue a second $1,380 invoice. The amount still due is $1,380.
| Event | Payment successfully received | Remaining job balance |
|---|---|---|
| Approved project total | — | $1,680 |
| Earlier deposit applied | $300 | $1,380 |
| First final-payment card attempt fails | $0 | $1,380 |
| Customer later pays an agreed partial amount | $500 | $880 |
| Customer successfully pays the remainder | $880 | $0 |
The reconciliation is $300 + $500 + $880 = $1,680. A failed attempt contributes $0. If a pending transaction later succeeds, the amounts must be reviewed again before another charge. Do not offer a $500 partial-payment arrangement without confirming that the customer agrees and the invoicing workflow can accurately track the remaining $880.
For covered California home-improvement contracts, special statutory down-payment restrictions can apply. This hypothetical $300 deposit does not establish what is legal for your job. The California Contractors State License Board explains the general 10%-or-$1,000-whichever-is-less limitation for covered contracts, along with applicable rules and exceptions. Check your state's requirements before setting deposit terms.
Step 5: send a useful retry message, not an accusation
The first customer message should describe what your records show without making assumptions about their bank account. A practical example is:
Hi [Customer], the online payment attempt for invoice [number] did not complete, so our records still show [amount] due. Please use the secure link on your invoice to try again or choose another available payment method. If your bank shows a charge, please let us know before making another attempt so we can check the transaction. Thank you.
If the problem is specifically an authentication step, replace the generic advice with: “Your bank may need you to approve the payment in its verification screen. Please reopen the secure payment page and follow the on-screen instructions.” If the payment is pending, do not send a failure notice; say that you are confirming its final status.
Include the invoice number, job reference, remaining balance and your business contact details. Avoid including complete card or bank details in any message. Never ask a customer to reply with their CVV, online banking password or one-time bank security code.
Step 6: decide whether the job can proceed while payment is unresolved
Contractors often collect deposits before reserving equipment, ordering materials or committing a crew. If a deposit attempt fails, do not assume the job is financially confirmed. Review the signed agreement and explain the next scheduling step without inventing a cancellation policy after the fact.
For example: “We have your estimate approval, but the deposit payment has not completed. We can confirm the installation appointment once the agreed deposit is successfully received, subject to the scheduling terms in your contract.” If the customer used ACH, distinguish a pending bank debit from a final successful payment and decide whether the business's documented policy permits a provisional appointment.
For already completed work, a failed final payment is primarily an accounts-receivable issue. Keep the job completion record intact and follow the agreed invoice terms. Do not use threats, unapproved fees or misleading statements about legal consequences to force an immediate retry. Our deposit-before-scheduling checklist explains the operational handoff.
Step 7: prevent duplicate charges when a customer sees a pending bank entry
A customer might say “My bank already took the money” while your dashboard says “failed.” A temporary authorization, pending transaction or bank debit in progress can appear in their account without being a final settled payment. The right response is to investigate the specific transaction reference, amount, date and processor status.
Do not assume the bank screenshot is proof of a completed payment, but do not dismiss it either. Confirm whether the payment succeeded, failed, was canceled, is still processing or has been refunded. If two successful charges are found for the same obligation, follow the provider's refund and reconciliation process instead of issuing an unexplained credit.
If your records are inconsistent, escalate to the payment provider with non-sensitive transaction identifiers. Avoid having staff search for payment information by collecting card numbers over an insecure channel.
When should you send another invoice or payment link?
Usually, the safest first choice is to keep the existing invoice and use its valid payment page. A new invoice can create duplicate receivables, especially when one job has a deposit and final bill. If your provider requires a replacement invoice because the original was canceled or cannot be paid, clearly void or otherwise resolve the old payable record according to the system's rules and keep an audit trail.
If the customer disputes the price, that is not a payment-technology problem. Compare the accepted estimate and approved change orders with the invoice before requesting payment again. A revised invoice may be appropriate for a genuine billing correction, but not merely because the first card attempt failed.
For job-level tracking, see how to track unpaid invoices by job number. It explains why one job ID can have multiple related financial records without confusing deposits, invoices and payments.
How to prevent repeated payment failures
Start with a clear customer-facing invoice: correct business name, service address, itemized work, deposit credits, exact balance, due date and one secure payment route. Confirm that payment methods shown are actually enabled for your merchant account. Send the invoice to the customer's current email or agreed contact channel and verify the link works before it becomes urgent.
Keep the payment experience simple. Do not send several competing links for the same balance. Where your processor supports it, allow the customer to update expired payment details securely and complete any required bank authentication. For recurring service accounts, check whether failed-payment notices or retry features are enabled; do not assume automatic retries exist for every one-off invoice.
Review payment failures periodically by category. If one customer's card is declined, it may be an issuer issue. If many customers suddenly cannot load the payment page, check your provider's service status and your invoice-link configuration before sending reminders to everyone.
A practical contractor payment-failure checklist
- Confirm the invoice number, job, amount due and payments already applied.
- Inspect the actual processor transaction status before requesting another payment.
- Distinguish a declined card from an invalid link, authentication prompt, pending ACH or delayed bank payout.
- Follow the provider's decline-code guidance; never guess the customer's financial situation.
- Check for a duplicate or pending charge before asking the customer to retry.
- Send a secure payment route and a calm, specific customer message.
- Document any approved partial-payment arrangement and recalculate the balance.
- Reconcile the final successful payment, invoice status and later payout separately.
Frequently asked questions
Does a failed invoice payment mean the customer has no money?
No. The cause could be an expired card, incorrect details, issuer restriction, authentication step, technical issue or insufficient funds. Rely on the actual processor status and do not infer more than it reports.
Should I keep retrying the same declined card?
Not automatically. Some declines require corrected details, a different payment method or the customer's bank approval. Follow the provider's retry guidance and check for previous successful attempts to avoid duplicate charges.
Can I mark an ACH invoice paid as soon as the customer submits the payment?
Do not treat submission as final settlement. ACH Direct Debit can have delayed confirmation and returns. Use the status and accounting policy appropriate to your processor and business.
Should I send a second invoice when the payment link fails?
First try to restore or resend the correct existing invoice link. Issue a replacement only if the platform requires it or the invoice itself needs a documented correction, and resolve the old payable record.
Can I charge a failed-payment fee?
Do not add one automatically. Any fee must be permitted by applicable law, your contract and the payment provider's rules. A failed card attempt is not blanket authorization for a penalty.
What if the customer says they were charged twice?
Investigate both transaction records before asking for another payment. Distinguish pending authorizations from successful charges, and handle a confirmed duplicate using the provider's refund and reconciliation process.
Recover the payment without losing the customer’s trust
The goal is not to make the customer try the same card five times. It is to establish the correct invoice balance, identify whether the payment truly failed, offer a safe next step and record the outcome. A contractor who can explain the status clearly is more likely to preserve the relationship while collecting the amount actually owed.
ProInvoice helps service businesses organize estimates, customer invoices and online payment requests. Explore ProInvoice features or get started to keep the estimate-to-payment process connected.
Sources and further reading: Stripe card decline codes; Stripe ACH Direct Debit documentation; Square U.S. invoice troubleshooting; Method’s QuickBooks payment-decline troubleshooting; CSLB home-improvement contract guidance.