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 PostFinance vers la plate-forme Limonetik.

Il est recommandé de lire ce guide conjointement avec notre documentation Utilisez votre compte PostFinance et e-Commerce.

2. Moyens de paiement

Grâce à Limonetik, PostFinance offre davantage de moyens de paiement.

À l'heure actuelle, nous pouvons déjà proposer à vos clients les moyens de paiement suivants.

2.1 TWINT

TWINT (alimenté par PostFinance) est une solution de paiement mobile souple qui permet aux consommateurs de charger de l'argent sur un portefeuille électronique à partir de n'importe quel compte et de l'utiliser avec leur smartphone en boutique ou en ligne.

  • L'application TWINT est disponible sous iOS et Android
  • Paiement mobile en ligne par scan d'un code QR/numérique, paiement en boutique par beacon (balise)
  • Solution prépayée. Liez-la à un compte bancaire ou postal, souscrivez au recouvrement direct (LSV), utilisez un bulletin de versement e-banking ou chargez de l'argent via un distributeur automatique ou un code de transfert de crédit.
  • Autorisation et paiement : Paiement en 1 étape (débit)
  • www.twint.ch disponible uniquement en Suisse en en CHF
  • Exigences et spécificités d'intégration
  • Information obligatoire : adresse e-mail, via le paramètre "EMAIL"

3. Intégration e-Commerce

3.1 Sélection du moyen de paiement

Lorsque vous avez activé au moins un des moyens de paiement Limonetik dans votre compte PostFinance, 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
TWINT TWINT TWINT

3.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

Explication

Format (nbre max car.)

Exemple

Obligatoire pour tous les moyens de paiement

EMAIL

Adresse électronique du client

AN (50) - format d'adresse électronique

test@company.com

Données de facturation (obligatoire pour Banque Casino, Cetelem, Cofidis, FacilyPay/Oney, Slimpay and Sofinco et YesByCash)

ECOM_BILLTO_POSTAL_
NAME_PREFIX

Civilité du client facturation

AN (10) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, points

M

ECOM_BILLTO_COMPANY(*)

Société (raison sociale) du client facturation

AN (50) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Ma Société

ECOM_BILLTO_POSTAL_
NAME_LAST

Nom de famille du client facturation

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Jean

ECOM_BILLTO_POSTAL_
NAME_FIRST

Prénom du client facturation

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Dupont

ECOM_BILLTO_POSTAL_
STREET_NUMBER

Numéro de l'immeuble du client facturation

AN (10) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

14

ECOM_BILLTO_POSTAL_
STREET_LINE1

Rue du client facturation (ligne 1)

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

Boulevard de

Rochechouart

ECOM_BILLTO_POSTAL_
STREET_LINE2

Rue du client facturation (ligne 2)

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

Gate DEL

ECOM_BILLTO_POSTAL_

POSTALCODE

Code postal du client facturation

AN (10) - [a-z A-Z 0-9] espace, tiret

75008

ECOM_BILLTO_POSTAL_
CITY

Ville du client facturation

AN (25) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Paris

ECOM_BILLTO_POSTAL_

COUNTRYCODE

Code du pays du client facturation

AN (2) - Code selon ISO 3166-1 alpha-2

FR

ECOM_BILLTO_TELECOM_
PHONE_NUMBER

Numéro de téléphone du client facturation

AN (20) - « + » suivi du code international du pays et des chiffres du numéro, sans espaces

+33175757574

ECOM_BILLTO_TELECOM_
MOBILE_NUMBER

Numéro de portable du client facturation

AN (20) - « + » suivi du code international du pays et des chiffres du numéro, sans espaces

+33696213222

Données de livraison (obligatoire uniquement pour Cetelem et FacilyPay/Oney)

ECOM_SHIPTO_COMPANY

Société (raison sociale) du client livraison

AN (50) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Ma Société

ECOM_SHIPTO_POSTAL_
NAME_PREFIX

Civilité du client livraison

AN (10) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, points

M.

ECOM_SHIPTO_POSTAL_
NAME_FIRST

Prénom du client livraison

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Ernest

ECOM_SHIPTO_POSTAL_
NAME_LAST

Nom de famille du client livraison

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Hemingway

ECOM_SHIPTO_POSTAL_
STREET_NUMBER

Numéro de l'immeuble du client livraison

AN (10) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

13

ECOM_SHIPTO_POSTAL_
STREET_LINE1

Rue du client livraison (ligne 1)

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

Boulevard de

Rochechouart

ECOM_SHIPTO_POSTAL_
STREET_LINE2

Rue du client livraison (ligne 2)

AN (35) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

Gate Ship

ECOM_SHIPTO_POSTAL_
POSTALCODE

Code postal du client livraison

AN (10) - [a-z A-Z 0-9] espace, tiret

75009

ECOM_SHIPTO_POSTAL_
CITY

Ville du client livraison

AN (25) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

Paris

ECOM_SHIPTO_POSTAL_

COUNTRYCODE

Code du pays du client livraison

AN (2) - Code selon ISO 3166-1 alpha-2

FR

ECOM_SHIPTO_TELECOM_
PHONE_NUMBER

Numéro de téléphone du client livraison

AN (20, sans espaces) - « + » suivi du code international du pays et des chiffres du numéro, sans espaces

+33175757575

ECOM_SHIPTO_TELECOM_
MOBILE_NUMBER

Numéro de portable du client livraison

AN (20, sans espaces) - « + » suivi du code international du pays et des chiffres du numéro, sans espaces

+33696213221

ECOM_SHIPMETHOD

Mode de livraison du client :

  • StorePickup
  • NetworkPickup
  • TravelPickup
  • Carrier
  • EDelivery
  • Other

AN

Carrier

ECOM_
SHIPMETHODDETAILS

Identification du point de collecte

Texte libre (50) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes

COLISSIMO

ECOM_
ESTIMATEDDELIVERYDATE

Date de livraison estimée

aaaa-MM-jj - format UTC défini selon ISO 8601. Le format court, sans le suffixe T (l'heure), est un format acceptable pour la demande. Dans ce cas, le serveur Limonetik suppose minuit. Cependant, la réponse contiendra toujours le suffixe T.

2013-06-11T16:32:11Z

ECOM_SHIPMETHODSPEED

Nombre d'heures à compter pour la livraison

Nombre entier [0-9]

15

Données de commande (obligatoire uniquement pour FacilyPay/Oney et SEQR)

ITEMIDX

Identifiant de l'article

AN (15) - [a-z A-Z 0-9] tiret, souligné, barre oblique

HGY78765

ITEMNAMEX

Nom de l'article

AN (40) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, barres obliques, tirets, apostrophes, points, virgules

TinyBit

ITEMPRICEX

Prix de l'article

N - maximum 8 chiffres avant le signe décimal, 2 chiffres après

0.25

ITEMVATCODEX

Code TVA de l'article

percentage

25%

ITEMQUANTX

Quantité

N (4) [0-9] Nombre entier positif *

1

ITEMCATEGORYX

Catégorie de l'article :

  • ComputersAndSoftware
  • Electronics
  • Phones
  • Appliances
  • HomeAndGarden
  • Fashion
  • HealthAndBeauty
  • Jewellery
  • Sport
  • LeisureAndHobbies
  • CarsAndMotorbikes
  • Furniture
  • KidsAndBaby
  • VideoGamesAndConsoles
  • ToysAndGames
  • Pets
  • FoodAndDrink
  • GiftAndFlowers
  • Entertainment
  • Travel
  • AuctionsAndGroupBuying
  • ServicesForIndividuals
  • ServicesForProfessionals

AN (50)

Appliances

TAXINCLUDEDX

  • 1: Le prix ITEMPRICEX est considéré comme TVA incluse, et notre système ne calcule pas la TVA pour l'article.
  • 0 (ou paramètre non défini, ou non envoyé) : notre système calcule la TVA pour l'article sur la base du code TVA ITEMVATCODE.X
> Ce paramètre est vivement recommandé , car il évite les problèmes d'arrondi lors du calcul du montant total des postes.

0 / 1

1

Données optionnelles
AMOUNTTVA Montant de la TVA N (15) - montant x 100 ; pas de décimales 5
REF_CUSTOMERID Numéro de client AN (20) - [a-z A-Z 0-9] tiret, souligné, barre oblique 111222333

* L’envoi des lignes d’article détaillées comportant un « 0 » renverra aux commandes refusées.

4. Traitement des transactions

4.1 Autorisation et paiement

Remarque pour FacilyPay, Multibanco 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.

4.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 PostFinance, 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.

4.3 Traitement via SlimPay

4.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 PostFinance 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 PostFinance, 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 PostFinance (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.

Limonetik Slimpay flow

PM = Payment Method (méthode de paiement)
Fournisseur de service de paiement = PostFinance

4.3.2 Les transactions périodiques

Il n'est actuellement pas possible de signer de mandat via notre plateforme PostFinance. 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 (https://www.slimpay.com).

Questions fréquemment posées

Le délai d’activation des méthodes de paiement dépend des facteurs suivants :

  • Il faut généralement compter une semaine pour qu’un acquéreur ou une banque valide l’affiliation. Si vous êtes déjà affilié, l’activation ne prendra que quelques jours.
  • Certaines méthodes de paiement nécessitent des vérifications supplémentaires avant de pouvoir les activer. C’est le cas de 3-D Secure, qui est demandé directement auprès de VISA ou de MasterCard (et non de l’acquéreur).

Avec PostFinance Collect, vous pouvez activer plusieurs méthodes de paiement à la fois.