Contenu



Comment créer un portefeuille

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 

  1. d'utiliser le service doWebPayment
  2. de fournir dans le createWallet  la référence de wallet et l'identifiant de la transaction effectuée.


Les données du titulaire du wallet

La provenance des données du titulaire du wallet est donnée par le tableau suivant:

NomcreateWalletRequest.wallet.lastname
PrénomcreateWalletRequest.wallet.firstname
EmailcreateWalletRequest.wallet.email
adresseLes données d'adresse proviennent de createWalletRequest.wallet.shippingAddress
TéléphonecreateWalletRequest.wallet.phone si le phoneType vaut
MobilecreateWalletRequest.wallet.phone si le phoneType vaut


Comment ajouter une carte à un portefeuille existant

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 

  1. d'utiliser le service doWebPayment ;
  2. de fournir dans le createWallet  la référence de wallet et l'identifiant de la transaction effectuée.

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

Cas d'utilisation

valeur du paramètre payment.action

dans le doWebPayment

Commentaires
Enregistrer la carte au cours d'un paiement.100 ou 101Permet au porteur de payer ses futurs achats sans avoir à ressaisir son numéro de carte

Enregistrer la carte en dehors de tout paiement

pour de futurs achats sur le site

108Permet au porteur d'enregistrer sa carte en prévision de futurs achats.
Mettre en place une autorisation de prélèvements128

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...

Mettre en place un paiement récurrent de montant fixe et de durée déterminée122 ou 123Permet, par exemple, de payer un abonnement à une revue pendant un an
Mettre en place un paiement échelonné124 ou 125Permet de payer un bien en plusieurs fois


Comment modifier une carte d'un portefeuille

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 

  1. d'utiliser le service doWebPayment ;
  2. de fournir dans le updateWallet  la référence de wallet, l'index de carte dans le portefeuille et l'identifiant de la transaction effectuée.


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.

Comment modifier les données porteur d'un wallet

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.


Comment désactiver / réactiver un wallet

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.


Comment utiliser un portefeuille

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 :

  • un paiement comptant, ou différé ;
  • un paiement récurrent ;
  • un paiement à échéance.

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.

Comment gérer un portefeuille

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.

Configuration de l'enregistrement de la carte dans un portefeuille au cours d'un paiement

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 :

  1. systématiquement ;
  2. en utilisant une case à cocher vide par défaut ;
  3. en utilisant une case à cocher pré-remplié par défaut.

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.

Intégration du portefeuille par les pages de paiement Monext


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.


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.


Portée d'utilisation 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).




Les exemples



Exemple d'enregistrement d'un paiement dans le portefeuille avec le doWebPayment en mode Widget

avec une carteavec deux cartesavec deux cartes






Exemple de la gestion de portefeuille avec le manageWebWallet en mode Widget

Afficher des cartesAfficher le Spinner ouvertValidation de la suppression de carte

Collecte des données personnels

du portefeuille

(updatePersonalDetails=1)




Exemple de la gestion de portefeuille avec le manageWebWallet en mode Widget






Pages associées