Refund failed — insufficient processor balance
This article explains what to do when a refund attempt fails because your Stripe account doesn’t have enough balance to cover it.
What’s happening
Section titled “What’s happening”Stripe pays refunds from your Stripe account balance — not by pulling funds from a card. If your Stripe balance is lower than the refund amount, Stripe blocks the refund.
This typically happens when:
- Your org has issued more refunds than it has received in recent payments.
- There is a delay between when Stripe settles payments into your balance and when you issue refunds.
- A large refund is being attempted shortly after the original payment, before Stripe has fully settled the funds.
How to fix it
Section titled “How to fix it”- Log in to your Stripe Dashboard and check your current account balance.
- Compare the available balance to the refund amount you’re trying to issue.
- If there are recent payouts to your bank account, you may have more in your balance than shows immediately — Stripe’s balance display may be slightly delayed.
If funds will be available shortly: wait 1 to 3 business days for pending payments to settle, then retry the refund from the payment detail page (the Payments list at /admin/billing/transactions, then View on the payment, then Full refund).
If funds will not be available soon: contact Stripe support to arrange a refund from outside your current balance. Stripe can fund refunds by bank transfer if the refund is time-sensitive.
If you will settle the refund yourself: when the refund fails with the insufficient-balance message, the refund dialog offers Mark pending external resolution. Select it. That records the refund as awaiting out-of-band settlement, so the obligation is on the payment, and then issue the manual offline refund (for example, a check). The refund dialog can’t send the refund to the member’s account balance instead, and the payment detail page has no notes field. When your Stripe balance recovers, don’t duplicate the refund online.
Marking a refund pending for out-of-band settlement is a different thing from the past-the-window case, which offers Re-issue as account-balance credit instead. See Billing refund model reference.
To avoid this in the future: check your Stripe balance before issuing large refunds, especially on days when you’ve also had large payouts to your bank.
If that didn’t work
Section titled “If that didn’t work”If your Stripe balance covers the refund and it still fails, the refund dialog’s message names the cause. “The payment processor declined this refund.” is Stripe refusing it, with Stripe’s own reason (for example, the charge is already refunded or disputed). “We couldn’t confirm whether the refund went through” means Stripe didn’t answer in time — check the payment’s refunds before trying again. Where Stripe won’t refund the card, settle the refund outside MapleGather; Mark pending external resolution is offered only for the insufficient-balance failure.