Connecter Shopify

Connecteur Shopify (issue-only)

Connectez votre boutique Shopify pour émettre des cartes cadeaux Kadova après paiement. L’utilisation complète dans le checkout Shopify reste sous gate de capacité.

Qui fait quoi

| Rôle | Responsable |

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

| Vous (Kadova) | Choisir le niveau, installation, ID établissement, go-live |

| Admin Shopify / agence | Approuver l’app (OAuth), mapper les produits, commandes staging |

| Plateforme / IT | Webhooks, secrets, désinstallation / révocation |

Étapes (assistant)

1. Niveau (tier) — commencez par issue-only (émission après orders/paid). Full-redeem uniquement si Plus + POC sont débloqués.
2. Installation — ouvrez Boutique → Paramètres → assistant Shopify et créez une installation shopify:issue_only.
3. OAuth — saisissez *.myshopify.com, lancez OAuth, approuvez les scopes (read_orders, write_orders, read_products, write_products). Le jeton d’accès reste chiffré ; jamais dans les tickets.
4. Mapping produits — marquez les produits carte cadeau (titre avec « gift card » ou propriété de ligne kadova/gift) pour que les commandes payées déclenchent l’émission.
5. Go-live — OAuth/connexion seule ne suffit pas. Sur staging : commande test payée → le ledger Kadova montre une carte avec shopify:{orderId} ; un replay webhook ne doit pas double-émettre.

Interdit : Gift Cards API Shopify

N’utilisez jamais la Gift Cards API native Shopify / applyGiftCardChange pour le solde Kadova. Cette API est réservée aux cartes Shopify, pas aux soldes Kadova externes.

Manuels

Guide étendu : docs/connectors/manuals/platforms/shopify.md (*Shopify platform manual*). Les admins plateforme le trouvent aussi via Guides dans le tableau de bord plateforme.