Arborescence des pages

Vous regardez une version antérieure (v. /display/DT/PW+-+Gestion+des+portefeuilles) de cette page.

afficher les différences afficher l'historique de la page

« Afficher la version précédente Vous regardez la version actuelle de cette page. (v. 36) afficher la version suivante »

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 avec le paramètre payment.action valorisé à 100/101, paiement,  ou 108, demande d'information
  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 avec le paramètre payment.action valorisé à 100/101, paiement,  ou 108, demande d'information
  2. de fournir dans le createWallet  la référence de wallet et l'identifiant de la transaction effectuée.


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 avec le paramètre payment.action valorisé à 100/101, paiement,  ou 108, demande d'information
  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.


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.

Intégration du portefeuille

La cinématique du paiement est la suivante :

  1. Le consommateur renseigne sa carte et coche la case à cocher " Enregistrer ma carte pour mes prochains paiements " et valide sa commande.
  2. Le SI Marchand contacte Payline via la fonction doWebPayment ( buyer.walletID unique par consommateur, cardIndex, CVV) pour réaliser une demande d'autorisation du montant de la commande.

Dès le second achat, la cinématique du paiement est la suivante :

  1. Le consommateur, qui a opté pour l'enregistrement de sa carte doit saisir son CVV pour valider l'utilisation de sa carte.
  2. Le SI Marchand contacte Payline via la fonction doImmediateWalletPayment ( buyer.walletID, cardIndex, CVV ) pour réaliser une demande d'autorisation du montant de la commande.


WalletSecured et 3DS

Payline facilite la création de portefeuille lors d'une demande de paiement en simplifiant le contrôle de la balise walletSecured. Il n'est plus nécessaire de la remplir et le CVV est toujours demandé.
Il n'est également plus nécessaire de remplir la balise walletSecured pour afficher le portefeuille. 

Pour réaliser des transactions 3DS avec un portefeuille, vous devez vérifier que votre contrat soit configuré et que la balise soit correctement renseigné : walletSecured dans vos appels web services.


Configuration du portefeuille

Le centre administration permet de configurer le point de vente et le contrat afin de permettre l'autorisation d'enregistrement de la carte et la collecte des données du portefeuille pour les services doWebPayment et manageWebWallet.


Wallet multi-point de vente et multi-contrat

Dans le mode d'intégration Widget, Payline propose de lier le portefeuille électronique au marchand au lieu du contrat et point de vente. Un consommateur pourra payer en 1 clic avec son portefeuille électronique quelque soit le point de vente et et le contrat utilisés pour enregistrer sa carte.

Le paiement pourra ê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 mise à jour d'une carte dans le portefeuille est réalisé si la carte n'existe pas : ce contrôle permet d'éviter l'intégration de carte dupliquée.

Ceci pour tous les nouveaux commerçants ou lors d'une migration en page web version 2 \ widget, Payline propose de migrer les contrats.


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)





  • Aucune étiquette