Finalisation du crédit de wallet en mode indirect
Cette fonctionnalité permet de finaliser un crédit de wallet par carte bancaire, le crédit ayant été initialisé par la fonction moneyInWebInit du DIRECTKIT. Sauf demande de votre part dans votre contrat, le 3D-Secure sera utilisé.
La page de paiement est personnalisable, voir Personnalisation de page de paiement.
Cinématique
Pré-requis : la MARQUE BLANCHE a initialisé un rechargement via la méthode moneyInWebInit du DIRECTKIT. La MARQUE BLANCHE est alors en possession d'un token de money-in.
- Le site de la MARQUE BLANCHE redirige l'utilisateur vers le WEBKIT de Lemonway, avec en paramètre dans l'URL, le token de money-in.
- Le webkit effectue des vérifications puis redirige l'utilisateur sur la page d'acquisition CB.
- Sur la page de saisie de données carte :
- Si un contrat Payline est utilisé :
- Si la MARQUE BLANCHE a demandé l'utilisation de CB enregistrée, Payline propose à l'utilisateur d'utiliser une CB enregistrée, s'il en possède une.
- Si la MARQUE BLANCHE n'a pas demandé l'utilisation de CB enregistrée ou si l'utilisateur n'en a pas encore enregistré, l'utilisateur saisit ses données CB, et procède à une vérification 3D Secure si sa banque le permet.
- Si un contrat Atos est utilisé : l'utilisateur saisit ses données CB, et procède à une vérification 3D Secure si sa banque le permet.
- Si un contrat Payline est utilisé :
- La transaction de money-in est enregistrée et l'utilisateur est redirigé vers le site de la MARQUE BLANCHE.
Requête
La requête est envoyée au WEBKIT de Lemonway, avec en paramètre dans l'URL les informations suivantes :
Variable | Description | Requis | Format | Exemple |
---|---|---|---|---|
moneyInToken | Token de money-in reçu par la MARQUE BLANCHE en sortie de moneyInWebInit du DIRECTKIT | Oui | [1:256] car | 62612109COhhmoY3kOBhf9O7op8g1m8NE |
p | URL du CSS de personnalisation de la page de paiement. | Non | https%3A%2F%2Fwww.lemonway.fr%2Fmercanet_lw.css | |
lang | Code ISO2 de la langue de la page de paiement. Liste non exhaustive des codes acceptés : Ne fonctionne que pour les contrats avec Atos, Atos v2, Monetico, Payzen. | Non | [2] car | en |
tpl | Indiquer le nom du template à utiliser sur la page de paiement Ne fonctionne que pour les contrats avec Atos v2. | Non | [1:256] car | customtempate |
Exemples
<?php /* $wkURL : URL du WEBKIT de LEMONWAY $moneyInToken : Token récupéré via le DIRECTKIT $p : URL du CSS de personnalisation, URL encoded $lang : Langue à utiliser pour l'affichage de la page */ header('Location: '.$wkURL.'?moneyInToken='.$moneyInToken.'&p='.$p.'&lang='.$lang); ?>
Retour
L'URL de retour (réussite, échec, annulation selon le résultat de l'opération) de la MARQUE BLANCHE reçoit 2 retours différents :
- Lorsque le CLIENT termine son paiement ou lorsque le paiement est abandonné, une notification (callback) est envoyée depuis le serveur de Lemonway sur l'URL de la MARQUE BLANCHE, avec des données en paramètre POST.
- Lorsque le CLIENT termine son opération, il est redirigé vers l'URL de la MARQUE BLANCHE avec des données en paramètres GET
POST de réponse :
Element | Description | Exemple |
---|---|---|
response_code | Code de réponse :
| 0000 |
response_wkToken | wkToken envoyé par la MARQUE BLANCHE en entrée de l'initialisation du moneyIn | rhjzekdzejkd |
response_msg | Commentaire sur le code de retour | |
response_transactionId | Référence Lemonway de la transaction | 755 |
response_transactionAmount | Montant de la transaction | 34.00 |
response_transactionMessage | Commentaire de la transaction | pizza |
response_code | Description |
---|---|
2001 | Commande non reconnue |
2002 | Opération annulée par l'utilisateur |
2003 | Echec d'authentification sur le webkit |
2004 | Requête mal formée |
3000 | Erreur provenant du serveur |
4000 | Erreur inconnue |
GET de réponse :
Element | Description | Exemple |
---|---|---|
response_wkToken | wkToken envoyé par la MARQUE BLANCHE en entrée de l'initialisation du moneyIn | rhjzekdzejkd |