Shopify koppelen

Shopify-connector (issue-only)

Koppel uw Shopify-winkel om na betaling Kadova-cadeaubonnen uit te geven. Volledige inwisseling in Shopify-checkout blijft capability-gated.

Wie doet wat

| Rol | Verantwoordelijk |

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

| U (Kadova) | Tier kiezen, installatie, vestiging-ID, go-live afvinken |

| Shopify-admin / bureau | App goedkeuren (OAuth), producten mappen, staging-orders |

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

Stappen (wizard)

1. Tier — start met issue-only (verkoop na orders/paid). Full-redeem alleen als Plus + POC vrijgegeven zijn.
2. Installatie — open Webshop → Instellingen → Shopify-wizard en maak een shopify:issue_only-installatie.
3. OAuth — vul *.myshopify.com in, start OAuth, keur scopes goed (read_orders, write_orders, read_products, write_products). Access token blijft versleuteld; nooit in tickets.
4. Product mapping — markeer cadeaubonproducten (titel met “gift card” of line property met kadova/gift) zodat betaalde orders uitgifte triggeren.
5. Go-live — OAuth/verbinding alleen is niet genoeg. Bevestig op staging: betaalde testorder → Kadova-ledger toont bon met shopify:{orderId}; webhook-replay mag niet dubbel uitgeven.

Verboden: Shopify Gift Cards API

Gebruik nooit Shopify’s native Gift Cards API / applyGiftCardChange voor Kadova-saldo. Die API is alleen voor Shopify-uitgegeven gift cards, niet voor externe Kadova-saldi.

Handleidingen

Uitgebreide handleiding: docs/connectors/manuals/platforms/shopify.md (*Shopify platform manual*). Platformbeheerders vinden die ook via Handleidingen in het platformdashboard.