Troubleshooting common setup and sync issues
Most setup issues fall into a few patterns: missing credentials, expired connections, missing mappings, blocked previews, or background worker problems. This checklist is the fastest place to start.
Connection problems
- - OAuth credentials missing: check the relevant provider client ID, secret, and redirect URI on the server.
- - Invalid Shopify shop domain: use the myshopify.com domain, not the storefront domain.
- - WooCommerce store URL invalid: enter the full store base URL and verify the REST API key has access.
- - QuickBooks realmId missing: reconnect QuickBooks and confirm the callback completed cleanly.
- - Xero tenant missing: reconnect and confirm the correct tenant or demo company was selected.
Preview and mapping problems
- - Mapping missing: import accounts/items again and review required mappings.
- - Marketplace fee or clearing mapping missing: add the marketplace-specific mapping types before generating a settlement preview.
- - Preview blocked: check exceptions for missing required mappings, duplicate source IDs, or invalid amounts.
- - Posting disabled: confirm sandbox posting flags and approval rules are satisfied.
Operational problems
- - CSV import failed: check file format, row limits, required columns, and row-level validation errors.
- - Amazon connector not configured: use CSV settlement imports until SP-API setup is enabled.
- - eBay connector not configured: use payout CSV imports until connector setup is enabled.
- - Webhook signature failed: verify the provider webhook secret and the local tunnel or production URL.
- - Rate limited: LedgerSync pauses and retries provider calls when supported. Check operations status for repeated throttling.
- - Worker not running: review the internal worker route or worker process status and inspect failed jobs.
Related articles
Keep moving through setup with the next most relevant guides.
Connect Shopify
Set up a Shopify dev or test store, enter the shop domain, authorize the app, and import orders and products safely.
Connect Stripe
Connect Stripe in OAuth or test mode, import balance transactions, and review payouts, refunds, disputes, and fees.
Connect QuickBooks Online Sandbox
Authorize a QuickBooks sandbox company, import company info, accounts, and items, and keep posting limited to sandbox.
Connect Xero Demo Company
Authorize Xero, pick the demo tenant or an allowed tenant, import accounts and items, and keep preview posting in demo-only mode.
Need help? Contact support
Support is the best next step when OAuth, imports, mappings, or reviewer access are blocked.