Connect Shopify

Shopify connector (issue-only)

Connect your Shopify store to issue Kadova gift cards after payment. Full redeem in Shopify checkout stays capability-gated.

Who does what

| Role | Owns |

|------|------|

| You (Kadova) | Choose tier, installation, store ID, go-live sign-off |

| Shopify admin / agency | Approve the app (OAuth), map products, staging orders |

| Platform / IT | Webhooks, secrets, uninstall/revoke |

Wizard steps

1. Tier — start with issue-only (issue after orders/paid). Full-redeem only when Plus + POC are unlocked.
2. Install — open Webshop → Settings → Shopify wizard and create a shopify:issue_only installation.
3. OAuth — enter *.myshopify.com, start OAuth, approve scopes (read_orders, write_orders, read_products, write_products). Access token stays encrypted; never paste into tickets.
4. Product mapping — tag gift-card products (title contains “gift card” or line property with kadova/gift) so paid orders trigger issue.
5. Go-live — OAuth/connection alone is not enough. On staging confirm: paid test order → Kadova ledger shows a card with shopify:{orderId}; webhook replay must not double-issue.

Forbidden: Shopify Gift Cards API

Never use Shopify’s native Gift Cards API / applyGiftCardChange for Kadova balance. That API is only for Shopify-issued gift cards, not external Kadova balances.

Manuals

Extended guide: docs/connectors/manuals/platforms/shopify.md (*Shopify platform manual*). Platform admins can also download it via Guides in the platform dashboard.