QuickBooks & bank deposits
QuickBooks sync errors and fixes
What each sync-log message means and the one thing to do about it.
2 min read · Updated October 31, 2026
Problems appear in Settings → Accounting → Sync log and on your dashboard's attention list. Once you fix the cause, click Retry on the row (or Sync now at the top); the hourly run will also pick it up.
| Message | Meaning | Fix |
|---|---|---|
The fund "X" isn't mapped to a QuickBooks income account yet (unmapped_fund) | A gift in this deposit belongs to a fund with no income account | Map the fund in the accounts mapping, then Retry |
No bank account mapped (no_bank_account) | The bank account for Stripe deposits (or for offline deposits) isn't set | Pick the account in the mapping |
No default income account (no_default_income) | A gift with no fund needs somewhere to go | Set the default income account |
Payout not tied out yet (payout_not_tied) | The Stripe payout hasn't been matched to its gifts and fees to the cent, so it isn't safe to post | Usually resolves itself within an hour as Stripe finishes reporting; if it persists a day, send us a ticket with the payout date |
Books are closed for that date (closed_period) | QuickBooks has a closing date after the deposit date | Open the period in QuickBooks (Settings → Advanced → Accounting) or ask your accountant, then Retry |
Connection expired (token_expired) | QuickBooks' connection token lapsed (they expire after about 100 days of inactivity) or someone disconnected the app in QuickBooks | Click Reconnect and sign in to QuickBooks. Nothing is lost; pending deposits post afterwards |
Account not usable (bad_account) | A mapped account was deleted, made inactive, or is the wrong type for its role | Re-pick an active account of the right type |
Not errors
- Waiting for payout: the Stripe payout hasn't arrived yet.
- Skipped: someone chose Skip on that deposit. Unskip to post it.
Deposit already in QuickBooks?
If you entered a deposit by hand before connecting, don't post it twice. Open the row in the sync log and choose Link existing deposit, then paste the QuickBooks transaction ID. DonorFinch won't create a duplicate; it also guards against duplicates automatically by checking the stored QuickBooks ID, the reference tag on the deposit, and the deposit's line fingerprint.
If the numbers look wrong
Open the deposit in DonorFinch's Deposits report and in QuickBooks side by side. The net should match the bank. If a fund split differs, a gift was probably moved to another fund after the deposit posted. Use Sync now in verify mode to re-read every posted deposit, or send us a ticket with the deposit date.