Télécharger guide

Charger et télécharger des fichiers avec Ogone Batch (de base)
Charger et télécharger des fichiers avec Ogone Batch (de base)
Table des matières
1. Introduction
2. Télécharger les fichiers manuellement
2.1 Préparer les fichiers de transaction
2.2 Procédé de téléchargement manuel
2.2.1 Étape 1: Sélectionner le fichier
2.2.2 Étape 2 : Vérifier le format
2.2.3 Étape 3: Résultats du téléchargement
3. Consulter les fichiers téléchargés
3.1 Quelques critères pour un fichier
3.1.1 Différentes références d’un fichier
3.1.2 Statuts du fichier
3.1.3 Codes
4. Télécharger le fichier
4.1 Rapports électroniques
5. Annexe : Mise en page du fichier
Page 1 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
1. Introduction
Le mode de Ogone Batch vous permet de regrouper vos paiements dans des fichiers formatés que vous pourrez alors télécharger. Cette
option convient particulièrement pour un grand nombre de paiements ou aux facturations récurrentes.
Dans ce guide, entre autres choses, nous vous expliquons comment créer et gérer des fichiers Batch et de les télécharger.
Pour des informations plus détaillées sur Batch (par exemple automatiser le téléchargement et le processus de téléchargement), allez à
Advanced Batch.
Page 2 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
2. Télécharger les fichiers manuellement
2.1 Préparer les fichiers de transaction
Les fichiers que vous téléchargez doivent être de simples fichiers textes sous un format de fichier qui peut être ouvert en utilisant n’importe
quelle application (par exemple, MS Access, MS Excel, etc.).
Si vous ne disposez pas d’une application pour créer ces fichiers de transaction formatés, vous pouvez le faire manuellement en entrant les
transactions ligne par ligne.
Cependant, nous avons créé un fichier MS Excel qui vous aidera à créer les fichiers de transaction formatés pour le téléchargement. La
feuille de calcul MS Excel comprend un macro qui vous permettra de créer un simple fichier texte pouvant contenir toutes les informations
dans la feuille de calcul.
Ce n’est pas la feuille de calcul elle-même que vous devez télécharger, mais le fichier texte que vous avez créé via la macro dans la
feuille de calcul MS Excel.
Pour de plus amples informations, allez à la Mise en page du fichier.
2.2 Procédé de téléchargement manuel
Cliquez sur le lien "Nouveau Fichier" dans le menu de votre module de gestion de Ogone afin de télécharger un nouveau fichier de
paiement.
2.2.1 Étape 1: Sélectionner le fichier
1. Cliquez sur le bouton “Browse” afin de sélectionner le fichier que vous voulez télécharger à partir de votre ordinateur.
2.
Entrer la référence (le nom) du fichier. Vous pouvez utiliser cette référence afin de chercher plus tard votre fichier.
3. Cliquez sur le bouton “Chargement de fichiers de transactions”
2.2.2 Étape 2 : Vérifier le format
Après avoir téléchargé un fichier, on va d’abord effectuer une vérification du format. Nous validerons si la mise en page du fichier est
correcte et si le contenu correspond au format. À cette étape, nous ne sauvegarderons pas les transactions dans nos bases de données,
vous pourrez donc toujours annuler le fichier si besoin.
Sur la page de vérification du format, vous verrez :
Les premières transactions valides du fichier (le nombre de celles-ci dépend du nombre que vous avez entré sur l’écran précédent)
Les erreurs de validation du format des transactions
Les montants totaux par devise monétaire
Notre référence de fichier
Une liste de fichiers téléchargés au cours du dernier mois, contenant les mêmes montants totaux et/ou les mêmes comptes des
numéros de cartes. De cette manière, vous pouvez éviter d’envoyer en double un même fichier
Page 3 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
Une liste de fichiers dont le statut n’est pas encore final
Si la vérification du format est accomplie avec succès et qu’aucune erreur de validation ne s’est produite, vous pouvez cliquer sur
“Continuer” afin de demander au système de traiter le fichier.
Si vous oubliez de cliquer sur le bouton “Continuer”, votre fichier ne sera pas traité et demeurera en mode “Checked”.
Lorsqu’il y a plus de 100 transactions dans le fichier, vous verrez une boîte défilante où vous pourrez choisir entre les modes SYNC ou
encore ASYNC afin de traiter le fichier :
Si vous choisissez le mode SYNC, vous recevrez lors de la prochaine étape les résultats de téléchargement sur votre écran, si votre
système ne ferme pas automatiquement la session après un certain temps. (Les résultats de téléchargement affichés ne sont pas les
résultats financiers ou les résultats autorisés avec les acquéreurs parce que cette partie du traitement est toujours effectuée hors-ligne).
En mode ASYNC, le téléchargement est effectué hors-ligne et vous recevrez un email lorsque le fichier sera validé par notre système.
Le mode ASYNC est recommandé pour les fichiers qui contiennent un grand nombre de transactions.
La capture d’écran suivante illustre un fichier qui contient une erreur de validation pour l’une des transactions (le numéro de carte de crédit
n’est pas valide).
Lorsque vous rencontrez des erreurs de validation, vous pouvez agir de deux façons possibles :
Vous pouvez cliquer sur le bouton “Continuer” ; de cette façon, notre système traitera le fichier et ses transactions, en sachant que les
transactions avec erreur de validation (en rouge) ne seront pas traitées. Vous aurez besoin de générer et de soumettre un nouveau
fichier plus tard, contenant les transactions ‘en rouge’, en vous assurant de résoudre les problèmes listés pour chacune des
transactions.
Vous pouvez cliquer sur le bouton “Annulation” afin d’annuler le fichier. Vous pouvez alors résoudre les erreurs dans les transactions et
envoyer de nouveau le fichier. Si vous avez résolu tous les problèmes, la vérification du format sera maintenant accomplie avec
succès et vous pourrez continuer le traitement
Page 4 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
Ne téléchargez pas deux fois le même fichier (à moins d’avoir annulé la première soumission), même si vous n’avez pas reçu une
réponse de la part de notre serveur. Vérifiez toujours le statut du fichier avant d’effectuer toute action.
2.2.3 Étape 3: Résultats du téléchargement
À l’étape 3, nous traitons le fichier, c’est-à-dire que nous importons les transactions dans notre base de données et les envoyons aux
(banques) acquéreurs. Le résultat de l’importation des transactions dans notre base de données est affiché sur la page ‘Résultats du
chargement’.
Mode SYNC:
Sur la page ‘Résultats du chargement’, vous verrez les informations supplémentaires suivantes :
Le nombre de transactions et le nombre de transactions ‘acceptées’ (accepté pour le traitement dans notre système, pas le résultat
financier !)
Les transactions que notre système n’a pas traitées, en raison des erreurs de validation du format
La gamme des références PAYID des transactions
Après l’étape 3, le fichier sera en mode “Loaded” jusqu’à ce que toutes les transactions aient été envoyées aux (banques) acquéreurs et que
nous ayons reçu le statut final de la part des (banques) acquéreurs. Dès lors, le statut du fichier passera de “Loaded” à “Processed” et vous
pourrez consulter le statut final des transactions dans votre module de gestion.
La capture d’écran suivante illustre les résultats de téléchargement pour un fichier qui contient une transaction rejetée par notre système.
Cette transaction ne sera pas traitée. Si vous voulez tout de même traiter la transaction, vous aurez besoin de créer et de soumettre un
nouveau fichier, contenant cette transaction ‘en rouge’, en vous assurant de résoudre le problème listé pour la transaction.
Il est tout à fait possible que le nombre de lignes d’erreur à l’étape 3 soit plus élevé qu’à l’étape 2 ; étant donné que nous avons effectué un
nombre de vérifications supplémentaires à l’étape 3.
Page 5 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
Mode ASYNC:
Sur la page ‘Résultats du chargement’, vous n’aurez aucune information additionnelle puisque le fichier est téléchargé hors-ligne. Vous
recevrez un email une fois que le fichier sera validé par notre système.
Après l’étape 3, le fichier sera en mode “To be loaded” jusqu’à ce que les transactions aient été téléchargées, c’est-à-dire importées dans
notre base de données. Une fois que toutes les transactions auront été téléchargées, le fichier affichera le statut “Loaded” jusqu’à ce que
toutes les transactions aient été envoyées aux (banques) acquéreurs et que nous ayons reçu le statut final de la part des (banques)
acquéreurs. Le statut du fichier passera ensuite du statut “Loaded” à “Processed” et vous pourrez consulter le statut final des transactions
dans votre module de gestion.
Vous pouvez aussi télécharger automatiquement vos fichiers de paiement (grâce à une application) au lieu de procéder manuellement (via le
module de gestion). Veuillez s’il vous plaît, vous référer au Guide d’intégration Advanced Batch pour de plus amples informations.
Page 6 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
3. Consulter les fichiers téléchargés
Vous pouvez consulter une liste des plus récents fichiers téléchargés (manuellement ou automatiquement) via le lien “Gestion fichiers” dans
le menu de votre module de gestion. Vous pouvez chercher les fichiers qui ne sont plus dans la liste des récents fichiers téléchargés via le
bouton “Autres fichiers…”.
Vous pouvez consulter le sommaire du fichier de données et l’Historique Financier des transactions dans le fichier, ou télécharger les
informations des transactions du fichier (voir le chapitre “Télécharger le Fichier”) en sélectionnant respectivement les boutons “Résumé”,
“Détails” et “Download”.
La capture d’écran suivante montre l’exemple d’un sommaire des données du fichier ainsi que les résultats de la transaction. Pour de plus
amples informations, aller à consulter les transactions.
Les résultats des transactions sont finaux seulement lorsque le statut du fichier téléchargé est fixé à ‘Processed’.
3.1 Quelques critères pour un fichier
La section suivante décrit quelques critères importants associés à la consultation d’un fichier. Pour des informations plus détaillées sur la
manière de consulter les fichiers, cliquez sur le lien "Plus d'infos" dans le menu "Opérations > Gestion fichiers".
3.1.1 Différentes références d’un fichier
Réf (ou FileID) : l’unique référence du fichier donnée par notre système.
Page 7 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
Merch réf : la référence du fichier que vous entrez lorsque vous téléchargez le fichier.
3.1.2 Statuts du fichier
Uploaded : le fichier a été reçu, mais n’a pas encore été validé.
To be checked : le fichier est en attente de validation.
Checked : le fichier a été validé.
Cancelled : le fichier a été annulé après l’étape ‘Vérification’.
To be loaded : le fichier est en attente de téléchargement dans notre module de traitement (En mode ASYNC seulement).
Being loaded : le fichier est en téléchargement dans notre module de traitement.
Loaded : le fichier a été téléchargé dans notre module de traitement, mais quelques paiements n’ont pas encore été envoyés aux
(banques) acquéreurs.
Processed : tous les paiements dans le fichier ont été envoyés aux (banques) acquéreurs.
3.1.3 Codes
Il y a les codes de transaction suivants pour le fichier :
ATR : code pour les nouvelles transactions
MTR : code des opérations de maintenance sur des transactions actuelles.
Tout fichier que vous téléchargez devient automatiquement un fichier ATR à moins que vous ne le spécifiiez autrement dans l’en-tête du
fichier.
Page 8 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
4. Télécharger le fichier
Vous pouvez télécharger manuellement le fichier d’un paiement (résultats de la transaction) en suivant les étapes suivantes :
1. Cliquez sur le lien “Rapports électroniques” dans le menu de votre module de gestion
2. Choisir votre format et votre structure de fichier souhaité.
3. Entrez les critères de recherche pour les résultats de la transaction que vous voulez télécharger via le lien “Gestion transactions” ou
“Historique Financier” dans le menu de votre module de gestion ou sélectionnez le fichier de transactions que vous voulez télécharger
via le lien “Gestion fichiers” dans le menu de votre module de gestion.
4. Cliquez sur le bouton "Downloader la Liste".
Vous pouvez aussi télécharger automatiquement vos fichiers de paiement (grâce à une application) au lieu de procéder manuellement (via le
module de gestion). Pour de plus amples informations, aller à Advanced Batch.
4.1 Rapports électroniques
Sur la page des rapports électroniques, vous pouvez spécifier le format et la structure que vous voulez utiliser pour les rapports, tels que
les téléchargements du fichier. Lorsque les “push reports” sont activés dans votre compte, le lien des rapports électroniques vous donnera
accès à une liste de vos “push reports”.
Les champs spécifiques seront repris dans votre téléchargement de fichier, dépendant de la structure du fichier. Un choix de différentes
structures de fichier est disponible :
Standard
Extended
File Management Dynamic.
Vous pouvez aussi choisir entre différents formats de reprise :
XML
Fixed-length
Delimited
Pour une description complète des structures de téléchargement, aller à la page "description des fichiers de paiement téléchargés" page
dans la section de support de votre compte Ogone. Vous pouvez aussi trouver plus d’informations au sujet des différents formats de fichier
dans Batch Avancé.
Conseils :
Nous vous recommandons d’utiliser la structure “Dynamic” et le format de fichier “Delimited” (;) avec l’extension .csv afin de recevoir
un fichier des résultats MS Excel.
Pour obtenir les en-têtes des colonnes dans le fichier des résultats, veuillez cocher la boîte “With column headers” dans la section
“Autres” de la page des rapports électroniques.
Page 9 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
5. Annexe : Mise en page du fichier
En préparant vos fichiers de transactions, garder en mémoire les quelques règles suivantes :
Les fichiers doivent être des fichiers Texte ASCII
Une ligne par commande (excepté pour les en-têtes et les pieds de page), les lignes sont séparées par le pair de caractères Retour
Chariot/Saut de Ligne (ASCII : 13 10 – HEX : 0xD 0xA)
Les champs sont séparés par un “;”
Les champs eux-mêmes ne contiennent pas de “;”
Vue d’ensemble des champs du fichier :
Field
Field
#
1
AMOUNT
Usage
Montant à payer MULTIPLIÉ PAR 100 puisque le format du montant ne doit pas contenir de
décimales ou autres séparateurs
Devise pour la commande en code ISO alpha. Par exemple : EUR, USD, GBP, ...
Note : pour garantir un traitement optimal de vos fichiers batchs, toutes les devises configurées
2
CURRENCY
dans votre compte Ogone sous Configuration > Abonnement > Devise doivent l’être en fonction
de la méthode de paiement utilisée (Configuration > Méthodes de paiement > Données du
contrat).
3
BRAND
Marque de la carte (“Direct Debits NL” pour Direct Debits NL) Type de carte ou information
similaire pour les autres méthodes de paiement
Numéro de carte/compte (un numéro de compte bancaire doit toujours avoir 10 chiffres: si le
compte a moins de 10 chiffres, tapez des zéros à la gauche. Pour les comptes Postbank:. "000"
4
CARDNO
5
ED
Date d’expiration (MM/AA ou MMAA) (99/99 ou 9999 pour Direct Debits NL)
6
ORDERID
Votre numéro de commande unique (référence du marchand)
7
COM
Description de la commande
8
CN
Le nom du client
9
PAYID
Référence unique du paiement dans notre système
+ 7 chiffres ou "P00" + 7 chiffres)
La procédure de paiement que vous avez configurée dans la section „Code d’opération par
défaut“ de l’onglet „Paramètres de transaction globaux“ de la page d’information technique
déterminera votre code d’opération par défaut. Lorsque vous envoyez un code d’opération dans
10
OPERATION
votre fichier batch, ce code remplace la valeur par défaut.
Veuillez vous référer au document « Parameter Cookbook » pour connaître les valeurs possibles
du code d’opération.
11
AUTHORIZATION
CODE
Page 10 of 12 - 16/09/2016
Code d’autorisation d’une commande, non reçu via notre système.
Charger et télécharger des fichiers avec Ogone Batch (de base)
AUTHORIZATION
La façon dont le code d’autorisation (dans champ 11) a été reçu. Valeur possible : ‘TEL’ pour
MODE
téléphone.
AUTHORIZATION
La date et l’heure auxquelles le code d’autorisation (dans champ 11) a été reçu (MM/JJ/AA
DATE
HH:MM:SS)
14
PSPID
Votre nom d’affiliation dans notre système.
15
GLOBORDERID
...
Champs vides
...
22
OWNERADDRESS
L’adresse du client
23
OWNERZIP
Le code postal du client
24
OWNERTOWN
Nom de la ville du client
25
OWNERCTY
Le pays du client
26
OWNERTELNO
Le numéro de téléphone du client
27
CVC
Card Verification Code. (Code de vérification de la carte)
...
Champs vides
...
12
13
Référence globale pour plusieurs commandes. Cette référence vous permet de demander une
opération de maintenance sur plusieurs commandes plus tard.
Electronic Commerce Indicator (Indicateur de commerce électronique). Vous pouvez configurer
une valeur ECI par défaut dans la section „Valeur ECI par défaut“ de l’onglet „Paramètres de
transaction globaux“ de votre page Information Technique. Si vous envoyez une valeur ECI
dans le champ ECI de votre fichier, celui-ci remplace la valeur ECI par défaut.
Valeurs ECI possibles (numériques):
35
ECI
0 Carte utilisée sur un terminal physique (Swiped)
1 Vente à distance classique (MOTO)
2 Paiements périodiques provenant de VAD
3 Paiements étalés
7 E-commerce avec encryption SSL
9 Paiements périodiques provenant de commerce electronique
Note: vous pouvez également envoyer des champs supplémentaires si vous avez activé certaines options/fonctions dans votre
compte Ogone. Consultez la documentation de l'option pour plus d'informations sur les champs supplémentaires liés.
En-têtes et pieds de page :
OHL: information de login (pas nécessaire lorsque vous êtes en train de télécharger manuellement un fichier).
OHF: en-tête contenant les paramètres généraux d’un fichier (nécessaire seulement lorsque le code de transaction est MTR). Format:
OHF;Référence du fichier du commerçant;Code de la transaction (ATR/MTR);Opération;Nombre de commandes.
OTF: pied de page du fichier général, précisée à la fin du fichier (nécessaire seulement lorsque le fichier a un en-tête).
Veuillez vous référer à Batch Advancé pour des informations supplémentaires.
Exemples :
Page 11 of 12 - 16/09/2016
Charger et télécharger des fichiers avec Ogone Batch (de base)
Fichier ATR
OHF;File20070430;ATR;;3;
1000;EUR;;4111111111111111;11/02;Order0001;;Paul Smith;
100;EUR;;4111111111111111;11/02;Order0002;; Bill Durand;
2032;EUR;;4111111111111111;11/02;Order0003;;John Doe;
OTF;
ou
1000;EUR;;4111111111111111;11/02;Order0001;;Paul Smith;
100;EUR;;4111111111111111;11/02;Order0002;; Bill Durand;
2032;EUR;;4111111111111111;11/02;Order0003;;John Doe;
Fichier MTR
OHF;Filename;MTR;SAS;1;
1000;EUR;;;;;;;1280281;
OTF;
Page 12 of 12 - 16/09/2016