Contenu
Sommaire | ||||
---|---|---|---|---|
|
Le paiement par wallet
La fonction « createWebWallet » permet 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 via l’interface web. Une fois votre client redirigé, il sera invité à saisir ses données bancaires pour informations de paiement pour créer son nouveau portefeuille virtuel ou le complèter. 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.
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.
Payline contrôle ces informations et enregistre le portefeuille électronique.
Diagramme draw.io | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Diagramme draw.io | ||||||||||||||||||||||
|
1ère étape Les étapes :
- Le
2ème étapes :
- Le SI Marchand contacte Payline via la fonction doImmediateWalletPayment pour réaliser une demande d’autorisation en précisant le walletID concerné.
- Payline réalise la transaction et donne sa réponse en temps réel à la fonction.
- 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 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.
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 |
Les websevices
Élément
Description
Requis
Type
Exemple
version
Version des web services Payline
oui
N2
A valoriser avec la dernière version : voir le tableau des versions.
Le code ou numéro de votre contrat VAD qui représente le moyen de paiement que vous souhaitez utiliser
buyer
Information sur l’acheteur
non
privateDataList
Information sur les informations personnelles
non
authentication3DSecure
Information sur les opérations 3DSecure
non
media
Détection du média utilisé lors du paiement.
Les valeurs possibles de cette balise sont :
- Computer
- Mobile
- Tablet
- TV
- Console
- Undefined
non
AN25
Mobile
Centre d'administration
Exemple de l'écran de gestion des portefeuilles :