Skip to main content
Connector tests are only the first check. A connector can authenticate successfully while a real payment, tax, label, print, bank-feed, or marketplace workflow still fails because the record data is incomplete or the external service rejected the action.

​
Start From Integrations

Open Integrations and review connector health, mode, logs, tests, and sync activity before changing records.
Integrations dashboard with connector status cards, connection counts, sandbox and production counters, and error counters

Integrations gives admins one place to review connector state before troubleshooting payments, shipping, printing, marketplaces, bank feed, tax, or calls.

​
Triage Order

  1. Confirm the entity is using the correct sandbox or production mode.
  2. Check whether the connector is connected, disconnected, expired, or in error.
  3. Open connector logs or the Sync Dashboard.
  4. Test the connector if the card offers a test action.
  5. Test the actual workflow with a small safe record.
  6. Fix record data, connector credentials, webhook setup, or external permissions based on the failure.
  7. Re-run the workflow and confirm the external service and Arcus agree.

​
Common Failure Types

Sync Dashboard modal with all, inbound, and outbound filters for connector sync activity

Sync Dashboard separates inbound and outbound connector activity so admins can see whether import or push work is failing.

​
Marketplace Drift

Marketplace drift means Arcus and the marketplace disagree. Common examples include:
  • Marketplace order changed after import.
  • Fulfillment was updated outside Arcus.
  • Listing SKU no longer matches the Arcus product.
  • Inventory changed externally.
  • Price changed on the marketplace but not in Arcus.
  • A Shopify order or product was deleted after Arcus cached its external ID.
Recover by reviewing connector logs, the external marketplace, the Arcus order or product, and the mapping record. Avoid blind re-imports when the customer, payment, fulfillment, or inventory history is already active.

​
Payment, Shipping, And Tax Checks

  • Stripe: check key mode, webhook secret, payment result, authentication requirement, saved method health, dispute state, and payout timing.
  • Shippo: check addresses, package dimensions, weight, carrier service, customs fields, label status, and webhook updates.
  • PrintNode: check connector health, local workstation client, selected default printer, queue status, and failed jobs.
  • AvaTax: check addresses, tax codes, exemption state, marketplace facilitator rules, document strategy, and resync errors.
  • Plaid: check bank authorization, linked account, sync result, and reconciliation match state.
  • RingCentral: check credentials, extension mapping, manual sync, webhook subscription, and recording availability.

Connector Dashboard

Review connector mode, health, masked credentials, tests, logs, sync dashboard, and safe reconnect steps.

Marketplace Connectors

Connect Shopify, Amazon, and eBay, review sync settings, mapping, webhooks, logs, and marketplace blocks.

Stripe Payments

Configure Stripe keys, webhooks, payment workflows, saved methods, reconcile, payouts, and disputes.

Shippo and PrintNode

Configure Shippo for rates, labels, tracking, and voids, and PrintNode for labels and document printing.