Shopify verbinden

Shopify-Connector (Issue-only)

Verbinden Sie Ihren Shopify-Shop, um nach Zahlung Kadova-Gutscheine auszustellen. Volle Einlösung im Shopify-Checkout bleibt capability-gated.

Wer macht was

| Rolle | Verantwortlich |

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

| Sie (Kadova) | Tier wählen, Installation, Filial-ID, Go-live abhaken |

| Shopify-Admin / Agentur | App freigeben (OAuth), Produkte mappen, Staging-Orders |

| Platform/IT | Webhooks, Secrets, Uninstall/Revoke |

Schritte (Assistent)

1. Tier — starten Sie mit issue-only (Ausgabe nach orders/paid). Full-redeem nur bei Plus + freigegebenem POC.
2. Installation — öffnen Sie Webshop → Einstellungen → Shopify-Assistent und erstellen Sie eine shopify:issue_only-Installation.
3. OAuth — *.myshopify.com eingeben, OAuth starten, Scopes freigeben (read_orders, write_orders, read_products, write_products). Access-Token bleibt verschlüsselt; nie in Tickets.
4. Produkt-Mapping — Gutscheinprodukte kennzeichnen (Titel mit „gift card“ oder Line-Property mit kadova/gift), damit bezahlte Orders die Ausgabe auslösen.
5. Go-live — OAuth/Verbindung allein reicht nicht. Auf Staging bestätigen: bezahlte Testorder → Kadova-Ledger zeigt Karte mit shopify:{orderId}; Webhook-Replay darf nicht doppelt ausstellen.

Verboten: Shopify Gift Cards API

Nutzen Sie niemals Shopifys native Gift Cards API / applyGiftCardChange für Kadova-Saldo. Diese API gilt nur für Shopify-eigene Gift Cards, nicht für externes Kadova-Saldo.

Handbücher

Erweiterte Anleitung: docs/connectors/manuals/platforms/shopify.md (*Shopify platform manual*). Plattform-Admins finden sie auch unter Handbücher im Plattform-Dashboard.