Thunes
1. Introduction
Thunes est un fournisseur de services de paiement français qui vous permet d'offrir différents Moyens de paiement.
Thunes 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 Thunes
.
Il est recommandé de lire ce guide conjointement avec notre documentation Utilisez votre compte PostFinance et e-Commerce.
2. Moyens de paiement
Grâce à Thunes, 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 Thunes 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 |
|||
|
|
Adresse électronique du client |
AN (50) - format d'adresse électronique |
test@company.com |
|
Données de facturation (obligatoire pour Floa Pay, Cetelem, Cofidis, FacilyPay/Oney, Slimpay and Sofinco et YesByCash) |
|||
|
ECOM_BILLTO_POSTAL_ |
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_ |
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_ |
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_ |
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_ |
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_ |
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_ |
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_ |
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_ |
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_ |
Civilité du client livraison |
AN (10) - car. ISO-8859-1 majuscules et minuscules, y compris lettres accentuées, espaces, points |
M. |
|
ECOM_SHIPTO_POSTAL_ |
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_ |
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_ |
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_ |
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_ |
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_ |
Code postal du client livraison |
AN (10) - [a-z A-Z 0-9] espace, tiret |
75009 |
|
ECOM_SHIPTO_POSTAL_ |
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_ |
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_ |
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 :
|
AN |
Carrier |
|
ECOM_ |
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_ |
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 Thunes 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 :
|
AN (50) |
Appliances |
|
TAXINCLUDEDX |
|
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 Thunes 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 Thunes 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 Thunes.
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.
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.