Contenu
Le service createWallet permet de créer un portefeuille virtuel en fournissant la référence de wallet et les données carte (numéro, date d'expiration, cvx). Pour le créer à partir de l’interface web et ne pas avoir à manipuler d'information carte, vous pouvez effectuer cette opération après une demande de paiement ou d'information acceptée. Il vous suffit pour cela La provenance des données du titulaire du wallet est donnée par le tableau suivant: Le service createWallet permet également d'ajouter une carte à un portefeuille virtuel existant. Pour cela, fournir la référence de wallet et les données carte (numéro, date d'expiration, cvx). La nouvelle carte ajoutée se voit automatiquement affecté un nouvel index égal à la valeur de l'index le plus grand existant précédemment incrémentée d'une unité. Pour effectuer l'ajout à partir de l’interface web sans avoir à manipuler d'information carte, vous pouvez effectuer cette opération après une demande de paiement ou d'information acceptée. Il vous suffit pour cela L'authentification forte de l'acheteur est requise. Le code action à utiliser dépend de la destination du wallet et du paiement effectué. Le tableau ci-dessous décrit les différents cas valeur du paramètre payment.action dans le doWebPayment Enregistrer la carte en dehors de tout paiement pour de futurs achats sur le site Permet au porteur de souscrire à un service et d'autoriser le commerçant de prélever les montants dus sur sa carte. Par exemple paiement de la facture d'électricité de gaz des péages d'autoroute, etc... Le service updateWallet permet de modifier la carte d'un portefeuille virtuel en fournissant la référence de wallet, l'index de carte dans le portefeuille et les données carte (numéro, date d'expiration, cvx). Pour effectuer la modification à partir de l’interface web sans avoir à manipuler d'information carte, vous pouvez effectuer cette opération après une demande de paiement ou d'information acceptée. Il vous suffit pour cela L'authentification forte de l'acheteur est requise. Le code action à utiliser dans le doWebPayment dépend du cas d'usage se reporter à la description effectuée pour l'ajout d'une carte. Le service updateWallet permet de modifier les données du porteur en fournissant la référence de wallet et les données porteur sans aucune donnée carte ni aucune référence de transaction. Les services disableWallet et enableWallet permettent de désactiver ou de réactiver un wallet. Les opérations peuvent porter sur le wallet tout entier ou sur une carte d'un wallet. Pour n'agir que sur une carte donnée, il suffit de préciser son index dans la demande. Pour agir sur l'ensemble des cartes du wallet il suffit de ne préciser aucune carte. Il est possible d’exécuter un paiement en utilisant un portefeuille électronique existant, ou de créer un portefeuille au moment du paiement. A l’aide d’un portefeuille électronique, vous pouvez effectuer différent mode de paiement : Il suffit d’utiliser le webservice doWebPayment qui permet d’initialiser une transaction de paiement web, à cette occasion il est possible d’utiliser un portefeuille existant donc le consommateur n’aura pas à ressaisir ces données de paiement ou de créer un portefeuille afin qu’il soit utilisé par la suite. Dans ce dernier cas, vous devez configurer le point de vente et renseigner la balise buyer.walletID lors du doWebPayment. Le wallet est toujours utilisé avec un contrat VAD. Afin d’obtenir le résultat suite à un doWebPayment, vous devez exécuter la demande suivante getWebPaymentDetails. Il est possible de modifier un portefeuille, de mettre à jour les données privées et/ou les données monétiques à l’aide de la fonction manageWebWallet, et il est tout à fait possible de désactiver un portefeuille en allant sur le centre administration et de le rentre inactif. Afin d’obtenir le résultat suite à ces fonctions, vous devez exécuter la demande suivante getWebWallet. Les services createWebWallet et updateWebWallet ont été remplacés par le service manageWebWallet pour les pages web en mode Redirection ou Widget. Le centre administration permet de configurer la mémorisation d'une carte au cours d'un paiement. Cette configuration s'effectue par point de vente et est accessible à partir du menu de configuration du point de vente. L'enregistrement au cours de l'achat peut se faire : En tout état de cause, la mémorisation des coordonnées carte d'un client ne peut être exécutée à l'insu de ce dernier. Pour permettre à son acheteur d'enregistrer des données carte au cours d'un paiement ou d'en utiliser d'autres déjà enregistrées il suffit au marchand de faire appel au web service doWebPayment en précisant une référence de portefeuille, alias, dans le paramètre buyer.walletID. La page de paiement Monext propose alors 1) l'utilisation de toutes les cartes du portefeuille compatibles avec le moyen de paiement choisi par l'acheteur ; 2) d'enregistrer les données carte saisie pour le paiement dans le portefeuille. Le marchand précise le type de sécurisation d'utilisation du portefeuille dans le paramètre walletSecured. Rappel DSP2 La DSP2 contraint le marchand à demander l'authentification de l'acheteur pour tout paiement effectué directement par l'acheteur, que les données cartes soient saisies directement par l'acheteur ou qu'il utilise des données stockées précédemment dans un portefeuille. Les émetteurs ne demandent plus la présence du CVV dans les paiements initiés à partir d'un portefeuille. Payline lie le portefeuille au marchand. Un portefeuille est de fait accessible à tous les points de vente du marchand. Le paiement peut être réalisé avec n'importe quel moyen de paiement actif et associé au portefeuille avec les services doWebPayment, doImmediateWalletPayment, doScheduledWalletPayment, doRecurrentWalletPayment et la gestion de portefeuille avec le manageWebWallet / getWallet. La création d'une carte dans un portefeuille est réalisée uniquement si la carte n'est pas déjà présente. Le critère d'unicité d'une carte est constitué du couple (PAN, date expiration).Comment créer un portefeuille
Les données du titulaire du wallet
Nom createWalletRequest.wallet.lastname Prénom createWalletRequest.wallet.firstname Email createWalletRequest.wallet.email adresse Les données d'adresse proviennent de createWalletRequest.wallet.shippingAddress Téléphone createWalletRequest.wallet.phone si le phoneType vaut Mobile createWalletRequest.wallet.phone si le phoneType vaut Comment ajouter une carte à un portefeuille existant
Cas d'utilisation Commentaires Enregistrer la carte au cours d'un paiement. 100 ou 101 Permet au porteur de payer ses futurs achats sans avoir à ressaisir son numéro de carte 108 Permet au porteur d'enregistrer sa carte en prévision de futurs achats. Mettre en place une autorisation de prélèvements 128 Mettre en place un paiement récurrent de montant fixe et de durée déterminée 122 ou 123 Permet, par exemple, de payer un abonnement à une revue pendant un an Mettre en place un paiement échelonné 124 ou 125 Permet de payer un bien en plusieurs fois Comment modifier une carte d'un portefeuille
Comment modifier les données porteur d'un wallet
Comment désactiver / réactiver un wallet
Comment utiliser un portefeuille
Comment gérer un portefeuille
Configuration de l'enregistrement de la carte dans un portefeuille au cours d'un paiement
Intégration du portefeuille par les pages de paiement Monext
Portée d'utilisation d'un portefeuille
Les exemples
Exemple d'enregistrement d'un paiement dans le portefeuille avec le doWebPayment en mode Widget | ||
| avec une carte | avec deux cartes | avec deux cartes |
|---|---|---|
|
|
|
Exemple de la gestion de portefeuille avec le manageWebWallet en mode Widget | |||
| Afficher des cartes | Afficher le Spinner ouvert | Validation de la suppression de carte | Collecte des données personnels du portefeuille (updatePersonalDetails=1) |
|---|---|---|---|
|
|
|
|
Pages associées