Prestataires TPE : comment proposer l'acceptation des cartes Swile à vos clients ?

En français 🇫🇷

Ce guide vous explique comment générer vos clés de sécurité et configurer votre logiciel pour accéder à notre serveur d'échange de fichiers sécurisé (SFTP).

Pré-requis

Pour vous connecter, nous n'utilisons pas de mot de passe, mais une paire de clés SSH (une clé publique que vous nous donnez, et une clé privée que vous gardez).

Étape 1 : Générer votre paire de clés SSH

🍎 Sur macOS / Linux

1. Ouvrez l'application Terminal.

2. Copiez-collez la commande suivante et appuyez sur Entrée :

   ssh-keygen -t rsa -b 4096 -C "votre-email@partenaire.com"
   

3. Le terminal vous demandera où enregistrer la clé. Appuyez sur Entrée pour valider l'emplacement par défaut.
4. Il vous demandera une "passphrase" (mot de passe). Vous pouvez appuyer sur Entrée deux fois pour ne pas en mettre (plus simple pour l'automatisation), ou en mettre une pour plus de sécurité.

Vos clés sont créées dans le dossier caché /Users/votre_nom/.ssh/ :

• id_rsa : C'est votre CLÉ PRIVÉE. (Ne la donnez jamais à personne).
• id_rsa.pub : C'est votre CLÉ PUBLIQUE.

🪟 Sur Windows (10 et 11)

1. Ouvrez le menu Démarrer et tapez PowerShell.

2. Copiez-collez la commande suivante et appuyez sur Entrée :

   ssh-keygen -t rsa -b 4096
   

3. Appuyez sur Entrée à chaque question pour valider les choix par défaut.

Vos clés sont créées dans le dossier C:\\\\Utilisateurs\\\\VotreNom\\\\.ssh\\\\ :

• id_rsa : C'est votre CLÉ PRIVÉE.
• id_rsa.pub : C'est votre CLÉ PUBLIQUE.

Étape 2 : Nous envoyer votre Clé Publique

1. Allez dans le dossier où les clés ont été créées.
2. Prenez le fichier terminant par .pub (ex: id_rsa.pub).
3. Envoyez-nous ce fichier par email.

⚠️ IMPORTANT : Ne nous envoyez jamais le fichier qui n'a pas d'extension (votre clé privée). Gardez-le précieusement, c'est votre "passeport" pour entrer.

Étape 3 : Se connecter avec FileZilla

Nous vous recommandons le logiciel gratuit FileZilla Client, mais n'importe quel client compatible SFTP fonctionne (WinSCP, Cyberduck, Transmit).

1. Téléchargez et installez FileZilla Client.
2. Ouvrez FileZilla et allez dans Fichier > Gestionnaire de Sites (ou l'icône tout en haut à gauche).
3. Cliquez sur Nouveau Site et nommez-le (ex: "Echange SFTP").
4. Configurez l'onglet Général comme suit :

Note : Si FileZilla vous demande de convertir la clé dans un autre format, cliquez sur "Oui".

1. Cliquez sur Connexion.

FAQ / Dépannage

Je ne vois pas mes clés dans le dossier .ssh Les dossiers commençant par un point sont souvent cachés.

• Sur Mac : Dans le Finder, faites Cmd + Shift + . pour afficher les fichiers cachés.
• Sur Windows : Dans l'explorateur, onglet "Affichage", cochez "Éléments masqués".

Erreur "Permission denied (publickey)" Cela signifie généralement que :

• Vous n'utilisez pas la bonne clé privée.
• Nous n'avons pas encore activé votre accès avec la clé publique que vous nous avez envoyée.
• L'identifiant utilisateur est incorrect.

Puis-je utiliser la même clé sur plusieurs ordinateurs ? Oui. Vous pouvez copier votre fichier de clé privée (id_rsa) sur un autre ordinateur ou un serveur pour automatiser les envois.

En anglais 🇬🇧

This guide explains how to generate your security keys and configure your software to access our secure file exchange server (SFTP).

Prerequisites

To connect, we do not use passwords, but an SSH key pair (a public key that you provide to us, and a private key that you keep).

Step 1: Generate your SSH key pair

🍎 On macOS / Linux

1. Open the Terminal application.

2. Copy and paste the following command and press Enter:

   ssh-keygen -t rsa -b 4096 -C "your-email@partner.com"
   

3. The terminal will ask where to save the key. Press Enter to accept the default location.
4. It will ask for a "passphrase" (password). You can press Enter twice to leave it empty (simpler for automation), or enter one for extra security.

Your keys are created in the hidden folder /Users/your_username/.ssh/:

• id_rsa: This is your PRIVATE KEY. (Never share it with anyone).
• id_rsa.pub: This is your PUBLIC KEY.

🪟 On Windows (10 and 11)

1. Open the Start menu and type PowerShell.

2. Copy and paste the following command and press Enter:

   ssh-keygen -t rsa -b 4096
   

3. Press Enter at each prompt to accept the default options.

Your keys are created in the folder C:\\\\Users\\\\YourName\\\\.ssh\\\\:

• id_rsa: This is your PRIVATE KEY.
• id_rsa.pub: This is your PUBLIC KEY.

Step 2: Send us your public key

1. Go to the folder where the keys were created.
2. Open the file ending in .pub (e.g. id_rsa.pub).
3. Send us this file by email.

⚠️ IMPORTANT: Never send us the file without an extension (your private key). Keep it safe—it is your "passport" for access.

Step 3: Connect with FileZilla

We recommend the free FileZilla Client, but any SFTP-compatible client works (WinSCP, Cyberduck, Transmit).

1. Download and install FileZilla Client.
2. Open FileZilla and go to File > Site Manager (or the icon at the top left).
3. Click New Site and name it (e.g. "SFTP Exchange").
4. Configure the General tab as follows:

Note: If FileZilla asks to convert the key to another format, click "Yes".

1. Click Connect.

FAQ / Troubleshooting

I don't see my keys in the .ssh folder

Folders starting with a dot are often hidden.

• On Mac: In Finder, use Cmd + Shift + . to show hidden files.
• On Windows: In Explorer, under the "View" tab, check "Hidden items".

"Permission denied (publickey)" error

This usually means that:

• You are not using the correct private key.
• We have not yet enabled your access with the public key you sent us.
• The username is incorrect.

Can I use the same key on multiple computers?

Yes. You can copy your private key file (id_rsa) to another computer or server to automate transfers.

🇫🇷 Format de Fichier CSV - Import des Terminaux de Paiement Partenaires

Cette documentation décrit le format du fichier CSV à utiliser pour l'import des terminaux de paiement (TPE) des partenaires dans le système Loop.

Vue d'ensemble

Le fichier CSV doit contenir une ligne d'en-tête et une ligne par terminal de paiement à importer. Le fichier doit être encodé en UTF-8 et utiliser la virgule (,) comme séparateur.

Structure du Fichier

En-têtes de colonnes

Le fichier CSV doit commencer par une ligne d'en-tête avec les colonnes suivantes (dans l'ordre : champs obligatoires puis optionnels) :

mid,country_code,name,acquirer_id,subid,company_registration_number,category_code,naf,street,zip_code,city

Description des Champs

Champs Obligatoires

Champs Optionnels

Règle Importante : Category_code ou NAF

⚠️ Important : Vous pouvez remplir soit le champ category_code (MCC) soit le champ naf (code NAF), ou les deux.

Règle de priorité : Si les deux champs sont renseignés, le MCC (category_code) sera pris en compte et le code NAF sera ignoré.

• Si vous avez uniquement le code MCC, utilisez le champ category_code
• Si vous avez uniquement le code NAF, utilisez le champ naf
• Si vous avez les deux, vous pouvez les renseigner tous les deux : le MCC sera utilisé en priorité

Exemple de Fichier CSV

mid,acquirer_id,subid,company_registration_number,country_code,name,category_code,naf,street,zip_code,city
1234567890,21213,,123456789012,FR,Restaurant Le Gourmet,,5610A,50 Rue de la Paix,75001,Paris
9876543210,34532,SUB001,987654321012,FR,Boulangerie du Coin,,4724Z,12 Avenue des Champs,69000,Lyon
5555555555,,,,,BR,Padaria Central,5812,,Avenida Paulista 1000,01310-100,São Paulo
1111111111,,,,,ES,Restaurante Madrid,,,Calle Gran Vía 45,28001,Madrid

Validation et Traitement

Validation Automatique

Le système effectue automatiquement les validations suivantes :

1. Format des données : Validation du format de chaque champ selon le schéma

Rapport de Traitement

Après le traitement de votre fichier, vous recevrez un rapport CSV contenant :

• Toutes les lignes de votre fichier original
• Une colonne status indiquant success ou error
• Une colonne error_message avec le détail de l'erreur si applicable

Bonnes Pratiques

1. Encodage : Utilisez toujours l'encodage UTF-8 pour éviter les problèmes de caractères spéciaux
2. Séparateur : Utilisez la virgule (,) comme séparateur
3. Guillemets : Si une valeur contient une virgule, entourez-la de guillemets doubles (")
4. Immatriculation : Renseignez le numéro d'immatriculation société (company_registration_number) lorsque disponible pour garantir l'éligibilité aux titres restaurant
5. Vérification : Vérifiez votre fichier avant l'envoi pour éviter les erreurs de format

Exemple avec Valeurs Contenant des Virgules

mid,acquirer_id,subid,company_registration_number,country_code,name,category_code,naf,street,zip_code,city
1234567890,23,,123456789012,FR,"Restaurant Le Gourmet, Paris",,5610A,"50 Rue de la Paix, 1er étage",75001,Paris

Support

Pour toute question concernant le format du fichier CSV ou le processus d'import, contactez votre interlocuteur Swile.

🇬🇧 CSV File Format - Partner Payment Terminals Import

This documentation describes the CSV file format to use for importing partner payment terminals (POS) into the Loop system.

Overview

The CSV file must contain a header row and one row per payment terminal to import. The file must be UTF-8 encoded and use the comma (,) as separator.

File Structure

Column Headers

The CSV file must start with a header row with the following columns (in order: required fields then optional):

mid,country_code,name,acquirer_id,subid,company_registration_number,category_code,naf,street,zip_code,city

Field Description

Required Fields

Optional Fields

Important Rule: Category_code or NAF

⚠️ Important: You may fill either the category_code (MCC) field or the naf (NAF code) field, or both.

Priority rule: If both fields are provided, the MCC (category_code) will be used and the NAF code will be ignored.

• If you only have the MCC code, use the category_code field
• If you only have the NAF code, use the naf field
• If you have both, you may provide both: the MCC will take priority

CSV File Example

mid,acquirer_id,subid,company_registration_number,country_code,name,category_code,naf,street,zip_code,city
1234567890,21213,,123456789012,FR,Restaurant Le Gourmet,,5610A,50 Rue de la Paix,75001,Paris
9876543210,34532,SUB001,987654321012,FR,Boulangerie du Coin,,4724Z,12 Avenue des Champs,69000,Lyon
5555555555,,,,,BR,Padaria Central,5812,,Avenida Paulista 1000,01310-100,São Paulo
1111111111,,,,,ES,Restaurante Madrid,,,Calle Gran Vía 45,28001,Madrid

Validation and Processing

Automatic Validation

The system automatically performs the following validations:

1. Data format: Validation of each field format according to the schema

Processing Report

After your file is processed, you will receive a CSV report containing:

• All rows from your original file
• A status column indicating success or error
• An error_message column with the error details when applicable

Best Practices

1. Encoding: Always use UTF-8 encoding to avoid special character issues
2. Separator: Use the comma (,) as separator
3. Quotes: If a value contains a comma, wrap it in double quotes (")
4. Registration number: Provide the company registration number (company_registration_number) when available to ensure meal voucher eligibility
5. Verification: Check your file before submission to avoid format errors

Example with Values Containing Commas

mid,acquirer_id,subid,company_registration_number,country_code,name,category_code,naf,street,zip_code,city
1234567890,12,,123456789012,FR,"Restaurant Le Gourmet, Paris",,5610A,"50 Rue de la Paix, 1er étage",75001,Paris

Support

For any questions regarding the CSV file format or the import process, contact your Swile representative.