Most MagicCarpet sync issues come down to one of three things: MagicCarpet isn't running, QuickBooks Desktop isn't open with the right company file, or the connection between the two needs to be re-authorized. This article walks through how to diagnose what's wrong and fix it.
Step 1 — Check MagicCarpet status in Biller Genie
- Sign in to the Biller Genie merchant portal.
- Click Add-ons and select QuickBooks Desktop.
- Look at the Last Ping timestamp. If it's more than a few minutes old, MagicCarpet isn't reaching Biller Genie. If it's recent (within the last minute or two), MagicCarpet is online.
- Look at the Last Successful Sync timestamp. If pings are recent but the last successful sync is hours or days old, something is failing on the sync itself, not the connection.
Step 2 — Confirm the MagicCarpet computer is online
- Make sure the Windows machine where MagicCarpet is installed is powered on and awake. Laptops in sleep mode break the connection.
- Confirm the computer has internet connectivity — try opening a web browser on that machine.
- Check the MagicCarpet icon in the Windows system tray. Hovering should show "MagicCarpet — Online." If it shows offline or the icon is missing, restart MagicCarpet (next step).
Step 3 — Restart MagicCarpet
- On the Windows machine, right-click the MagicCarpet icon in the system tray and choose Exit.
- Open the Windows Start menu, find MagicCarpet under Biller Genie, and launch it again.
- Wait 30 seconds, then check the Biller Genie merchant portal — the Last Ping timestamp should refresh.
Step 4 — Make sure QuickBooks Desktop is open with the right company file
- MagicCarpet needs QuickBooks Desktop to be running with the company file you authorized at connection time.
- If QuickBooks Desktop is closed, open it and the correct company file, then click Sync Now in the Biller Genie portal.
- If the company file has been moved or renamed, MagicCarpet may need to be re-authorized. Open the file in QuickBooks Desktop and watch for the Application Certificate dialog to appear; approve it as you did during initial setup. See How to Connect MagicCarpet to QuickBooks Desktop.
Step 5 — Trigger a manual sync
- Once MagicCarpet is showing as online and QuickBooks Desktop is open, click Sync Now on the QuickBooks Desktop add-on page in the Biller Genie portal.
- Watch the progress indicator. If the sync completes successfully, the Last Successful Sync timestamp updates and you're back in business.
- If the sync fails, the portal shows an error message at the top of the QuickBooks Desktop add-on page. Use that message to diagnose further.
Common error messages and what they mean
- "MagicCarpet is not running or is not online." — The Windows machine is asleep, off, or MagicCarpet itself has stopped. Restart MagicCarpet (Step 3).
- "You must be connected to QuickBooks to sync data." — QuickBooks Desktop isn't open, or the company file MagicCarpet was authorized against isn't loaded. Open the file (Step 4).
- "Sync already in progress." — Another sync is running. Wait a couple minutes and try again. This is normal during large first syncs of big company files.
- "Version mismatch" or "QuickBooks Desktop SDK error" — MagicCarpet's version doesn't match what QuickBooks Desktop expects, or the SDK isn't installed. Reinstall MagicCarpet using the latest installer from the Biller Genie portal.
When to contact support
If you've worked through the steps above and the sync still isn't running, reach out to SubscriberSuccess at subscribersuccess@billergenie.com or book a call at subscribersuccess.billergenie.com. Have ready:
- Last Ping and Last Successful Sync timestamps from the Biller Genie portal.
- The exact error message you're seeing (screenshot helps).
- QuickBooks Desktop edition and version (Pro/Premier/Enterprise + year).
- Whether the company file has been moved, renamed, or backed up/restored recently.