Télécharger guide

Limonetik
Limonetik
Table des matières
1. Introduction
2. Moyens de paiement
2.1 Cado Carte
2.2 Chèque-Vacances
2.3 e-Chèque-Vacances
2.4 Facily Pay
2.5 Fivory
2.6 Illicado
2.7 Carte-cadeau LMT
2.8 Pacifica
2.9 SEQR
2.10 SlimPay
2.11 Spirit Of Cadeau
2.12 Ticket Premium
2.13 YesByCash
3. Activation et configuration
4. Intégration e-Commerce
4.1 Sélection du moyen de paiement
4.2 Paramètres d'entrée
5. Traitement des transactions
Page 1 of 16 - 27/01/2017
Limonetik
5.1 Autorisation et paiement
5.2 Gestion des transactions
5.3 Traitement via SlimPay
5.3.1 Signer le mandat
5.3.2 Les transactions périodiques
Page 2 of 16 - 27/01/2017
Limonetik
1. Introduction
Limonetik est un fournisseur de services de paiement français qui vous permet d'offrir différents Moyens de paiement.
Limonetik est pris en charge uniquement dans notre environnement e-Commerce. Le client est redirigé de la page de paiement de Ogone
vers la plate-forme Limonetik.
Il est recommandé de lire ce guide conjointement avec notre documentation Utilisez votre compte Ogone et e-Commerce.
Page 3 of 16 - 27/01/2017
Limonetik
2. Moyens de paiement
Grâce à Limonetik, Ogone offre davantage de moyens de paiement.
À l'heure actuelle, nous pouvons déjà proposer à vos clients les moyens de paiement suivants.
2.1 Cado Carte
Cado Carte (par Natixis) offre un mayen de paiement prépayé.
Les clients peuvent ajouter plusieurs cartes-cadeaux "Cado Carte" sur la page de paiement, et payer le montant restant avec leur carte de
crédit.
Autorisation et paiement: Paiement en 1 étape (débit)
www.cadocarte.com
Uniquement en France
2.2 Chèque-Vacances
Chèque-Vacances (par ANCV) est une initiative française proposant des chèques de voyage.
Le client règle des dépenses de voyage avec des chèques de voyage auprès de commerçants accrédités. Sur la page de paiement, le
client déclare les numéros des chèques papier et règle le solde avec sa carte de crédit. Une autorisation est effectuée sur la carte de crédit
pour garantir le montant payé avec Chèque-Vacances. Le client doit ensuite envoyer ses chèques papier par courrier postal. Les paiements
supplémentaires sont débités immédiatement.
Conditions d'intégration et particularités : La partie payée par Chèque-Vacances n'est pas remboursable. Le commerçant sera informé
par courriel qu'il doit trouver une autre solution pour rembourser ses clients.
Autorisation et paiement :
Paiement en 1 étape pour les règlements s'ajoutant à un paiement par Chèque-Vacances.
Paiement en 2 étapes en cas de doute sur la garantie de la carte de crédit ou au cas où les chèques papier n'arriveraient pas.
Uniquement en France
2.3 e-Chèque-Vacances
Version électronique de Chèque-Vacances / chèques de voyage (voir plus haut).
Le client saisit les identifiants de ses chèques électroniques sur la page de paiement et règle le solde avec sa carte de crédit. Les
paiements sont débités immédiatement.
Conditions d'intégration et particularités : La partie payée par e-Chèque-Vacances n'est pas remboursable. Le commerçant sera informé
par courriel qu'il doit trouver une autre solution pour rembourser ses clients.
Autorisation et paiement : Paiement en 1 étape (débit)
Uniquement en France
2.4 Facily Pay
Facily Pay (par Oney) offre une solution d'e-paiement par CB en 3x et 4x.
Caractéristiques spéciales : 4 options
3x par CB avec frais
Page 4 of 16 - 27/01/2017
Limonetik
3x par CB sans frais
4x par CB avec frais
4x par CB sans frais
Conditions d'intégration et particularités :
Informations obligatoires (voir Paramètres d'entrée) :
Données de facturation
Données de livraison
Données de la commande
Autorisation et paiement : Paiement en 3 étapes (attente + autorisation + débit)
www.oney-ecommerce.com
Uniquement en France
2.5 Fivory
Fivory (par Crédit Mutuel) offre un moyen de paiment "mobile wallet".
L'application Fivory est disponible pour iOS, Android et Windows Phone
Paiement mobile avec le code QR
Autorisation et paiement: Paiement en 1 étape (débit)
www.fivory.com
Uniquement en France
Conditions d'intégration et particularités:
Informations obligatoires: adresse e-mail via le paramètre "EMAIL"
2.6 Illicado
Illicado (par Illicado) offre un moyen de paiement prépayé.
Les clients peuvent ajouter plusieurs cartes-cadeaux "Illicado" sur la page de paiement, et payer le montant restant avec leur carte de
crédit.
Autorisation et paiement: Paiement en 1 étape (débit)
www.illicado.com
2.7 Carte-cadeau LMT
La carte-cadeau Limonetik se présente sous la forme d'un lien vers Limonetik pour une carte-cadeau personnalisée proposée et garantie par
Limonetik.
Idéalement, le commerçant doit présenter les méthodes de paiement sur sa page de paiement avant de rediriger l'acheteur vers la
plate-forme Ogone. Autrement, seul le logo générique de Limonetik sera affiché. Les clients peuvent ajouter plusieurs cartes-cadeaux
personnalisées sur la page de paiement et payer le solde avec une carte de crédit.
Conditions d'intégration et particularités : Multi-devise & multilingue
Autorisation et paiement : Paiement en 1 étape (débit)
Mondial
2.8 Pacifica
Pacifica (par Pacifica) offre un moyen de paiement prépayé.
Les clients peuvent ajouter plusieurs cartes-cadeaux "Pacifica" sur la page de paiement, et payer le montant restant avec leur carte de
crédit.
Autorisation et paiement: Paiement en 1 étape (débit)
carte.pacifica-e-reequipement.fr
En France et en Belgique
2.9 SEQR
Page 5 of 16 - 27/01/2017
Limonetik
SEQR (par Seamless) offre un "mobile e-wallet" (porte-monnaie électronique mobile).
Paiements mobiles avec le code QR
Autorisation et paiement: Paiement en 1 étape (débit)
Moyen de paiement non remboursable; le marchand sera avisé par courriel afin qu'il trouve une autre solution pour rembourser ses
clients.
Zone UE/SEPA
www.seqr.com
Conditions d'intégration et particularités :
Informations obligatoires (voir Paramètres d'entrée > Données de commande) : ITEMIDX, ITEMNAMEX, ITEMPRICEX,
ITEMVATCODEX, ITEMQUANTX
2.10 SlimPay
SlimPay offre une solution de débit direct SEPA, dotée des fonctionnalités suivantes :
Permet aux clients de signer des mandats électroniques
Est applicable dans la zone EU/SEPA
Pour plus d'informations sur SlimPay, consultez http://www.slimpay.net/
Conditions d'intégration et particularités :
Informations obligatoires (voir Paramètres d'entrée)
Données de facturation
Afin de traiter la signature, une transaction fictive de 0,01 EUR doit être effectuée. Ce montant n'est pas débité du compte du client, ni
crédité au compte du commerçant.
Pour que ce montant ne soit pas visible par le client, vous devez effectuer un appel direct (méthode de paiement).
Pour plus d'information sur ces conditions d'intégration, consultez Traitement de la transaction.
2.11 Spirit Of Cadeau
Spirit of Cadeau (par CCDS) offre un moyen de paiement prépayé.
Les clients peuvent ajouter plusieurs cartes-cadeaux "Spirit of Cadeau" sur la page de paiement, et payer le montant restant avec leur
carte de crédit.
Autorisation et paiement : Paiement en 1 étape (débit)
www.spiritofcadeau.com
Uniquement en France et Belgique
2.12 Ticket Premium
Ticket premium (par Ticket Surf International) offre un moyen de paiement prépayé, distribué en ligne et en kiosque.
Caractéristiques spéciales : Les clients peuvent ajouter plusieurs bons Ticket Premium sur la page de paiement
Conditions d'intégration et particularités : Moyen de paiement non remboursable
Autorisation et paiement : Paiement en 1 étape (débit)
www.ticket-premium.com
Vente en France
2.13 YesByCash
YesByCash (par Ticket Surf International) offre un moyen de paiement "cash" (en espèces).
Les clients commandent en ligne et paient en espèces directement dans le réseau de YBC (cafés, tabacs etc.)
Page 6 of 16 - 27/01/2017
Limonetik
Autorisation et paiement : Paiement en 3 étapes (attente + autorisation + débit)
Moyen de paiement non remboursable; la marchand sera avisé par courriel afin qu'il trouve une autre solution pour rembourser ses
clients.
www.tsi-payment.com/offres/yes-by-cash
Vente en France (en expansion)
Conditions d'intégration et particularités :
Informations obligatoires (voir Paramètres d'entrée) :
Données de facturation
Page 7 of 16 - 27/01/2017
Limonetik
3. Activation et configuration
Dès lors que vous avez signé un contrat pour un moyen de paiement, vous devez contacter notre service clientèle pour que nous puissions
nous occuper de la configuration et de l'activation du moyen de paiement.
Lorsque nous avons configuré et activé le moyen de paiement, il apparaît dans la section « WebBanking (Banque web) » des moyens de
paiement dans votre compte Ogone.
Pour effectuer les essais nécessaires (dans l'environnement de test ou de production), vous devez sélectionner l'option « End-to-end testing
(Test de bout en bout) » dans la fenêtre de configuration du moyen de paiement.
Dans l'environnement de test (pas en production !), si vous ne disposez pas de données d'authentification pour le moyen de paiement à
utiliser, vous pouvez utiliser le moyen de paiement générique SaCarte pour tester votre intégration à Limonetik.
Les données d'authentification à utiliser sont les suivantes :
Numéro SaCarte : [email protected]
Mot de passe : js@q!sKd2
Si vous dépassez 50 euros, s'il vous plaît utiliser également les détails suivants:
Numéro de carte : 4974934125497800
Date d'expiration : toute date située dans l'avenir
N° de vérification CVV : 600
Vérifiez les points suivants :
Votre paiement est validé et vous êtes redirigé vers la page de confirmation de votre site web.
La transaction est traitée correctement dans votre système.
La transaction est traitée dans votre compte test Ogone. Son statut doit être « Authorised (Autorisé) » et ses paramètres (numéro de
commande, montant, etc.) doivent être corrects.
Page 8 of 16 - 27/01/2017
Limonetik
4. Intégration e-Commerce
4.1 Sélection du moyen de paiement
Lorsque vous avez activé au moins un des moyens de paiement Limonetik dans votre compte Ogone, vous pouvez offrir ces moyens de
paiement à vos clients en sélection sur la page de paiement.
Cependant, si vous avez choisi d'offrir les moyens de paiement dans un écran de sélection sur votre propre site, de façon à ce que le
client soit redirigé directement vers la plate-forme correspondante, vous devez faire appel aux paramètres PM et BRAND.
Le tableau suivant présente les valeurs que vous pouvez envoyer avec les paramètres PM et BRAND:
Moyen de paiement
PM
BRAND
Cado Carte
CADOCARTE
CADOCARTE
Chèque-Vacances
ANCV
ANCV
e-Chèque-Vacances
eANCV
eANCV
FacilyPay 3x
FACILYPAY3X
FACILYPAY3X
FacilyPay 3x sans frais
FACILYPAY3XNF
FACILYPAY3XNF
FacilyPay 4x
FACILYPAY4X
FACILYPAY4X
FacilyPay 4x sans frais
FACILYPAY4XNF
FACILYPAY4XNF
Fivory
FIVORY
FIVORY
Illicado
ILLICADO
ILLICADO
LMT Giftcard
GIFTCARD
GIFTCARD
Pacifica
PACIFICA
PACIFICA
SEQR
SEQR
SEQR
SlimPay
SLIMPAY
SLIMPAY
Spirit of Cadeau
SPIRITOFCADEAU
SPIRITOFCADEAU
Ticket Premium
TICKETPREMIUM
TICKETPREMIUM
YesByCash
YESBYCASH
YESBYCASH
4.2 Paramètres d'entrée
Outre les paramètres e-Commerce par défaut (voir la documentation e-Commerce), vous pouvez ou devez envoyer pour chaque
commande les paramètres présentés dans le tableau ci-dessous, en fonction du moyen de paiement sélectionné.
Paramètre
Page 9 of 16 - 27/01/2017
Explication
Format (nbre max car.)
Exemple
Limonetik
Paramètre
Explication
Format (nbre max car.)
Exemple
Obligatoire pour tous les moyens de paiement
EMAIL
Adresse électronique du client
AN (50) - format d'adresse
électronique
[email protected]
Données de facturation (obligatoire pour FacilyPay/Oney, YesByCash and Slimpay)
AN (10) - car. ISO-8859-1
ECOM_BILLTO_POSTAL_
NAME_PREFIX
Civilité du client facturation
majuscules et minuscules, y
compris lettres accentuées,
M
espaces, points
AN (50) - car. ISO-8859-1
ECOM_BILLTO_COMPANY(*)
Société (raison sociale) du client
facturation
majuscules et minuscules, y
compris lettres accentuées,
Ma Société
espaces, barres obliques,
tirets, apostrophes
AN (35) - car. ISO-8859-1
ECOM_BILLTO_POSTAL_
NAME_LAST
majuscules et minuscules, y
Nom de famille du client facturation
compris lettres accentuées,
Jean
espaces, barres obliques,
tirets, apostrophes
AN (35) - car. ISO-8859-1
ECOM_BILLTO_POSTAL_
NAME_FIRST
majuscules et minuscules, y
Prénom du client facturation
compris lettres accentuées,
Dupont
espaces, barres obliques,
tirets, apostrophes
AN (10) - car. ISO-8859-1
majuscules et minuscules, y
ECOM_BILLTO_POSTAL_
Numéro de l'immeuble du client
compris lettres accentuées,
STREET_NUMBER
facturation
espaces, barres obliques,
14
tirets, apostrophes, points,
virgules
AN (35) - car. ISO-8859-1
ECOM_BILLTO_POSTAL_
STREET_LINE1
majuscules et minuscules, y
Rue du client facturation (ligne 1)
compris lettres accentuées,
espaces, barres obliques,
tirets, apostrophes, points,
Page 10 of 16 - 27/01/2017
Boulevard de
Rochechouart
Limonetik
Paramètre
Explication
Format (nbre max car.)
Exemple
virgules
AN (35) - car. ISO-8859-1
majuscules et minuscules, y
ECOM_BILLTO_POSTAL_
STREET_LINE2
Rue du client facturation (ligne 2)
compris lettres accentuées,
espaces, barres obliques,
Gate DEL
tirets, apostrophes, points,
virgules
ECOM_BILLTO_POSTAL_
Code postal du client facturation
POSTALCODE
AN (10) - [a-z A-Z 0-9]
espace, tiret
75008
AN (25) - car. ISO-8859-1
ECOM_BILLTO_POSTAL_
CITY
majuscules et minuscules, y
Ville du client facturation
compris lettres accentuées,
Paris
espaces, barres obliques,
tirets, apostrophes
ECOM_BILLTO_POSTAL_
Code du pays du client facturation
COUNTRYCODE
AN (2) - Code selon ISO
3166-1 alpha-2
FR
AN (20) - « + » suivi du code
ECOM_BILLTO_TELECOM_
Numéro de téléphone du client
international du pays et des
PHONE_NUMBER
facturation
chiffres du numéro, sans
+33175757574
espaces
AN (20) - « + » suivi du code
ECOM_BILLTO_TELECOM_
Numéro de portable du client
international du pays et des
MOBILE_NUMBER
facturation
chiffres du numéro, sans
+33696213222
espaces
Données de livraison (obligatoire uniquement pour FacilyPay/Oney)
AN (50) - car. ISO-8859-1
ECOM_SHIPTO_COMPANY
Société (raison sociale) du client
livraison
majuscules et minuscules, y
compris lettres accentuées,
espaces, barres obliques,
tirets, apostrophes
Page 11 of 16 - 27/01/2017
Ma Société
Limonetik
Paramètre
Explication
Format (nbre max car.)
Exemple
AN (10) - car. ISO-8859-1
ECOM_SHIPTO_POSTAL_
NAME_PREFIX
Civilité du client livraison
majuscules et minuscules, y
compris lettres accentuées,
M.
espaces, points
AN (35) - car. ISO-8859-1
ECOM_SHIPTO_POSTAL_
NAME_FIRST
majuscules et minuscules, y
Prénom du client livraison
compris lettres accentuées,
Ernest
espaces, barres obliques,
tirets, apostrophes
AN (35) - car. ISO-8859-1
ECOM_SHIPTO_POSTAL_
NAME_LAST
majuscules et minuscules, y
Nom de famille du client livraison
compris lettres accentuées,
Hemingway
espaces, barres obliques,
tirets, apostrophes
AN (10) - car. ISO-8859-1
majuscules et minuscules, y
ECOM_SHIPTO_POSTAL_
Numéro de l'immeuble du client
compris lettres accentuées,
STREET_NUMBER
livraison
espaces, barres obliques,
13
tirets, apostrophes, points,
virgules
AN (35) - car. ISO-8859-1
majuscules et minuscules, y
ECOM_SHIPTO_POSTAL_
STREET_LINE1
Rue du client livraison (ligne 1)
compris lettres accentuées,
espaces, barres obliques,
tirets, apostrophes, points,
Boulevard de
Rochechouart
virgules
AN (35) - car. ISO-8859-1
majuscules et minuscules, y
ECOM_SHIPTO_POSTAL_
STREET_LINE2
Rue du client livraison (ligne 2)
compris lettres accentuées,
espaces, barres obliques,
Gate Ship
tirets, apostrophes, points,
virgules
ECOM_SHIPTO_POSTAL_
POSTALCODE
ECOM_SHIPTO_POSTAL_
CITY
Page 12 of 16 - 27/01/2017
Code postal du client livraison
Ville du client livraison
AN (10) - [a-z A-Z 0-9]
espace, tiret
AN (25) - car. ISO-8859-1
majuscules et minuscules, y
75009
Paris
Limonetik
Paramètre
Explication
Format (nbre max car.)
Exemple
compris lettres accentuées,
espaces, barres obliques,
tirets, apostrophes
ECOM_SHIPTO_POSTAL_
Code du pays du client livraison
COUNTRYCODE
AN (2) - Code selon ISO
3166-1 alpha-2
FR
AN (20, sans espaces) ECOM_SHIPTO_TELECOM_
Numéro de téléphone du client
PHONE_NUMBER
livraison
« + » suivi du code
international du pays et des
+33175757575
chiffres du numéro, sans
espaces
AN (20, sans espaces) ECOM_SHIPTO_TELECOM_
Numéro de portable du client
MOBILE_NUMBER
livraison
« + » suivi du code
international du pays et des
+33696213221
chiffres du numéro, sans
espaces
Mode de livraison du client :
ECOM_SHIPMETHOD
StorePickup
NetworkPickup
TravelPickup
Carrier
EDelivery
Other
AN
Carrier
Texte libre (50) - car.
ECOM_
SHIPMETHODDETAILS
ISO-8859-1 majuscules et
Identification du point de collecte
minuscules, y compris lettres
COLISSIMO
accentuées, espaces, barres
obliques, tirets, apostrophes
aaaa-MM-jj - format UTC
défini selon ISO 8601. Le
format court, sans le suffixe
T (l'heure), est un format
ECOM_
ESTIMATEDDELIVERYDATE
Date de livraison estimée
acceptable pour la demande.
Dans ce cas, le serveur
Limonetik suppose minuit.
Cependant, la réponse
contiendra toujours le suffixe
T.
Page 13 of 16 - 27/01/2017
2013-06-11T16:32:11Z
Limonetik
* L’envoi des lignes d’article détaillées comportant un « 0 » renverra aux commandes refusées.
Page 14 of 16 - 27/01/2017
Limonetik
5. Traitement des transactions
5.1 Autorisation et paiement
Tous les moyens de paiement Limonetik prennent en charge les paiements à 2 étapes (autorisation + télécollecte) et à 1 étape (vente
directe).
Remarque pour FacilyPay et YesByCash
Avec FacilyPay et YesByCash, l'autorisation peut prendre quelques jours. Avant que le statut définitif soit connu, la transaction reste
au statut incertain 51. Ensuite, en fonction du résultat, le statut est mis à jour automatiquement à 5 (autorisé) ou 2 (refusé). Toutefois,
si vous avez sélectionné la vente directe comme code d'opération par défaut, une télécollecte suit le passage du statut de 51 à 5.
5.2 Gestion des transactions
Les transactions Limonetik peuvent faire l'objet de remboursements partiels ou complets.
Vous pouvez effectuer des opérations de gestion, telles que des remboursements, directement dans votre compte Ogone, via une demande
DirectLink et le chargement d'un fichier Batch.
Important
Limonetik demande que les marchands fassent un usage proactif de l'annulation plutôt que de l'expiration de l'autorisation parce que,
pour certains moyens de paiement, le montant autorisé est en réalité prélevé de la carte, puis remboursé lors de l'annulation ou de
l'expiration.
5.3 Traitement via SlimPay
5.3.1 Signer le mandat
Pour que le client puisse signer un mandat et pour traiter sa signature, une transaction fictive d'un montant de 0,01 EUR doit être exécutée.
Ce montant n'est pas débité du compte du client, ni crédité au compte du commerçant. Il est transféré de votre compte commerçant vers
Ogone et est utilisé comme paramètre fictif de Limonetik.
Pour que ce montant ne soit pas visible par le client sur la page de sélection de Ogone, vous devez effectuer un appel direct (méthode de
paiement).
En terme pratique, cela signifie que les valeurs PM et BRAND de SlimPay doivent être envoyées avec d'autres données à la plateforme
Ogone (voir Choix de la méthode de paiement). La plateforme peut ainsi rediriger directement le client vers SlimPay sans afficher le
montant de 0,01 EUR.
Page 15 of 16 - 27/01/2017
Limonetik
PM = Payment Method (méthode de paiement)
Fournisseur de service de paiement = Ogone
5.3.2 Les transactions périodiques
Il n'est actuellement pas possible de signer de mandat via notre plateforme Ogone. Tout mandat doit être signé directement via le
back-office de SlimPay.
Les transactions périodiques avec le mandat doivent être traitées directement via SlimPay :
en envoyant un fichier batch à SlimPay
manuellement au back-office de SlimPay
Pour plus d'informations sur cette procédure, contactez directement SlimPay (http://www.slimpay.net/en).
Page 16 of 16 - 27/01/2017