Shopify integration

The Shopify app authorizes access to a shop; the Factuarea store controls invoicing. The official app repository contains installation instructions. An implemented public app is not evidence of a published Shopify App Store listing; use the installation channel provided for your deployment.

Authorize and configure

Complete Shopify authorization and choose the Factuarea company. Keep the permanent *.myshopify.com domain associated with the provider credential. The store API takes the existing integration_id; it does not accept a Shopify access token or perform OAuth on your behalf. Review store settings, then enable the intended environment and invoicing behavior.

Order and buyer data depend on the granted permissions and protected-customer-data access. A successful installation alone does not guarantee that every buyer field is readable. Tax-ID availability affects whether an order can be invoiced with the configured policy. Refund processing requires the original invoice and a supported, settled refund; pending or unsupported changes remain visible in the inbox.

Connection and API version

curl -X POST "https://api.factuarea.com/v1/shopify/stores/$STORE_ID/connection-test" \
  -H "Authorization: Bearer $FACTUAREA_API_KEY" \
  -H "Idempotency-Key: shopify-check-2026-09-08"

This operation requires shopify_store:write. HTTP 200 contains the diagnostic result: check reachable, credential_accepted, failure_code, api_version and supported_until. store_version is the shop’s plan name when reported. The API version is selected by Factuarea and normally remains present even when credentials or transport fail.

Reauthorize the app for shopify_credentials_rejected; check availability for shopify_store_unreachable. shopify_api_version_expired requires updating the connector’s pinned API version, not repeatedly rotating the merchant token. store_url_not_allowed requires correcting the destination policy. The integration inbox explains order-level failures after connectivity is restored.

Installation screens and disconnection

Shopify first requests read_orders and read_customers. After authorization, link your Factuarea account in a top-level page outside the Shopify frame. Complete the link and reopen the app: its screen distinguishes an authorized shop without an account, a link awaiting confirmation and a confirmed account. The connected company still needs a plan with integrations. Invoicing settings live in Factuarea. Uninstalling the Shopify app removes its session; disconnect Factuarea’s own provider connection separately, and retain already-issued invoices.