PW - Gestion des portefeuilles

Comment créer un Portefeuille

La fonction «createWebWallet» permet de créer un portefeuille virtuel pour votre client via l’interface web. Afin de valider l’utilisation du portefeuille, Payline réalise un contrôle monétique du moyen de paiement par une transaction d’autorisation à 1 euro qui ne sera pas validée (pas de paiement réel).

La création est rejetée dans les cas suivants :

• L’identifiant du portefeuille virtuel fourni n’est pas unique
• La date d’expiration de la carte est dépassée
• Le résultat du contrôle monétique de la carte de paiement est un refus
• Les informations obligatoires ne sont pas renseignées

Afin d’obtenir le résultat suite à un createWebWallet, vous devez exécuter la demande suivante  getWebWallet (cf. au guide d’intégration).

Comment utiliser un Portefeuille

Il est possible d’exécuter un paiement en utilisant un Portefeuille existant, ou de créer un Portefeuille au moment du paiement.

A l’aide d’un Portefeuille, 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 client n’aura pas à saisir ces données ou de créer un Portefeuille afin qu’il soit utiliser par la suite. (cf. au guide d’intégration)

Afin d’obtenir le résultat suite à un doWebPayment, vous devez exécuter la demande suivante  getWebPaymentDetails

Comment gérer son 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 ».

Intégration du portefeuille Payline

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 ( walletID unique par client, 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( WalletID, cardIndex, CVV ) pour réaliser une demande d'autorisation du montant de la commande.