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

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

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

Le consommateur renseigne sa carte et coche la case à cocher " Enregistrer ma carte pour mes prochains paiements " et valide sa commande.
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 :

Le consommateur, qui a opté pour l'enregistrement de sa carte doit saisir son CVV pour valider l'utilisation de sa carte.
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.