Module Carte cadeau

Article
07/25/2024

Cet article couvre les modules de carte cadeau et décrit comment les ajouter aux pages du site dans Microsoft Dynamics 365 Commerce.

Les modules de cartes cadeaux peuvent être utilisé dans les modules de paiement pour accepter des cartes cadeaux, moyen de paiement courant utilisé dans les transactions d’e-commerce. Le module de carte cadeau prend en charge les cartes cadeaux Dynamics 365, SVS et Givex. Les cartes cadeaux SVS et Givex sont échangées via le fournisseur de paiement Adyen. Pour plus d’informations sur la prise en charge des cartes cadeaux externes telles que SVS et Givex, voir Prise en charge des cartes cadeaux externes.

Note

La prise en charge du remboursement des cartes cadeaux SVS et Givex pendant le processus de paiement est disponible dans la version 10.0.11 de Dynamics 365 Commerce.

Deux modules de cartes-cadeaux sont disponibles :

Carte cadeau – Ce module peut être utilisé sur une page de paiement pour utiliser une carte-cadeau comme offre.
Vérification du solde de la carte-cadeau – Ce module peut être utilisé sur n’importe quelle page pour vérifier le solde d’une carte cadeau. Ce module est disponible dans Commerce version 10.0.14 et ultérieure.

Note

La prise en charge du module de vérification du solde de la carte cadeau est disponible dans la version 10.0.14 de Dynamics 365 Commerce.

L’image suivante montre un exemple de module de carte cadeau dans une page de caisse.

Exemple d’un module de carte cadeau.

Propriétés du module

Afficher des champs supplémentaires – Cette propriété définit quels champs doivent être affichés pour les cartes cadeaux en plus du numéro de carte-cadeau, qui est toujours affiché par défaut. Par exemple, certaines cartes cadeaux prennent en charge l’affichage d’un numéro d’identification personnel (PIN) et d’autres prennent en charge l’affichage d’un code PIN et d’une date d’expiration. Alternativement, cette propriété peut être définie sur « Aucune », ce qui n’affichera que le numéro de la carte cadeau et aucun champ supplémentaire.

Les valeurs suivantes sont prises en charge :
- Code PIN
- Date d’expiration
- Code PIN et date d’expiration
- None
Activer pour les utilisateurs invités : lorsque cette propriété est activée, les utilisateurs invités peuvent accepter ou vérifier les soldes des cartes-cadeaux externes. Cette propriété nécessite que l’accès anonyme (invité) pour les cartes-cadeaux externes soit activé dans Commerce Headquarters. Le paramètre Activer pour les utilisateurs invités s’applique uniquement aux cartes-cadeaux externes. Pour plus d’informations, consultez Activer les paiements par carte-cadeau pour la caisse invités.

Important

La propriété Activer pour les utilisateurs invités est disponible à partir de Commerce version 10.0.21. Elle nécessite l’installation du package de bibliothèque du module Commerce version 9.31.

Paramètres du site pour les modules de cartes cadeaux

Dans le générateur de site Commerce, sous Paramètres du site > Extensions, il y a un paramètre de module de carte cadeau appelé Type de carte cadeau pris en charge. Ce paramètre prend en charge trois valeurs :

Carte cadeau Dynamics 365 – Lorsque ce paramètre est appliqué, le module de carte cadeau permet uniquement le rachat de cartes cadeaux Dynamics 365. Ce paramètre n’est pris en charge que pour les utilisateurs connectés sur le site de commerce électronique. La fonctionnalité de vérification du solde de la de carte-cadeau n’est prise en charge que pour les utilisateurs connectés.
Cartes cadeaux SVS et Givex – Lorsque ce paramètre est appliqué, le module de carte cadeau permet uniquement le rachat de cartes cadeaux Givex et SVS. Ce paramètre est pris en charge pour les utilisateurs connectés et anonymes sur le site de commerce électronique.
Cartes cadeaux Dynamics 365, SVS et Givex – Lorsque ce paramètre est appliqué, le module de carte cadeau permet uniquement le rachat de cartes cadeaux Dynamics 365, Givex et SVS. Ce paramètre n’est pris en charge que pour les utilisateurs connectés sur le site de commerce électronique. En raison de l’inclusion des cartes-cadeaux internes, la fonctionnalité de vérification du solde de carte-cadeau n’est prise en charge que pour les utilisateurs connectés.

Important

Ces paramètres sont disponibles dans la version 10.0.11 de Dynamics 365 Commerce et ne sont requis que si vous avez besoin d’assistance pour les cartes cadeaux SVS ou Givex. Si vous effectuez une mise à jour à partir d’une ancienne version de Dynamics 365 Commerce, vous devez mettre à jour manuellement le fichier appsettings.json. Pour obtenir des instructions de mise à jour du fichier appsettings.json, consultez Mise à jour du kit de développement logiciel et de la bibliothèque de modules.

Étendre les cartes-cadeaux internes aux vitrines de commerce électronique

Par défaut, les cartes-cadeaux internes ne sont pas optimisées pour les vitrines de commerce électronique. Par conséquent, avant d’autoriser l’utilisation de cartes-cadeaux internes pour le paiement, vous devez les configurer avec des extensions qui les rendent plus sécurisées. Voici les zones de cartes-cadeaux que vous devez étendre avant d’autoriser l’utilisation de cartes-cadeaux internes en production :

Numéro de la carte-cadeau – Les séquences de numéros sont utilisées pour générer des numéros de carte-cadeau pour les cartes-cadeaux internes. Étant donné que les séquences de numéros peuvent être facilement prédites, vous devez étendre la génération des numéros de carte-cadeau afin que des chaînes aléatoires sécurisées par cryptographie soient utilisées pour les numéros émis.
GetBalance – L’API GetBalance est utilisé pour rechercher les soldes des cartes-cadeaux. Par défaut, il s’agit d’une API publique. Si un code PIN n’est pas requis pour rechercher les soldes des cartes-cadeaux, il existe un risque que des attaques par force brute utilisent l’API GetBalance pour pirater les numéros de cartes-cadeaux qui ont des soldes. En mettant en œuvre à la fois un code PIN pour les cartes-cadeaux internes et la limitation de l’API, vous pouvez atténuer ce risque.
PIN – Par défaut, les cartes-cadeaux internes ne prennent pas en charge les codes PIN. Vous devez étendre les cartes-cadeaux internes afin qu’un code PIN soit nécessaire pour rechercher les soldes. Cette fonctionnalité peut également être utilisée pour verrouiller les cartes-cadeaux après plusieurs tentatives incorrectes de saisie du code PIN.

Activer les paiements par carte-cadeau pour la caisse d’invité

Par défaut, les paiements par carte-cadeau ne sont pas activés pour la caisse d’invité (anonyme). Pour les activer, procédez comme suit.

Dans Commerce Headquarters, accédez à Retail et Commerce > Configuration de canal > Configuration de PDV > PDV > Opérations PDV.
Sélectionnez et maintenez sélectionné (ou cliquez avec le bouton droit) l’en-tête de la grille, puis sélectionnez Insérer des colonnes.
Dans la boîte de dialogue Insérer des colonnes, sélectionnez la case à cocher AllowAnonymousAccess.
Sélectionnez Mettre à jour.
Pour les opérations 520 (Solde de carte-cadeau) et 214, définissez la valeur AllowAnonymousAccess sur 1.
Sélectionnez Enregistrer.
Exécutez la la tâche du planificateur 1090 pour synchroniser les modifications avec la base de données des canaux.

Ajouter un module de carte cadeau à une page

Pour obtenir des instructions sur la façon d’ajouter un module de carte cadeau à une page de paiement et de définir les propriétés requises, voir Module de paiement .