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.

  1. Le site de la MARQUE BLANCHE redirige l'utilisateur vers le WEBKIT de Lemon Way, avec en paramètre dans l'URL, le token de money-in.
  2. Le webkit effectue des vérifications puis redirige l'utilisateur sur la page d'acquisition CB.
  3. 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.
  4. 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 Lemon Way, 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.
Ne fonctionne que pour les contrats avec Atos.

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 :
-en (Anglais)
-no (Norvégien)
-sp (Espagnol)
-fr (Français)
-xz (Tchèque)
-ge (Allemand)
-it (Italien)
-br (Breton)
-da (Danois)
-fi (Finois)
-sw (Suédois)
-po (Portugais)
-fl (Flamand)
-ci (Chinois)
-pl (Polonais)
-ne (Néerlandais)
-ru (Russe)

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] carcustomtempate

Exemples

<?php
/*
$wkURL : URL du WEBKIT de LEMON WAY
$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 Lemon Way 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
Pour des raisons de sécurité, quel que soit le code de réponse retourné par le POST, il convient à la MARQUE BLANCHE d'appeler la méthode GetMoneyInTransDetails du DIRECTKIT afin de s'assurer du résultat du paiement.

POST de réponse :

Element

Description

Exemple

response_code

Code de réponse :

  • 0000 : succès
  • 3000 : erreur

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 Lemon Way 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