Cet espace est communautaire et est basé sur les contributions de chacun. N'hésitez pas a créer de nouveaux documents en suivant les bonnes pratiques.
Documentation Carte Cadeau
Contents |
Principes
Les cartes cadeau permettent aux clients d'un magasin en ligne ou d'une boutique avec point de vente de pouvoir acheter une réserve de paiement sur un magasin configuré dans Neogia. Actuellement, il est possible d'acheter l'activation d'une carte cadeau, de recharger une carte et de payer une commande avec sa carte cadeau.
Entités et services
La gestion des cartes cadeaux est réalisée par les entitées suivantes :
- GiftCard
- Spécification de la carte cadeaux "physique" du client
- GiftCardFulfilment
- Définit tous les actes effectuée sur une carte (activtation, recharche ou paiement)
- PaymentMethod
- Relation entre la carte cadeaux et l'acteur
- FinAccount
- Compte financier indiquant la solde du compte de la gift card
- FinAccountTrans
- Toutes les transactions opérées sur le compte financier
- FinAccountAuth
- Toutes les opérations d'utilisation du compte financier
- Survey
- Questionnaire dynamique utilisé lors de l'activation ou la recharge d'un carte
- ProductStorePaymentSetting
- Configuration (services et properties) des méthodes de paiement sur le centre de profit
- ProductStoreFinActSetting
- Configuration et paramêtrage de l'utilisation des comptes financiers sur le centre de profit
Les principaux services utilisés sont :
- ofbGcPurchase
- Activation d'un compte financier de type gift card
- ofbGcReload
- Rechargement d'un compte financier de type gift card
- ofbGcAuthorize
- Utilisation d'un compte financier pour le payement
Cas d'utilisation
Activation d'une carte cadeaux
L'activation d'un carte cadeau s'effectue au travers d'un produit auquel est associé un contenu de type Réalisation externe (Async) avec serviceName à ofbGcPurchase. Il doit exister un objet Survey (questionnaire) qui soit associé au produit pour lequel sa catégorie permet de renseigner les informations de la carte cadeaux à créer.
Lorsque la commande est terminée, le service ofbGcPurchase est déclenché et un compte financier est créé. Il est associé à l'acteur avec le role PLACING_PARTY. Suivant la configuration du productStore, le finAccount est créé avec un numéro aléatoire ou non et un code pin.
La contrainte actuelle lors de l'activation d'une gift card est que la gift card n'est pas créée et associé à l'utilisateur, ce qui induit une impossibilité d'utiliser le compte financier pour effectuer les paiements. Il est donc nécessaire de créer le gift card à la main pour que l'utilisateur puisse bénéficier de sa carte cadeaux.
Rechargement d'une carte cadeaux
La recharge d'une carte cadeau nécessite un produit auquel est associé un content de type Réalisation externe (Async) avec serviceName à ofbGcReload. Il doit exister un Survey qui soit associé au produit pour lequel sa catégorie permet de renseigner les informations de la carte cadeaux à recharger.
Lorsque la commande est terminée, le service ofbGcReload est déclenché et le compte financier ayant son finAccountId == au numéro de la carte à rechargé et alors réalimenter au travers un finAccountTrans
Il est difficile de recharger une carte actuellement car l'analyse du numéro de carte qui n'est pas adaptée à la génération du numéro de carte.
Paiement avec une carte cadeaux
Lorsqu'un client paye avec une carte cadeaux il est nécessaire que :
- il ait une carte cadeaux (giftCard) associé à son acteur comme moyen de paiement.
- il existe un finAccount avec finAccount.finAccountId = giftcard.cardNumber et finAccount.finAccountCode = giftcard.pinNumber
- le finAccount est alimenté via des finAccountTrans
- chaque finAccountTrans soit bien associée à un payment
Spécificités Neogia
Lors du paiement d'une commande avec une carte cadeau dans Neogia, un objet finAccountTrans est généré mais pas le payment associé à la commande. Les factures deviennent donc difficilement réconciliables. Afin de garder une logique dans l'ensemble du processus de paiement, il a été décidé dans Neogia que le paiement d'une commande par carte cadeau générerai un finAccountTrans de type retrait associé à un paiement.
