The Biller Genie QuickBooks Desktop add-on page is where you check connection status, run manual syncs, and adjust sync behavior. This article walks through every setting on that page. For the broader picture of why QuickBooks Desktop syncs fail and how to keep them reliable, see the QuickBooks Desktop Sync Reliability hub.
Where to find the QuickBooks Desktop add-on page
In the Biller Genie merchant portal, click Add-Ons > QuickBooks Desktop. (If you don't see it, check that the add-on is installed via Add-ons Marketplace.)
Sync status at a glance
At the top of the page, Biller Genie shows real-time sync information:
- Latest message from MagicCarpet — the most recent status message from the Windows-side app.
- Last Ping — when MagicCarpet last checked in with Biller Genie's cloud. Should be within a few minutes if MagicCarpet is online.
- Last Successful Sync — when the most recent successful data exchange happened. May be hours old; what matters is that the gap between Last Ping and Last Successful Sync isn't growing.
- Last Sync Result — success, partial, or failure of the most recent attempt.
- Connected company file — which QuickBooks Desktop company file MagicCarpet is currently bound to.
Use this section to confirm your integration is active. If something looks off, the MagicCarpet Sync Troubleshooting article walks through the diagnostic flow.
Sync settings
Automatic syncing
- Auto Sync — controls whether syncs run automatically. Set to Yes for most environments. No pauses background syncing; you'd run syncs manually with the Sync Now button.
- Auto Sync Interval — how often an automatic sync is initiated (in minutes). 60 minutes or more is recommended. Shorter intervals add load on QuickBooks Desktop without benefit because Biller Genie skips no-op syncs when there are no changes.
Sync performance
- First Sync Chunk Size — how many records are pulled per request on the very first sync after connecting. The default (5,000) works for most accounts. Lower it if your QuickBooks machine has limited memory; raise it if you have a fast machine and a large file.
- Delta Sync Chunk Size — same idea for ongoing incremental syncs (default 2,500).
- Hours to Lookback on Sync — how far back each delta sync checks for changes (default 2 hours). Increase if your business runs across long shifts where activity might fall outside the default lookback window.
Manual actions
- Sync Now — kicks off an immediate sync, regardless of the auto-sync schedule.
- Disconnect — revokes the MagicCarpet authorization and stops syncing.
If you use Automatic Batch Reconciliation
Automatic Batch Reconciliation works with QuickBooks Desktop through this MagicCarpet connection. Batch journal entries, chargeback and reject entries, and the account balances shown on the module screen all travel on the sync cycle you configure here, so a healthy Last Successful Sync is what keeps your reconciliation current. Two things to keep in mind:
- Refund readiness. While Automatic Batch Reconciliation is active, the Refund button on a transaction stays disabled until your sweep, settlement, and refund item mappings are all set up and synced. The disabled button’s tooltip reads: “All required accounts and items must be configured and synced before processing a refund. This allows us to properly sync refunds with your accounting software,” with a Manage Accounts in Accounting Settings link that brings you to the mapping screen.
- Entries appear on the next sync. Because QuickBooks Desktop syncs on an interval rather than in real time, batch journal entries and balance updates land on the next successful sync. See Setting Up ABR: Account Mappings and Balances for the full setup walkthrough.
When to change these settings
Most merchants never need to touch the defaults. The most common adjustments are:
- Turning Auto Sync off temporarily while doing a large data cleanup in QuickBooks Desktop.
- Raising the Hours to Lookback if your overnight sync sometimes misses very late-day transactions.
- Lowering the Chunk Sizes if MagicCarpet times out on a memory-constrained machine.
Related articles
- QuickBooks Desktop Sync Reliability: Why Syncs Fail and How to Fix Them
- How to Connect MagicCarpet to QuickBooks Desktop
- MagicCarpet Sync Troubleshooting for QuickBooks Desktop
- Best Practices for Syncing QuickBooks Desktop
- Understanding Automatic Batch Reconciliation
- Setting Up ABR: Account Mappings and Balances