Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

LEMON WAY KIT d’INTERFACE TECHNIQUE Pour Webmaster eCommerce Applications mobil

LEMON WAY KIT d’INTERFACE TECHNIQUE Pour Webmaster eCommerce Applications mobiles Wallets pour cagnottes Marque blanche Publication Statut Validé Diffusion Marques Blanches Lemon Way Version 5.5 Référence LW - Kit Marque Blanche - Guide Intégration Lemon Way SAS - Kit Marchand - Guide d’intégration page 2/95 Liste de diffusion Société Destinataire Lemon Way Sébastien Burlet – CEO Lemon Way Lydie Zhu – Directrice des Systèmes d’Information Lemon Way Hicham Sadiki – Chef de projet Historique des versions Version Date Résumé des modifications 1.0 Lydie Zhu 11/08/2011 Création 1.1 Lydie Zhu 03/10/2011 Simplification création de compte 1.2 Lydie Zhu 28/10/2011 Ajout détails du kit 1.3 Lydie Zhu 02/11/2011 Modification processus webkit 1.4 Lydie Zhu 04/11/2011 Modification processus webkit 1.5 Lydie Zhu 08/11/2011 Finalisation processus de paiement direct 1.6 Lydie Zhu 09/07/2012 Finalisation : -DirectKit avec inscription, demande et vérification d’enrollement -Webkit standardisée, avec paiement et enregistrement de carte bancaire 1.7 Lydie Zhu 11/07/2012 Modification processus webkit 1.8 Lydie Zhu 10/09/2012 Mise à jour du directkit avec paiement 1.9 Gregory Jaen 24/09/2012 Ajout BackOffice Pro 2.0 Lydie Zhu 01/10/2012 Modification du Direct Kit avec l’ajout du check de code PDV 2.1 S.Burlet, CEO 02/10/2012 Validation complète. 2.2 G.Jaen 03/10/12 Ajout capture écran IPAD, ajout section clé marchand 2.3 S.Burlet 03/10/02 Validation. 2.4 G.Jaen 10/12/12 Mise à jour section backoffice pro 2.5 S.Burlet 04/01/2013 Liens espace marchand professionnel Explications du paiement mobile en magasin et à distance 2.6 S.Burlet 17/01/2013 Module de paiement pour PRESTASHOP 2.7 S.Burlet 30/01/2013 Paiement par Carte Bancaire pour les sites de eCommerce, les sites de cadeau commun, etc. 2.8 L. Zhu 01/02/2013 Ajout en marque blanche des méthodes directkit suivantes : enregistrement et désactivation de carte bancaire, money-in, recherche des détails d’un paiement Lemon Way SAS - Kit Marchand - Guide d’intégration page 3/95 2.9 L. Zhu 11/02/2013 Ajout de méthodes dans la partie marque blanche 3.0 L.Zhu 18/02/2013 Ajouts de méthodes pour la partie marque blanche : ajout d’IBAN, récupération des détails d’un wallet, maj des erreurs et sorties 3.1 L.Zhu 11/03/2013 Marque Blanche : Corrections mineures et ajout de la méthode webservice moneyInWebInit : une méthode d’initialisation d’acquisition carte web 3.2 L.Zhu 07/05/2013 Marque blanche uniquement RegisterIBAN v1.1 3.3 L.Zhu 21/06/2013 GetMoneyInTransDetails v1.2 3.4 L. Zhu 01/07/2013 FastPay : nouvelle méthode de paiement rapide qui inclut création de wallet, acquisition carte et paiement 3.5 H.Sadiki/L. Zhu 02/07/2013 UploadFile : Methode d’upload de KYC pour les clients 3.6 H.Sadiki/L. Zhu 15/07/2013 - Précisions UploadFile - Ajout de précisions sur le format général des requêtes - GetKycStatus : Méthode de récupération des modifications de status - GetMoneyInIBANDetails: Méthode de récupération des moneyIn par virement. - Refund MoneyIn : remboursement d’une acquisition carte 3.7 H.Sadiki/L. Zhu 22/07/2013 -GetBalances : Récupère l’ensemble des soldes des wallets depuis une date UTC. 3.8 L.Zhu 22/08/2013 FastPay v 1.1 3.9 L. Zhu 27/08/2013 -Fix erreur de documentation MoneyOut 4.0 L. Zhu 28/08/2013 -FastPay v1.2 : possibilité de sauvegarder la carte bancaire 4.1 H.Sadiki 18/09/2013 -GetWalletDetails : Ajout en sortie des statuts de documents et IBAN 4.2 S.Burlet 24/09/2013 Relecture générale, revue des définitions, ajout d’informations concernant le paiement 3D Secure, explication des fonctions de virement externe, de paiement entre wallets, de paiement direct avec la méthode FastPay, informations concernant les IBAN, informations concernant la responsabilité du client en termes de KYC, informations concernant le « Rebill » et les risques liés au changement de descripteur et cas de tokénisation de carte bancaire, information concernant les coûts de virements externes SEPA en monnaie non EUR. Ajout de Wonderstars (LAB FT) et de l’existence d’un BackOffice de gestion. 4.3 L.Zhu 26/09/2013 GetMoneyInTransDetails v1.3 4.4 H.Sadiki 04/10/2013 -GetWalletDetails : Ajout du type de document pour version 1.2 4.5 L. Zhu 17/10/2013 -RefundMoneyIn 1.1 : remboursement partiel de paiement par carte -MoneyIn3DSInit et MoneyIn3DSConfirm : acquisition carte en 3DS direct, sans formulaire carte -GetWalletDetails 1.3: Ajout des données des IBANs 4.6 H. Sadiki 21/10/2013 GetKycStatus 1.1 4.7 L. Zhu 31/10/2013 Ajout d’informations sur les différents comptes d’accès aux APIs 4.8 L. Zhu 31/10/2013 -UpdateWalletDetails 4.9 L. Zhu 26/12/2013 RegisterWallet et UpdateWalletDetails : ajout de numéro de téléphone de contact en entrée 5.0 H. Sadiki / L. Zhu 08/01/2014 -autoCommission sur toutes les méthodes de moneyIn -RefundMoneyIn : ajout de note informative et cas d’erreur GetKycStatus 1.2 5.1 L. Zhu 29/01/2014 RefundMoneyIn 1.2 : correction des données en sortie 5.2 L. Zhu 27/02/2014 -MoneyIn3DInit 1.1 : par Atos -Revue générale pour distinguer les fonctionnement par Atos ou Payline -Précision sur la gestion des commissions 5.3 L.Zhu 05/03/2014 MoneyInValidate : validation d’un money-in pré-autorisé Lemon Way SAS - Kit Marchand - Guide d’intégration page 4/95 5.4 H. Sadiki 04/04/2014 MoneyIn3DAuthenticate CreateAmazonGift 5.5 L. Zhu 15/04/2014 Précision sur la personnalisation des pages de paiement Lemon Way SAS - Kit Marchand - Guide d’intégration page 5/95 SOMMAIRE 1. INTRODUCTION ................................................................................................................. 8 1.1 A propos de ce document............................................................................................. 8 1.2 Définitions .................................................................................................................... 8 1.3 Prérequis ...................................................................................................................... 9 1.3.1 Comptes d’accès à l’API ...................................................................................................................... 9 1.3.2 Wallet de la MARQUE BLANCHE ...................................................................................................... 10 1.4 Gestion des commissions .......................................................................................... 10 1.5 Mode différé (par Atos uniquement) ........................................................................... 11 1.6 Support ...................................................................................................................... 11 1.7 Outil de gestion et de surveillance du CA et des paiements sur Internet .................... 11 1.8 Lutte contre la fraude et le blanchiment d’argent (LAB-FT)......................................... 11 2. DIRECTKIT ....................................................................................................................... 12 2.1 Généralités ................................................................................................................. 12 2.1.1 Requêtes ............................................................................................................................................ 12 2.1.2 Réponses ........................................................................................................................................... 13 2.1.3 Erreurs ............................................................................................................................................... 13 2.2 FastPay : Paiement rapide sans besoin de gestion de wallet ..................................... 14 2.2.1 Cinématique ....................................................................................................................................... 15 2.2.2 Requête.............................................................................................................................................. 15 2.2.3 Réponse ............................................................................................................................................. 20 2.2.4 Cas d’erreur ....................................................................................................................................... 22 2.3 RegisterWallet: Création de wallet .............................................................................. 22 2.3.1 Cinématique ....................................................................................................................................... 22 2.3.2 Requête.............................................................................................................................................. 22 2.3.3 Réponse ............................................................................................................................................. 24 2.3.4 Cas d’erreur ....................................................................................................................................... 24 2.4 UpdateWalletDetails: Mise à jour d’informations de wallet .......................................... 24 2.4.1 Cinématique ....................................................................................................................................... 24 2.4.2 Requête.............................................................................................................................................. 25 2.4.3 Réponse ............................................................................................................................................. 26 2.4.4 Cas d’erreur ....................................................................................................................................... 26 2.5 GetWalletDetails : Détails d’un wallet ......................................................................... 26 2.5.1 Cinématique ....................................................................................................................................... 27 2.5.2 Requête.............................................................................................................................................. 27 2.5.3 Réponse ............................................................................................................................................. 27 2.5.4 Cas d’erreur ....................................................................................................................................... 33 2.6 MoneyIn : Crédit de wallet avec carte bancaire, sans 3D-Secure ............................... 33 2.6.1 Cinématique ....................................................................................................................................... 33 2.6.2 Requête.............................................................................................................................................. 34 2.6.3 Réponse ............................................................................................................................................. 35 2.6.4 Cas d’erreur ....................................................................................................................................... 36 2.7 MoneyIn3DInit : Initialisation du crédit de wallet par CB 3D-Secure, en mode direct .. 36 2.7.1 Cinématique ....................................................................................................................................... 36 2.7.2 Requête.............................................................................................................................................. 36 2.7.3 Réponse ............................................................................................................................................. 38 2.8 MoneyIn3DConfirm : Finalisation du crédit de wallet par 3DSecure, en mode direct .. 40 2.8.1 Cinématique ....................................................................................................................................... 40 2.8.2 Requête.............................................................................................................................................. 40 2.8.3 Réponse ............................................................................................................................................. 42 2.8.4 Cas d’erreur ....................................................................................................................................... 42 2.9 MoneyInWebInit : Initialisation crédit de wallet par carte, en mode indirect ................ 43 2.9.1 Cinématique ....................................................................................................................................... 43 2.9.2 Requête.............................................................................................................................................. 43 2.9.3 Réponse ............................................................................................................................................. 45 Lemon Way SAS - Kit Marchand - Guide d’intégration page 6/95 2.9.4 Cas d’erreur ....................................................................................................................................... 45 2.10 RegisterCard : Enregistrement de carte bancaire ....................................................... 45 2.10.1 Cinématique ....................................................................................................................................... 46 2.10.2 Requête.............................................................................................................................................. 46 2.10.3 Réponse ............................................................................................................................................. 47 2.10.4 Cas d’erreur ....................................................................................................................................... 47 2.11 UnregisterCard : Suppression de carte bancaire ........................................................ 47 2.11.1 Cinématique ....................................................................................................................................... 47 2.11.2 Requête.............................................................................................................................................. 47 2.11.3 Réponse ............................................................................................................................................. 48 2.11.4 Cas d’erreur ....................................................................................................................................... 48 2.12 MoneyInWithCardId : Crédit de wallet avec carte bancaire pré-enregistrée ................ 48 2.12.1 Cinématique ....................................................................................................................................... 48 2.12.2 Requête.............................................................................................................................................. 49 2.12.3 Réponse ............................................................................................................................................. 50 2.12.4 Cas d’erreur ....................................................................................................................................... 50 2.13 MoneyInValidate : validation d’un moneyIn ................................................................ 51 2.13.1 Cinématique ....................................................................................................................................... 51 2.13.2 Requête.............................................................................................................................................. 51 2.13.3 Réponse ............................................................................................................................................. 51 2.13.4 Cas d’erreur ....................................................................................................................................... 52 2.14 SendPayment : Paiement entre wallets ...................................................................... 52 2.14.1 Cinématique ....................................................................................................................................... 52 2.14.2 Requête.............................................................................................................................................. 53 2.14.3 Réponse ............................................................................................................................................. 53 2.14.4 Cas d’erreur ....................................................................................................................................... 54 2.15 RegisterIBAN : Enregistrement d’IBAN ...................................................................... 54 2.15.1 Cinématique ....................................................................................................................................... 54 2.15.2 Requête.............................................................................................................................................. 55 2.15.3 Réponse ............................................................................................................................................. 55 2.15.4 Cas d’erreur ....................................................................................................................................... 56 2.16 MoneyOut : Virement externe ..................................................................................... 56 2.16.1 Cinématique ....................................................................................................................................... 56 2.16.2 Requête.............................................................................................................................................. 56 2.16.3 Réponse ............................................................................................................................................. 59 2.16.4 Cas d’erreur ....................................................................................................................................... 60 2.17 GetPaymentDetails : Rechercher un paiement ........................................................... 60 2.17.1 Cinématique ....................................................................................................................................... 61 2.17.2 Requête.............................................................................................................................................. 61 2.17.3 Réponse ............................................................................................................................................. 61 2.17.4 Cas d’erreur ....................................................................................................................................... 62 2.18 GetMoneyInTransDetails : Rechercher un money-in .................................................. 63 2.18.1 Cinématique ....................................................................................................................................... 63 2.18.2 Requête.............................................................................................................................................. 63 2.18.3 Réponse ............................................................................................................................................. 64 2.18.4 Cas d’erreur ....................................................................................................................................... 68 2.19 GetMoneyOutTransDetails : Rechercher un money-out ............................................. 68 2.19.1 Cinématique ....................................................................................................................................... 68 2.19.2 Requête.............................................................................................................................................. 68 2.19.3 Réponse ............................................................................................................................................. 69 2.19.4 Cas d’erreur ....................................................................................................................................... 70 2.20 UploadFile : Upload d’un justificatif ............................................................................. 70 2.20.1 Cinématique ....................................................................................................................................... 70 2.20.2 Requête.............................................................................................................................................. 70 2.20.3 Réponse ............................................................................................................................................. 71 2.20.4 Cas d’erreur ....................................................................................................................................... 71 2.21 GetKycStatus: Recherche d’utilisateurs, documents et IBAN modifié depuis une date72 2.21.1 Cinématique ....................................................................................................................................... 72 2.21.2 Requête.............................................................................................................................................. 72 2.21.3 Réponse ............................................................................................................................................. 72 Lemon Way SAS - Kit Marchand - Guide d’intégration page 7/95 2.21.4 Cas d’erreur ....................................................................................................................................... 76 2.22 GetMoneyInIBANDetails: Recherche de moneyIn par virement depuis une date ....... 76 2.22.1 Cinématique ....................................................................................................................................... 76 2.22.2 Requête.............................................................................................................................................. 76 2.22.3 Réponse ............................................................................................................................................. 76 2.22.4 Cas d’erreur ....................................................................................................................................... 78 2.23 RefundMoneyIn : remboursement carte ..................................................................... 78 2.23.1 Cinématique ....................................................................................................................................... 78 2.23.2 Requête.............................................................................................................................................. 78 2.23.3 Réponse ............................................................................................................................................. 80 2.23.4 Cas d’erreur ....................................................................................................................................... 81 2.24 GetBalances : Récupérations de l’ensemble des soldes ............................................ 81 2.24.1 Cinématique ....................................................................................................................................... 81 2.24.2 Requête.............................................................................................................................................. 82 2.24.3 Réponse uploads/Geographie/ lemonway-5-5.pdf