Skip to main content

When an online payment fails, is returned or is disputed

Sometimes an owner's online payment doesn't go through, or the money comes back later.

Written by Natalie Jordan

Sometimes an owner's online payment doesn't go through, or the money comes back later. Here's what happens in each case and what, if anything, you need to do.

A failed payment is handled differently for a card and for a bank account (ACH), so first see which it was: on Payments, the Method column reads Credit Card or Bank Account. This table is the short version; each case is explained below.

Card declined

Bank (ACH) payment returned

When it fails

At once, on the payment page

Several days later, after showing Succeeded

Is the owner told?

They see the reason on screen. No email is sent, except for autopay (Auto-payment for {association} failed).

Yes, by email: Your payment to {association} was returned. Your admins get an email too.

Does the owner still owe?

Yes. Nothing was charged.

Yes. The invoices are open again.

Extra fee

PayHOA adds no fee to the owner's account or to your association.

PayHOA adds no returned-payment fee and doesn't charge your association. Charging the owner one is your decision.

A card is declined

The owner sees the reason on the payment page, such as Your card was declined, with Please try a different payment method, or contact your bank. Nothing is charged and there's nothing for you to fix. PayHOA records the attempt and removes it in the same moment, so a declined card shows on the Deleted tab with a $0.00 amount and a Refunded badge (the hover reads $0.00 refunded). No money moved, in or out. See What a returned, refunded or $0 payment on a unit means.

Is there a report that says why an owner's credit card (CC) payment failed? No. PayHOA has no report of failed or declined card payments, and it doesn't keep the reason. The reason is shown once, to the owner, on the payment page at the moment the card is declined; the attempt on the Deleted tab shows only the $0.00 amount and the Refunded badge, and an admin can't look the reason up afterwards. The card was refused by the bank that issued it, so beyond the message on screen only the cardholder's bank can say why. Ask the owner for the exact message they saw, or a screenshot, and to call the number on the back of the card. If the same owner's card or bank account is refused again and again, see A payment method keeps failing.

A bank payment is returned

Bank (ACH) payments work like paper checks. The payment shows Succeeded right away, but the owner's bank can send it back several days later, for example for insufficient funds or a closed account.

When that happens, PayHOA updates everything for you. You don't mark an online payment (including an autopay payment) as returned yourself, and Return payment isn't offered on it. The change happens as soon as the payment processor tells PayHOA the bank returned the payment; nothing waits on a nightly run or on anyone at PayHOA.

  • The payment's status changes to Returned, on Payments and on the unit's All payments tab.

  • The invoices it paid are open again, so the owner owes them.

  • If the payment had created account credit, that credit is removed.

  • The owner gets an email: Your payment to {association} was returned. Your admins get {owner}'s payment to {association} was returned. Both list the invoices it was paying.

What it doesn't do: no returned-payment fee is added. To charge one, create an invoice for it. See Create an invoice. Whether to charge the owner a fee is your association's decision; the usual practice is to charge the account whose payment was returned.

If your bank or the owner's bank shows the return and the payment still says Succeeded in PayHOA, don't mark it or delete it yourself. Contact PayHOA support with the unit, the payment date and the amount.

A returned-payment email for a payment nobody made

Returned-payment emails go to every admin of the association. If you get Your payment to {association} was returned and no owner's payment matches it, the payment that was returned is the association's own subscription payment to PayHOA. Update the payment method under Settings → Billing. See Add or change the payment method.

If your bank is linked, the bank's debit for the return also arrives in your bank feed, so the return is in Transactions twice: the Returned Payment entry and the bank's copy. PayHOA doesn't match these two for you. Keep the Returned Payment entry and delete the bank's copy, or merge the two during your next reconciliation. Don't exclude the bank's copy: an excluded transaction still counts in the bank account's balance, so the return would be taken out of the balance twice. See Exclude, delete or fix duplicate transactions.

Finding out why it was returned

PayHOA doesn't show the bank's return code; the returned-payment email is the only notice you get. Most returns are the owner's bank declining the debit: insufficient funds, a closed account, or a block the bank has put on the payer. Ask the owner to check with their bank. If the bank says it never saw the payment, it's blocking debits from PayHOA's payment processor and has to allow them; until it does, every retry will be returned too. If you need the return code itself, contact PayHOA support with the unit and the payment date.

One owner's bank payments keep being returned, although their bank says the money is there and the debit is authorised. The payment processor may have blocked that bank account after the earlier failed payments, and a blocked account keeps being refused until the block is lifted, whatever the owner's bank says. Have the owner pay with a different bank account or a card in the meantime. To get the account unblocked, contact PayHOA support with the unit, the owner's name, the dates and amounts of the returned payments, and a picture of a voided check (or a recent bank statement) for the account. See A payment method keeps failing.

The account already shows $0

A return reopens the invoice, so a $0 balance after a return means the owner has since paid again, or account credit on the unit paid it. Check the unit's Account history for a later Succeeded payment or an Account credit row.

Checks sent by an owner's bank

Checks an owner's bank mails through its bill-pay service reach you like any other check, at your lockbox or mailing address. If that bank rejects or returns one, it's between the owner and their bank; nothing happened in PayHOA. Record the check only when it arrives.

A payment is disputed

An owner can dispute a card payment with their card company (a chargeback).

  • While the dispute is open, the payment shows Disputed. A note is added with the amount and reason. Nothing else changes; the invoices stay paid.

  • If the association wins, nothing changes.

  • If the association loses, the money goes back to the owner. The payment becomes Returned, or is reduced if only part was lost, and those invoices are open again.

PayHOA doesn't charge your association for returned or disputed payments.

A payment method keeps failing

If an owner's card or bank account fails again and again, they should try another payment method. If every method fails, contact PayHOA support yourself, with the unit and the owner's name; the paragraphs below say what else to send. Owners are asked to come to their association first, so don't send the owner to PayHOA support.

Ask the owner for the exact message on the payment page, because it says which kind of failure it was. A message ending Please try a different payment method, or contact your bank. is a refusal by their card company or bank. We couldn't process your payment right now. We've been notified and are working to correct this. (until mid-2026: We were not able to process your Payment(s)) means the payment failed for a reason the owner can't fix by changing the payment method; if it happens twice, contact PayHOA support with the unit, the date and time, the amount, the payment method type and a screenshot. Each message is explained for owners in If you can't pay.

If several owners in your association are rejected on every method at once, the payment processor has blocked their payment methods. This has happened after a run of reversals following a security incident. Only PayHOA support can lift the block; adding a new card or bank account doesn't help. Contact support with the association name and one or two of the affected units.

To unblock one owner's payment method that the processor has blocked after repeated declines, contact PayHOA support with the unit and the owner's name, and a picture of a voided check (or a recent bank statement) for the account. Support uses it to open a request with the payment processor.

Autopay that fails

If an autopay payment fails, autopay is turned off so the owner doesn't get overdraft fees from repeated attempts. The failed attempt appears on the Deleted tab with a $0.00 amount and a Refunded badge; nothing was charged. See How autopay works.

What a returned, refunded or $0 payment on a unit means

A payment on a unit's All payments tab (or on Payments) that shows Refunded with an amount of $0.00 is an online payment attempt that failed. No money was ever collected, nothing was sent back to the owner, and the owner still owes the invoice. Here is how to read each row:

What you see

What happened

Does the owner still owe?

Refunded, amount $0.00, hover reads $0.00 refunded

An online attempt failed: a declined card (for example This card has insufficient funds.) or an autopay charge that didn't go through. No money left the owner's account.

Yes. The invoice was never paid.

Returned

The money came in and went back: the owner's bank returned a bank payment, or you marked a check as bounced.

Yes. The invoices it paid are open again.

Refunded or Partially Refunded, with an amount; hover shows the amount refunded

You sent money back to the owner with a refund.

Yes, for the part refunded: a refund reopens the invoice. See Refund an owner's payment.

Deleted, with a date

Someone deleted a check, cash or account credit payment that had been recorded.

Yes. The invoices it paid are open again.

On the unit's Account history tab, a return reads Returned … Payment (original payment …) and a refund reads Refund of … Payment. A card dispute the association lost reads Dispute of … Payment. The original payment keeps its own row, marked (returned …) with the return date when it was returned.

A row reads Refund of Bank Account Payment and nobody at your association refunded it. A refund row means money was sent back to the owner from that payment, by an admin with Move money → Refund payment or by PayHOA support through the payment processor. It adds the amount back to what the owner owes; it isn't a new charge. To check what happened, find the payment on Payments and read its status: Returned means the owner's bank sent the payment back (insufficient funds, a closed account), which nobody at your association or at PayHOA chose to do; Refunded or Partially Refunded means a refund, and the payment's Details list it under Refunds with the date and amount. If the status is Returned but Account history shows the row as a refund, or you can't tell who refunded a payment, contact PayHOA support with the unit, the date and amount of the row and a screenshot of Account history. See How do I see who recorded, deleted, returned or refunded a payment?

Checks that bounce

For checks and cash you recorded, mark the payment as returned yourself. See Mark a check as returned.

Did this answer your question?