Utilisez cet article pour configurer 4 des modèles de connecteurs de données de compensation Shopify préconstruits par Fin — afin que Fin puisse proposer des devis de remboursement, émettre un crédit en magasin et vérifier ou révoquer des cartes-cadeaux lors d'une conversation de support, sans intervention d'un coéquipier.
Les connecteurs de données permettent à Fin d'appeler des API externes (interfaces de programmation d'applications) en cours de conversation pour récupérer ou mettre à jour des données en temps réel. Les modèles Shopify sont des connecteurs préconfigurés qui appellent l'API REST Admin de Shopify en votre nom. Les API scopes sont les autorisations spécifiques que votre boutique Shopify doit accorder avant qu'un connecteur puisse lire ou écrire ces données.
Conseil : Ces 4 modèles de compensation font partie d'un ensemble plus large de modèles de connecteurs de données Shopify, incluant les recherches de commandes, modifications de commandes, codes de réduction, et recherche de produits et panier Storefront. Consultez la liste complète dans Utiliser les modèles de connecteurs de données.
Ce que fait chaque modèle de compensation Shopify
Les quatre modèles de connecteurs de données Shopify pour Fin sont listés ci-dessous — chacun couvre une partie différente du flux de travail de compensation.
Calculer un remboursement Shopify
Propose un devis de remboursement — incluant les frais de port remboursables, la taxe, et le maximum remboursable par transaction de paiement — sans déplacer d'argent. C'est une action à blanc : elle calcule ce qu'un remboursement serait avant qu'il ne soit émis. Associez-la à l'action Créer un remboursement Shopify lorsque vous souhaitez que Fin confirme le montant avec le client avant traitement. N'écrit pas dans Shopify.
Émettre une carte-cadeau Shopify
Émet un crédit en magasin sous forme de carte-cadeau Shopify. Shopify envoie le code directement par email au client — le code échangeable n'est jamais retourné à Fin ni visible dans la conversation. Fin ne voit que l'ID de la carte, le solde, la devise, la date d'expiration et les 4 derniers caractères. Ce modèle écrit dans Shopify.
Obtenir le solde d'une carte-cadeau Shopify
Vérifie le solde restant, la valeur initiale et la date d'expiration d'une carte-cadeau Shopify d'un client. Utilisez ceci lorsqu'un client demande combien de crédit il lui reste ou si une carte a été utilisée. N'écrit pas dans Shopify.
Désactiver une carte-cadeau Shopify
Révoque une carte-cadeau mal émise — par exemple, envoyée pour un mauvais montant, au mauvais client, ou émise par erreur. La carte cesse de fonctionner immédiatement.
Important : Cette action est irréversible — Shopify ne peut pas réactiver une carte-cadeau désactivée. Si une carte est révoquée par erreur, émettez un remplacement en utilisant le modèle Émettre une carte-cadeau Shopify.
Comment ajouter un modèle
Trouvez le modèle que vous souhaitez ajouter dans la section Shopify.
Connectez (ou réutilisez) votre connexion de boutique Shopify — l'URL de l'action cible automatiquement la boutique connectée à votre espace de travail. Aucune configuration de domain par action n'est nécessaire.
Vérifiez les paramètres préremplis, la description et les instructions d'utilisation de Fin. Cliquez sur Mettre en service pour activer le modèle. Vous verrez le connecteur listé comme actif dans Paramètres > Intégrations > Connecteurs de données.
Note : Chaque modèle est activé par espace de travail. Une fois en service, testez le connecteur dans une conversation réelle — le mode aperçu de Fin ne fait pas d'appels en direct aux connecteurs de données.
Autorisations Shopify requises
Avant d'ajouter les modèles de cartes-cadeaux, votre boutique Shopify doit disposer des scopes read_gift_cards et write_gift_cards. Shopify ne les accorde pas par défaut — un administrateur marchand doit les demander au support Shopify.
Important : Les trois modèles de cartes-cadeaux (Émettre une carte-cadeau Shopify, Obtenir le solde d'une carte-cadeau Shopify, Désactiver une carte-cadeau Shopify) renverront une erreur d'autorisation tant que ces scopes ne seront pas accordés. C'est la cause la plus probable d'un échec au premier lancement. Une fois les scopes accordés par le support Shopify, retournez dans Paramètres > Intégrations > Connecteurs de données pour ajouter ou retester vos modèles de cartes-cadeaux — aucune réinstallation de l'application Shopify n'est nécessaire.
Le modèle Calculer un remboursement Shopify a une exigence distincte : il nécessite le scope orders ou marketplace_orders, que Shopify accorde par défaut.
Limitations connues
Les limitations suivantes s'appliquent aux quatre modèles de connecteurs de données Shopify pour Fin. Chaque limitation nomme le ou les modèles concernés.
Calculer un remboursement Shopify — devis au niveau de la commande et des frais de port uniquement. Le devis par ligne d'article n'est pas pris en charge par ce modèle. Le paramètre de devise doit également correspondre exactement à la devise de la commande, sinon Shopify rejette la demande.
Désactiver une carte-cadeau Shopify — cette action est irréversible. Shopify ne dispose pas d'un point de terminaison API pour réactiver (restaurer) une carte désactivée. Si une carte est révoquée par erreur, émettez un remplacement en utilisant le modèle Émettre une carte-cadeau Shopify.
Émettre une carte-cadeau Shopify — le code de la carte-cadeau n'est jamais visible dans la conversation. Lorsque Fin utilise ce modèle, Shopify envoie le code directement par email au client. Si un client dit ne pas l'avoir reçu, vérifiez l'adresse email du client dans Shopify Admin et le journal des notifications de Shopify.
Tous les quatre modèles — les champs de réponse sont limités à ceux listés dans la configuration de chaque modèle. Seules les attributs de réponse explicitement listés dans un modèle sont lisibles par Fin — tous les autres champs Shopify sont masqués et indisponibles.
FAQ
Fin affichera-t-il le code de la carte-cadeau au client dans la conversation ?
Fin affichera-t-il le code de la carte-cadeau au client dans la conversation ?
Non — Fin n'affichera pas le code de la carte-cadeau au client dans la conversation. Lorsque Fin émet une carte-cadeau en utilisant le modèle Émettre une carte-cadeau Shopify, Shopify envoie le code directement par email au client. Le code échangeable n'est jamais retourné à Fin ni visible dans la conversation. Fin ne voit que l'ID de la carte, le solde, la devise, la date d'expiration et les 4 derniers caractères.
Fin peut-il proposer un devis de remboursement avant de l'émettre réellement ?
Fin peut-il proposer un devis de remboursement avant de l'émettre réellement ?
Oui — Fin peut proposer un devis de remboursement avant de l'émettre réellement. Le modèle Calculer un remboursement Shopify renvoie un devis de remboursement — frais de port remboursables, taxe, et montant maximum remboursable — sans déplacer d'argent. Utilisez-le avec l'action existante Créer un remboursement Shopify lorsque vous souhaitez que Fin propose d'abord un devis, puis confirme avant d'émettre.
Que se passe-t-il si une carte-cadeau est révoquée ?
Que se passe-t-il si une carte-cadeau est révoquée ?
Si une carte-cadeau est révoquée en utilisant le modèle Désactiver une carte-cadeau Shopify, la carte cesse de fonctionner immédiatement et ne peut pas être restaurée. Shopify ne dispose pas d'un point de terminaison pour réactiver (restaurer) une carte désactivée. Si une carte a été révoquée par erreur, émettez un remplacement en utilisant le modèle Émettre une carte-cadeau Shopify.
Quelle version de l'API Shopify ces modèles utilisent-ils ?
Quelle version de l'API Shopify ces modèles utilisent-ils ?
Les quatre modèles de connecteurs de données de compensation Shopify fonctionnent avec l'API REST Admin de Shopify (interface de programmation d'applications) version 2025-04.