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 Supprimer une carte enregistrée sur son portefeuille ;
- ajouter ajouter autant de carte que souhaité dans son portefeuille ;
- positionner positionner comme moyen de paiement par défaut une carte de son portefeuille.
| Diagramme draw.io | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
1ère étape :
- Le SI Marchand contacte Payline via la fonction createWallet pour initier une demande d’enregistrement de la carte. Le SI Marchand affecte à chaque client un identifiant unique qui représente le portefeuille virtuel.
- Payline enregistre les données cartes dans un portefeuille.
- Le SI Marchand récupère le résultat du paiement via la fonction getWebWallet. Il faut vérifier que le walletId est bien présent dans la réponse.
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.
3ème étapes :
- Payline notifie le SI Marchand lorsque la carte expire ou lorsqu’elle est mise en opposition.
- Payline fournit un service de gestion des cartes enregistrées dans un portefeuille via la fonction manageWebWallet.
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 :
