Conectar Shopify

Conector Shopify (issue-only)

Conecte su tienda Shopify para emitir tarjetas regalo Kadova tras el pago. El canje completo en el checkout de Shopify sigue bajo gate de capacidad.

Quién hace qué

| Rol | Responsable |

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

| Usted (Kadova) | Elegir nivel, instalación, ID de establecimiento, go-live |

| Admin Shopify / agencia | Aprobar la app (OAuth), mapear productos, pedidos staging |

| Plataforma / IT | Webhooks, secretos, desinstalación / revocación |

Pasos (asistente)

1. Nivel (tier) — empiece con issue-only (emisión tras orders/paid). Full-redeem solo si Plus + POC están desbloqueados.
2. Instalación — abra Tienda → Ajustes → asistente Shopify y cree una instalación shopify:issue_only.
3. OAuth — introduzca *.myshopify.com, inicie OAuth, apruebe scopes (read_orders, write_orders, read_products, write_products). El token de acceso permanece cifrado; nunca en tickets.
4. Mapeo de productos — marque productos de tarjeta regalo (título con “gift card” o propiedad de línea con kadova/gift) para que los pedidos pagados disparen la emisión.
5. Go-live — OAuth/conexión sola no basta. En staging: pedido de prueba pagado → el ledger Kadova muestra una tarjeta con shopify:{orderId}; un replay de webhook no debe emitir dos veces.

Prohibido: Gift Cards API de Shopify

No use nunca la Gift Cards API nativa de Shopify / applyGiftCardChange para el saldo Kadova. Esa API es solo para tarjetas emitidas por Shopify, no para saldos Kadova externos.

Manuales

Guía ampliada: docs/connectors/manuals/platforms/shopify.md (*Shopify platform manual*). Los admins de plataforma también la encuentran en Guías del panel de plataforma.