Contenu
Sommaire | ||||
---|---|---|---|---|
|
Le paiement par wallet
Le service doWebPayment permet d'accèder à un portefeuille virtuel existant à partir de son "WalletId" ou de créer un nouveau portefeuille virtuel, si le WalletID indiqué n'existe pas.
Le consommateur sera invité à saisir ses informations de paiement pour créer son nouveau portefeuille virtuel ou le complèter. Payline contrôle ces informations et enregistre le portefeuille électronique.
Diagramme draw.io | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Les étapes :
- Le consommateur valide son panier et le marchand prépare la page de paiement en appelant le service doWebPayment.
Il récupère le Token qu'il configure dans sa page, soit avec l'identifiant unique du consommateur (WalletId) pour afficher le portefeuille virtuel existant, soit avec les moyens de paiement et la possibilité de créer un nouveau portefeuille virtuel. - Le consommateur sélectionne son moyen de paiement et valide les informations de paiement.
- Payline réalise la demande d'autorisation à l'acquéreur pour les cartes bancaires et retourne la réponse sur la page.
- Sur le retour URL de Payline, le marchand vient récupérer le résultat du paiement via le service getWebPaymentDetails. Payline pourra notifier le commerçant afin de demander le résultat si cela n'a pas été fait.
Pour gérer le portefeuille, vous pouvez utiliser le service manageWebWallet pour gérer les cartes du portefeuille. Une fois le portefeuille affiché, le widget Payline permet :
- consulter le ou les moyens de paiements
La fonction « createWebWallet » permet d’initialiser la création d’un portefeuille virtuel via l’interface web. Une fois votre client redirigé, il sera invité à saisir ses données bancaires pour créer son portefeuille virtuel. Payline contrôle ces informations par une demande d’autorisation de débit pour un montant d’un euro seulement (la validation n’a pas lieu, donc aucune carte n’est crédité lors de la création) et enregistre le portefeuille de votre client avec l’identifiant (walletID) que vous avez fourni.
Il est nécessaire que le contrat VAD fournit par la banque, autorise le commerçant soit à pouvoir réaliser des paiements sans cryptogramme soit obtenir un contrat VAD autorisant d’effectuer des paiements récurrent.
Cette fonctionnalité permet la gestion des cartes du portefeuille. Une fois votre client redirigé, il lui sera possible de :- consulter la ou les cartes
enregistrées sur son portefeuille ;
-
Supprimer une carte enregistrée sur son portefeuille ;
-
ajouter autant de carte que souhaité dans son portefeuille ;
-
positionner comme moyen de paiement par défaut une carte de son portefeuille.
Diagramme draw.io | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Les web sevices
Le service utilisé est doWebPayment. Vous devez mettre en place la configuration de notification serveur.
Exemple de configuration :
Création d'un portefeuille électronique | |||
---|---|---|---|
doWebPaymentRequest | doWebPaymentResponse | ||
Eléments | Valeurs | Eléments | Valeurs |
version | 18 | result.code | 00000 |
selectedContractList | CBVADS | result.shortmessage | ACCEPTED |
walletId | Wallet123 | result.longmessage | Operation Successfull |
payment.amount | 1000 | token | 1gZKPUeSufwDtQkVo3071534757637648 |
payment.action | 101 | redirectURL | https://homologation-webpayment.payline.com/webpayment/step1.do?reqCode=prepareStep1&token=1gZKPUeSufwDtQkVo3071534757637648 |
payment.mode | CPT | ||
payment.contratNumber | VADCB | ||
buyer.customerid | 123456 | ||
order.ref | PHP123456 | ||
returnURL | https://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails | ||
cancelURL | https://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails |
Centre d'administration
Exemple de l'écran de gestion des portefeuilles :