> ## Documentation Index
> Fetch the complete documentation index at: https://developers.perkstar.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

> Connect the intended store and verify order, location and loyalty routing.

Reward eligible online and POS orders with customer matching, order reconciliation
and refund recovery. Availability is beta and depends on configuration and the
business's integration entitlement.

## Connect and choose the store

1. Open the intended business in **Perkstar → Integrations → Shopify**.
2. Choose **Connect** and enter the store details requested by the setup form.
3. Review Shopify's authorisation for the correct store. If Perkstar asks you to
   choose a business, select it explicitly before continuing.
4. Return to **Manage** and confirm the store account. Review the default programme
   and location routes before processing customer sales.

Do not connect a second store simply to bypass a missing permission or failed
setup. Each store's programme and location choices should reflect the business's
actual checkout process.

## Check one controlled order

Use an authorised test customer who can be matched to the intended programme.
Check the eligible paid order, its source reference, Perkstar loyalty transaction
and reporting location. Follow a controlled refund through the same records.
Repeated source events must not become repeated loyalty credits.

A connected store or recent product catalogue sync does not prove that a particular
order qualified for loyalty. Check order processing and customer matching separately.

## Recover and disconnect

Use the workspace's activity and error details to identify the affected store,
order and location. Fix mapping or authorisation before requesting supported
recovery. Do not manually credit and replay the same sale without reconciling it.
Disconnect in **Manage** when retiring the connection, and confirm any remaining
Shopify app installation or separately configured automations in Shopify.

For custom integrations, see [customer sync](/guides/customer-sync) and
[idempotency](/fundamentals/idempotency).