Fichier des opérations avec option réconciliation

Format des fichiers image de remise XML

Fichier des opérations avec option réconciliation

Format des fichiers image de remise XML

Format des fichiers image de remise CSV

Format des fichiers image de remise CSV

Valorisation des données conditionnelles

Les options du fichier

Crédit vs Débit

Tableau de correspondance entre les opérations et les paiements

Gestion des frais

Historique de la page

Fichier des opérations avec option réconciliation

Format des fichiers image de remise XML

Fichier des opérations avec option réconciliation

Format des fichiers image de remise XML

Format des fichiers image de remise CSV

Format des fichiers image de remise CSV

Valorisation des données conditionnelles

Les options du fichier

Crédit vs Débit

Tableau de correspondance entre les opérations et les paiements

Gestion des frais

Paramètre de lancement

Contenu des fichiers

Réconciliation

Format

Fréquence et heure

Transfert de fichiers

Structure du document

Élément GROUP

Élément MERCHANT

Élément POINT_OF_SELL

Élément CAPTURES

Paramètre de lancement

Contenu des fichiers

Format

Fréquence et heure

Transfert de fichiers

Structure du document

Élément GROUP

Attribut
Type
Lg max
Format
Valeur ou description
NamepaymentTypeCode
R
10020
AN
Enseigne du commerçant
Code du moyen de paiement associé
acquierNameId
R
1430
N
Identifiant Nom de l'acquéreur du commerçant
posNumbercontractNumber
R
50
8
N
Nombre de point de vente dans le fichier
Légende : R = requis, F = facultatif, C = conditionnel
Sous éléments :
AN
N° contrat commerçant accepteur
contractDescription
R
200
AN
Intitulé du contrat commerçant
currencyCode
R
3
N
Devise
captureFileDate
R
25
AN
Date de la remise
creditNumber
Liste de POINT_OF_SELL

Élément POINT_OF_SELL

Élément CHARGEBACKS

Élément CAPTURES

Élément

SETTLEMENTS

Élément

REJECTS

Élément

TRANSACTION_REF

Élément CAPTURE_INFO

Élément TRANSACTION_REF

Élément CHARGEBACK_INFO

Élément SETTLEMENT_INFO

Règles générales du format

Structure du fichier CSV

Élément REJECT_INFO

Règles générales du format

Structure du fichier CSV

Option réconciliation bancaire (1)

Option FileNumer (2)

Option IFR (3)

Option Charge_back_number (4)

Arborescence des pages

Comparaison des versions

Légende

Paramètre de lancement

Contenu des fichiers

Réconciliation

Format

Fréquence et heure

Transfert de fichiers

Structure du document

Élément GROUP

Élément MERCHANT

Élément POINT_OF_SELL

Élément CAPTURES

Paramètre de lancement

Contenu des fichiers

Format

Fréquence et heure

Transfert de fichiers

Structure du document

Élément GROUP

Élément POINT_OF_SELL

Élément CHARGEBACKS

Élément CAPTURES

Élément

SETTLEMENTS

Élément

REJECTS

Élément

TRANSACTION_REF

Élément CAPTURE_INFO

Élément TRANSACTION_REF

Élément CHARGEBACK_INFO

Élément SETTLEMENT_INFO

Règles générales du format

Structure du fichier CSV

Élément REJECT_INFO

Règles générales du format

Structure du fichier CSV

Option réconciliation bancaire (1)

Option FileNumer (2)

Option IFR (3)

Option Charge_back_number (4)

Options

Options

Ligne d'entête

Ligne d'entête

Ligne des transactions

Nom de colonne
N° col
Type
Lg max
Format Option
Valeur ou description
type
Type
1
R
6
A

Type de ligne :
HEADER
name
2
R
100
AN
Nom du fichier
date
3
R
20
AN
Horodatage local du fichier au format YYYY/MM/DD HH:MM:SS
version
4
R
10
AN
Version du fichier. (Par exemple : 4.0.1)
sequence
5
R
6
N
N° séquentiel du fichier incrémenté de 1 à chaque fichier
Légende : R = requis, F = facultatif, C = conditionnel

Ligne des transactions

Ligne d'en-queue (option)

Ancienne version 11

Nouvelle version 38

Options

Options

Ligne d'entête

Ligne d'entête

Ligne des transactions

Ligne des transactions

Ligne d'en-queue (option)

Image Removed

Contenu

Sommaire

maxLevel	1
style	none

Image Added

Extrait

hidden	true

Evolutions

Version

Date

Modifications

1.0

04/12/08

Livraison version initiale

1.1

19/01/09

Ajout du format csv

1.2

23/02/09

Ajout de la notion de groupe dans le format XML

1.3

22/12/09

Suppression du champ « captureamount » (dans la spécification)

1.4

28/04/10

Suppression de l'envoi du fichier par email

1.5

21/05/10

Mise en forme Monext

1.6

07/01/13

Mise en forme Monext

2.0

22/04/13

Ajout de l'option réconciliation bancaire

2.1

03/06/13

Renommage du fichier

2.2

16/02/15

Mise à jour de la colonne FileNumber

2.3

25/02/15

Mise à jour du format de la date

2.4

26/02/15

Mise à jour des informations oppotota

2.5

26/03/15

Ajout du typage des impayés (Crédit ou Débit).

2.6

24/04/15

Tableau de correspondances entre les opérations, transactions et paiements.

2.7

03/06/15

Mise à jour différents champs

2.8

04/08/15

Refonte format + Précision date + Correction CBK

2.917/02/17nouveau champ charge_back_number en option

Le batch prend 9 paramètres en ligne de commande :

Nom du paramètre	Format	Obligatoire ?	Description
Date	DD/MM/YYYY	Oui	La date pour laquelle il faut effectuer l’extraction des transactions remises en banque.
SupervisorId	N(14)	Oui	Le superviseur du (des) commerçant(s) pour lequel effectuer l’extraction.
Path	AN	Oui	Le chemin absolu vers le fichier contenant l’image de remise (avec le nom du fichier).
file	AN	Oui	Le nom du fichier contenant l’image de remise .
type_fichier	A	Oui	Le format du fichier de sortie. Parmi CSV ou CSV_colonne ou XML
reconciliation	(Y/N)	Oui	Flag indiquant s’il faut extraire les éléments de réconciliation (settlement/chargebacks)
Aurore	(Y/N)	Oui	Flag indiquant s’il faut prendre en compte les transactions Aurore.
file_number	(Y/N)	Oui	Flag indiquant s’il faut extraire le file number.
charge_back_number	(Y/N)	Oui	Flag permettant d’ajouter le numéro de dossier rattaché à un impayé.

Exemple de lancement en ligne de commande

Kitchen.bat -rep=referentiel_32_payline_dev2_aix -user=nbellais -pass=XXXXXX -dir=/Payline/ImageRemise -job=ImageRemise 28/01/2015 60674773579275 "C:\Kettle\ImageRemise\kiabi.xml" kiabi.xml XML N Y N

Les fichiers comportent plusieurs types d'informations :

Un rappel des coordonnées du client et du contrat commerçant sur lequel sont remises les transactions
Le détail des transactions autorisées et remises par Payline : numéro CB masqué, références, montant
Un récapitulatif des transactions de débit et de crédit
Les transactions réconciliées sur le compte des commerçants ainsi que les frais et montants nets.
Les transactions impayées et leur montant

Il peut être généré pour tous les clients qui souscrivent à cette option, quel que soit le format de remise utilisé vis-à-vis de l'acquéreur :

CB2A fichier
AMEX
FRFC
autres

Le fichier de remise est généré à partir du contenu du système d'information de Payline.
Les données de réconciliation (commissions bancaires et impayés) sont générées à partir de deux fichiers bancaires :

Le fichier « Relevé de compte »
Le fichier des « Impayés »

A noter que le fichier image de remise qui sera envoyé à J contiendra les données de J-2.

Après minuit, Monext Online transmet les opérations de type validation aux acquéreurs bancaires : fichier de remise.
Ensuite les acquéreurs confirment le traitement des opérations : réconciliation.
Monext Onilne transmet le fichier des paiements aux commerçants avec les opérations remisées du J-1 et les les opérations réconciliées de J-2.

Avec la réconciliation, le commerçant peut consulter les opérations créditées sur compte.

Le format de génération du fichier est, selon votre choix, de type XML en encodage UTF8 ou de type CSV en encodage ASCII.
Le nom du fichier aura le nommage suivant « Remise_enseigne_yyyymmdd ».
Un tel fichier peut être traité par des programmes, mais aussi manuellement. En effet, le format XML peut être consulté par un navigateur Internet et le format CSV par l'application Excel.
Dans le cas du format XML, des balises situées à différents niveaux hiérarchiques procurent un niveau de synthèse variable :

Niveau enseigne (élément point_of_sell)
Niveau remise (élément captures) ou moyen de paiement (élément settlements)
Détail transaction (élément capture_info, settlement_info, chargeback_info)

Dans le cas du format CSV, vous avez le choix de la structure du fichier :

En-tête, liste des transactions remises et en-queue
Nom des colonnes, liste des transactions remises

Un fichier est généré chaque jour, qu'il y ait des transactions ou non. Le numéro de séquence fournit permet de garantir la séquence de ces fichiers.
Les fichiers peuvent être mis à disposition dans la matinée (à partir de 7h du matin)

Le fichier image de remise peut-être transmis au client par :

Transfert de fichiers CFT, FTPS, SFTP via réseau IP (dans ce cas un lien doit être mis en place entre le client et Payline)

La diffusion par CFT, SFTP, FTPS s'effectue automatiquement vers un serveur du client.

Le fichier au format XML est le format standard Payline. Il offre l'avantage d'une lecture simple de l'information :

Les dates sont au format « YYYY/MM/DD HH :MI :SS », par exemple : « 2015/03/20 15:30:22 ».
Les montants sont exprimés dans la plus petite unité de la devise
Les codes devise sont exprimés sur 3 digits de la norme ISO 4217 (http://en.wikipedia.org/wiki/ISO_4217)

Diagramme draw.io


diagramName	Structure fichier des paiements
width	614
zoom	1
diagramDisplayName	Structure fichier des paiements
lbox	true
contentVer	1
height	295
revision	3

Élément racine. Permet d'identifier le fichier et le groupe de commerçant associé au fichier.

Attribut	Type	Lg max	Format	Valeur ou description
name	R	100	AN	Dénomination du groupe
Id	R	14	N	Identifiant technique
Date	R	25	N	Horodatage local du fichier
Sequence	R	6	N	N° séquentiel du fichier incrémenté de 1 à chaque fichier
merchantNumber	R	8	N	Nombre de compte commerçant dans le fichier

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de MERCHANT

Attribut	Type	Lg max	Format	Valeur ou description
Name	R	100	AN	Enseigne du commerçant
Id	R	14	N	Identifiant commerçant
posNumber	R	8	N	Nombre de point de vente dans le fichier

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de POINT_OF_SELL

Attribut	Type	Lg max	Format	Valeur ou description
Name	R	50	AN	Intitulé de l'enseigne
captureNumber	R	8	N	Nombre de remise pour le point de vente

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de CAPTURES
Liste de CHARGEBACKS
Liste de SETTLEMENTS
Liste de REJECTS

Extrait

hidden	true

Le batch prend 9 paramètres en ligne de commande :

Nom du paramètre

Format

Obligatoire ?

Description

Date

DD/MM/YYYY

Oui

La date pour laquelle il faut effectuer l’extraction des transactions remises en banque.

SupervisorId

N(14)

Oui

Le superviseur du (des) commerçant(s) pour lequel effectuer l’extraction.

Path

AN

Oui

Le chemin absolu vers le fichier contenant l’image de remise (avec le nom du fichier).

file

AN

Oui

Le nom du fichier contenant l’image de remise .

type_fichier

A

Oui

Le format du fichier de sortie. Parmi CSV ou CSV_colonne ou XML

reconciliation

(Y/N)

Oui

Flag indiquant s’il faut extraire les éléments de réconciliation (settlement/chargebacks)

Aurore

(Y/N)

Oui

Flag indiquant s’il faut prendre en compte les transactions Aurore.

file_number

(Y/N)

Oui

Flag indiquant s’il faut extraire le file number.

charge_back_number

(Y/N)

Oui

Flag permettant d’ajouter le numéro de dossier rattaché à un impayé.

Exemple de lancement en ligne de commande

Kitchen.bat -rep=referentiel_32_payline_dev2_aix -user=nbellais -pass=XXXXXX -dir=/Payline/ImageRemise -job=ImageRemise 28/01/2015 60674773579275 "C:\Kettle\ImageRemise\kiabi.xml" kiabi.xml XML N Y N

Les fichiers comportent plusieurs types d'informations :

Un rappel des coordonnées du client et du contrat commerçant sur lequel sont remises les transactions
Le détail des transactions autorisées et remises par Payline : numéro CB masqué, références, montant
Un récapitulatif des transactions de débit et de crédit
Les transactions réconciliées sur le compte des commerçants ainsi que les frais et montants nets.
Les transactions impayées et leur montant

Il peut être généré pour tous les clients qui souscrivent à cette option, quel que soit le format de remise utilisé vis-à-vis de l'acquéreur :

CB2A fichier
AMEX
FRFC
autres

Le fichier de remise est généré à partir du contenu du système d'information de Payline.
Les données de réconciliation (commissions bancaires et impayés) sont générées à partir de deux fichiers bancaires :

Le fichier « Relevé de compte »
Le fichier des « Impayés »

A noter que le fichier image de remise qui sera envoyé à J contiendra les données de J-2.

Le format de génération du fichier est, selon votre choix, de type XML en encodage UTF8 ou de type CSV en encodage ASCII.
Le nom du fichier aura le nommage suivant « Remise_enseigne_yyyymmdd ».
Un tel fichier peut être traité par des programmes, mais aussi manuellement. En effet, le format XML peut être consulté par un navigateur Internet et le format CSV par l'application Excel.
Dans le cas du format XML, des balises situées à différents niveaux hiérarchiques procurent un niveau de synthèse variable :

Niveau enseigne (élément point_of_sell)
Niveau remise (élément captures) ou moyen de paiement (élément settlements)
Détail transaction (élément capture_info, settlement_info, chargeback_info)

Dans le cas du format CSV, vous avez le choix de la structure du fichier :

En-tête, liste des transactions remises et en-queue
Nom des colonnes, liste des transactions remises

Un fichier est généré chaque jour, qu'il y ait des transactions ou non. Le numéro de séquence fournit permet de garantir la séquence de ces fichiers.
Les fichiers peuvent être mis à disposition dans la matinée (à partir de 7h du matin)

Le fichier image de remise peut-être transmis au client par :

Transfert de fichiers CFT, FTPS, SFTP via réseau IP (dans ce cas un lien doit être mis en place entre le client et Payline)

La diffusion par CFT, SFTP, FTPS s'effectue automatiquement vers un serveur du client.

Le fichier au format XML est le format standard Payline. Il offre l'avantage d'une lecture simple de l'information :

Les dates sont au format « YYYY/MM/DD HH :MI :SS », par exemple : « 2015/03/20 15:30:22 ».
Les montants sont exprimés dans la plus petite unité de la devise
Les codes devise sont exprimés sur 3 digits de la norme ISO 4217 (http://en.wikipedia.org/wiki/ISO_4217)

Élément racine. Permet d'identifier le fichier et le groupe de commerçant associé au fichier.

Attribut

Type

Lg max

Format

Valeur ou description

name

R

100

AN

Dénomination du groupe

Id

R

14

N

Identifiant technique

Date

R

25

N

Horodatage local du fichier

Sequence

R

6

N

N° séquentiel du fichier incrémenté de 1 à chaque fichier

merchantNumber

R

8

N

Nombre de compte commerçant dans le fichier

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de MERCHANT

Élément MERCHANT

Attribut	Type	Lg max	Format	Valeur ou description
Name	R	50	AN	Intitulé de l'enseigne
captureNumber	R	8	N	Nombre de remise pour le point de vente

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

crédits
creditAmount	R	16	N	Montant brut des crédits (avant déduction de la commission)
debitNumber	R	8	N	Nombre des débits
deditAmount	R	16	N	Montant brut des débits (avant déduction de la commission)

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de TRANSACTION

Liste de CAPTURES
Liste de CHARGEBACKS
Liste de SETTELMENTS

Attribut	Type	Lg max	Format	Valeur ou description
paymentTypeCodeoperationTypeCode	R	201	ANA	Code du moyen de paiement associéopération : D : Débit (impayé) C : Crédit (recrédit suite à une régularisation)
paymentTypeCode	R	20	AN	Code du moyen de paiement associé
acquierName	acquierName	R	30	N	Nom de l'acquéreur du commerçant
contractNumber	R	50	AN	N° contrat commerçant accepteur
contractDescription	R	200	AN	Intitulé du contrat commerçant
currencyCode	R	3	N	Devise
captureFileDatechargebackNumber	R25	AN	Date de la remise	creditNumber	R	8	N	Nombre de créditsd'impayé
chargebackAmountcreditAmount	R	1612	N	Montant brut des crédits (avant déduction de la commission)
debitNumber	R	8	N	Nombre des débits
deditAmount	R	16	N	Montant brut des débits (avant déduction de la commission)
des impayés

Légende : R = Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de TRANSACTION_REF

CAPTURE_INFO

12 la remise

Attribut	Type	Lg max	Format	Valeur ou description
operationTypeCodepaymentTypeCode	R	120	AAN	Code opération : D : Débit C : Crédit A : Aborted, lorsqu'une annulation est réalisée par le processus de contrôle du fichier Oppotota
authorizationNumber	R	6	AN	N° autorisation
authorizationAmount	R	12	N	Montant de l'autorisation
du moyen de paiement associé
acquierName	R	30	N	Nom de l'acquéreur du commerçant
contractNumber	R	50	AN	N° contrat commerçant accepteur
contractDescription	R	200	AN	Intitulé du contrat commerçant
currencyCodeauthorizationCurrencyCode	R	3	N	Devise de l'autorisation
authorizationDatecreditSettleNumber	R	258	ANN	Date de la transaction d'autorisation	Nombre des transactions de crédit réconciliées
creditsettleGrossAmountauthorizationOrigin	R	5012	AN	Origine de la transaction d'autorisation	N	Montant Brut des transactions de crédit réconciliées
creditFeeAmountPan	R	1912	N	Numéro de carte masqué selon règles PCI/DSS	Montant des commissions des transactions de crédit réconciliées
debitSettleNumberThreeDsecure	R	18	N	Sécurisation par 3DSecure 0=non et 1=oui	Nombre des transactions de crédit réconciliées
debitsettleGrossAmountAvs	R	112	N	Sécurisation par vérification d'adresse postale AVS 0=non et 1=oui
captureDate	R	25	AN	Date de la transaction de validation
captureOrigin	R	50	AN	Origine de la transaction de validation
Montant Brut des transactions de crédit réconciliées
debitFeeAmount	R	12	N	Montant des commissions des transactions de crédit réconciliées
IFR	C	16	captureAmount	C		N	Montant de	l'interchange

Légende : R = requis, F = facultatif, C = conditionnel

CHARGEBACKS

Attribut	Type	Lg max	Format	Valeur ou description
operationTypeCodepaymentTypeCode	R	120	AAN	Code opération : D : Débit (impayé) C : Crédit (recrédit suite à une régularisation)
paymentTypeCode	R	20	AN	Code du moyen de paiement associé
du moyen de paiement associé
acquierName	acquierName	R	30	N	Nom de l'acquéreur du commerçant
contractNumber	R	507	AN	N° contrat commerçant accepteur
contractDescription	R	20030	AN	Intitulé du contrat commerçant
currencyCode	R	3	N	Devise
chargebackNumberrejectNumber	R	8	N	Nombre d'impayéde rejets
rejectAmountchargebackAmount	R	12	N	Montant des impayés

Légende : R = requis, F = facultatif, C = conditionnel

rejects

Sous éléments :

Liste de TRANSACTION_REF

SETTLEMENTS

Attribut	Type	Lg max	Format	Valeur ou description
paymentTypeCodeorderReference	R	2050	AN	Code du moyen de paiement associé	Référence de la commande
orderDescription	F	60	AN	Description de la commande (ce n'est pas utilisé)
acquierTransactionReference	C	12	AN	Référence archivage généré à partir de la référence commande et respectant les contraintes de format de l'acquéreur.
transactionID	R	50	AN	Identifiant de la transaction d'autorisation initiale généré par Payline

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Liste de CHARGEBACK_INFO
Liste de SETTLEMENT_INFO
Liste de CAPTURE_INFO
Liste de REJECT_INFO

Attribut	Type	Lg max	Format	Valeur ou description
operationTypeCode	R	1	A	Code opération : D : Débit C : Crédit A : Aborted, lorsqu'une annulation est réalisée par le processus de contrôle du fichier Oppotota
authorizationNumber	R	6	AN	N° autorisation
authorizationAmount
acquierName	R	30	N	Nom de l'acquéreur du commerçant
contractNumber	R	50	AN	N° contrat commerçant accepteur
contractDescription	R	200	AN	Intitulé du contrat commerçant
currencyCode	R	3	N	Devise
creditSettleNumber	R	8	N	Nombre des transactions de crédit réconciliées
creditsettleGrossAmount	R	12	N	Montant Brut des transactions de crédit réconciliées
creditFeeAmount	R	12	N	Montant des commissions des transactions de crédit réconciliées
debitSettleNumber	R	8	N	Nombre des transactions de crédit réconciliées
debitsettleGrossAmount	R	12	N	Montant Brut des transactions de crédit réconciliéesde l'autorisation
authorizationCurrencyCodedebitFeeAmount	R	123	N	Montant des commissions des transactions de crédit réconciliées
IFR	C	16	N	Montant de l'interchange

Légende : R = requis, F = facultatif, C = conditionnel

Sous éléments :

Devise de l'autorisation
authorizationDate	R	25	AN	Date de la transaction d'autorisation
authorizationOrigin	R	50	AN	Origine de la transaction d'autorisation
Pan	R	19	N	Numéro de carte masqué selon règles PCI/DSS
ThreeDsecure	R	1	N	Sécurisation par 3DSecure 0=non et 1=oui
Avs	R	1	N	Sécurisation par vérification d'adresse postale AVS 0=non et 1=oui
captureDate	R	25	AN	Date de la transaction de validation
captureOrigin

Liste de TRANSACTION_REF

Attribut	Type	Lg max	Format	Valeur ou description
orderReference	R	50	AN	Référence de la commande
orderDescription	F	60	AN	Description de la commande
acquierTransactionReference	C	12	AN	Référence archivage généré à partir de la référence commande et respectant les contraintes de format de l'acquéreur.
transactionID	R	50	AN	Identifiant Origine de la transaction d'autorisation initiale généré par Paylinede validation
captureAmount	C	12	N	Montant de la remise

Légende : R = requis, F = facultatif, C = conditionnel Sous éléments :

Liste de CHARGEBACK_INFO
Liste de SETTLEMENT_INFO

Attribut	Type	Lg max	Format	Valeur ou description
chargebackDate	R	25	AN	Date de l'impayé
chargebackAmount	R	12	AN	Montant de l'impayé
chargebackReason	C	20	AN	Code de l'impayé
chargebackDescription	C	100	AN	Description de l'impayé tronquée sur 100 char
chargebackNumber	C	16	AN	N° de dossier rattaché à l’impayé. Présent uniquement si l’option « charge_back_number» est demandé

Légende : R = requis, F = facultatif, C = conditionnel

Attribut	Type	Lg max	Format	Valeur ou description
operationTypeCode	R	1	A	Code opération D pour débit ou C pour crédit
settleDate	R	25	AN	Date de la réconciliation
grossAmount	R	12	AN	Montant brut de la transaction
feeAmount	C	20	AN	Commission sur la transaction

Légende : R = requis, F = facultatif, C = conditionnel

Ce paragraphe décrit le format des fichiers image de remise CSV. Ce format est très utile pour mettre à jour votre système d'information. Vous avez également la possibilité de consulter ce fichier en l'ouvrant dans Excel.

Fichier de type ASCII
Une ligne par transaction
Chaque champ est séparé par un caractère « ; »
La valeur des champs ne peut contenir « ; »
Toutes les dates sont au format « YYYY/MM/DD HH:MI:SS.FFF » sauf précisé dans le tableau. Par exemple : « 2015/01/01 15:30:22.000 ».
Les montants exprimés dans la plus petite unité de la devise
Les codes devise sont exprimés sur 3 digits de la norme ISO 4217 (http://en.wikipedia.org/wiki/ISO_4217)

La structure du fichier CSV est en standard :

une ligne d'entête : qui présente les noms des colonnes
la liste des transactions remises

En option, il est possible de générer le fichier CSV avec le format suivant :

Une ligne d'entête qui présente les informations de synthèse du fichier
La liste des transactions remises
Une ligne d'en-queue qui récapitule le nombre de transactions qui doivent être présentes dans le fichier

En standard, la ligne d'entête contient les données suivantes :

Attribut	Type	Lg max	Format	Valeur ou description
rejectDate	R	20	N	Date de rejet
rejectAmount	R	12	AN	Montant de rejet
rejectReason	C	20	AN	Raison du rejet
rejectDescription	C	100	AN	Description du rejet tronquée sur 100 char

Légende : R = requis, F = facultatif, C = conditionnel

Ce paragraphe décrit le format des fichiers image de remise CSV. Ce format est très utile pour mettre à jour votre système d'information. Vous avez également la possibilité de consulter ce fichier en l'ouvrant dans Excel.

Fichier de type ASCII
Une ligne par transaction
Chaque champ est séparé par un caractère « ; »
La valeur des champs ne peut contenir « ; »
Toutes les dates sont au format « YYYY/MM/DD HH:MI:SS.FFF » sauf précisé dans le tableau. Par exemple : « 2015/01/01 15:30:22.000 ».
Les montants exprimés dans la plus petite unité de la devise
Les codes devise sont exprimés sur 3 digits de la norme ISO 4217 (http://en.wikipedia.org/wiki/ISO_4217)

La structure du fichier CSV est en standard :

une ligne d'entête : qui présente les noms des colonnes
la liste des transactions remises

En option, il est possible de générer le fichier CSV avec le format suivant :

Une ligne d'entête qui présente les informations de synthèse du fichier
La liste des transactions remises
Une ligne d'en-queue qui récapitule le nombre de transactions qui doivent être présentes dans le fichier

En standard, la ligne d'entête contient les données suivantes :

Bloc de code

language	text
linenumbers	true

Type;MerchantName;MerchantID;PointOfSellName;PaymentTypeCode;AcquierName;ContractNumber;ContractDescription;CurrencyCode;OrderReference;OrderDescription;TransactionID;AcquierTransactionReference;OperationTypeCode;CaptureFileDate;AuthorizationNumber;AuthorizationAmount;AuthorizationCurrencyCode;AuthorizationDate;AuthorizationOrigin;Pan;3dsecure;AVS;CaptureDate;CaptureOrigin;CaptureAmount;FileNumber;OperationTypeCode;SettleDate;GrossAmount;FeeAmount;ChargeBackDate;ChargeBackAmount;ChargeBackReason;ChargeBackDescription

En option, il est possible de générer une ligne d'entête qui aura le format suivant

Nom de colonne	N° col	Type	Lg max	Format	Valeur ou description
type	1	R	6	A	Type de ligne : HEADER
name	2	R	100	AN	Nom du fichier
date	3	R	20	AN	Horodatage local du fichier au format YYYY/MM/DD HH:MM:SS
version	4	R	10	AN	Version du fichier. (Par exemple : 4.0.1)
sequence	5	R	6	N	N° séquentiel du fichier incrémenté de 1 à chaque fichier

Légende : R = requis, F = facultatif, C = conditionnel

Bloc de code

language	text
linenumbers	true

Type;MerchantName;MerchantID;PointOfSellName;PaymentTypeCode;AcquierName;ContractNumber;ContractDescription;CurrencyCode;OrderReference;OrderDescription;TransactionID;AcquierTransactionReference;OperationTypeCode;CaptureFileDate;AuthorizationNumber;AuthorizationAmount;AuthorizationCurrencyCode;AuthorizationDate;AuthorizationOrigin;Pan;3dsecure;AVS;CaptureDate;CaptureOrigin;CaptureAmount;FileNumber;OperationTypeCode;SettleDate;GrossAmount;FeeAmount;ChargeBackDate;ChargeBackAmount;ChargeBackReason;ChargeBackDescription

En option, il est possible de générer une ligne d'entête qui aura le format suivant

LIGNE si réconciliation non demandée, CAP, SET, CBK, REJ.
merchantName	2	R	100	AN	Enseigne du commerçant.
merchantID	3	R	14	N	Identifiant commerçant.
PointOfSellName	4	R	50	AN	Intitulé de l'enseigne.
paymentTypeCode	5	R	20	AN	Code du moyen de paiement associé.
acquierName	6	R	30	N	Nom de l'acquéreur du commerçant.
contractNumber	7	R	50	AN	N° contrat commerçant accepteur.
contractDescription	8	R	30	AN	Intitulé du contrat commerçant.
currencyCode	9	R	3	N	Devise principale.
orderReference	10

Nom de colonne

N° col

Type

Lg max

FormatOption

Valeur ou description

Type

1

R

6

A

Type de ligne : LIGNE si réconciliation non demandée, CAP, SET, CBK sinon.

merchantName

2

R

100

AN

Enseigne du commerçant

merchantID

3

R

14

N

Identifiant commerçant

PointOfSellName

4

R

50

AN

Intitulé de l'enseigne

paymentTypeCode

5

R

20

AN

Code du moyen de paiement associé

acquierName

6

R

30

N

Nom de l'acquéreur du commerçant

contractNumber

7

R

50

AN

N° contrat commerçant accepteur

contractDescription

8

R

30

AN

Intitulé du contrat commerçant

currencyCode

9

R

3

N

Devise principale

orderReference

10

R

50

AN

1

Référence de la commande

orderDescription

11

F

60

AN

1

Description de la commande

transactionID

12

R

50

AN

1

ID de la transaction d'autorisation initiale généré par Payline

acquierTransactionReference

13

C

12

AN

1

Référence archivage généré à partir de la référence commande et respectant les contraintes de format de l'acquéreur.

Champs valorisés uniquement si type=CAP ou LIGNE

operationTypeCode

14

C

1

A

1

Code opération D pour débit ou C pour crédit (cette colonne est aussi utilisée pour le CBK)

captureFileDate

15

C

25

AN

1

Date de la remise

authorizationNumber

16

C

6

AN

1

N° autorisation

authorizationAmount

17

C

12

N

1

Montant de l'autorisation

authorizationCurrencyCode

18

C

3

N

1

Devise de l'autorisation

1	Référence de la commande.
orderDescription	11	F	60	AN	1	Description de la commande.
transactionID	12	R	50	AN	1	ID de la transaction.
acquierTransactionReference	13	C	12	AN	1	Référence archivage généré à partir de la référence commande et respectant les contraintes de format de l'acquéreur.
Champs valorisés uniquement si type=CAP ou LIGNE
operationTypeCode	14	C	1	A	1	Code opération D pour débit ou C pour crédit (cette colonne est aussi utilisée pour le CBK).
captureFileDate	15	C	25	AN	1	Date de la remise.
authorizationNumber	16	C	6	AN	1	N° autorisation.
authorizationAmount	17	C	12	N	1	Montant de l'autorisation.
authorizationCurrencyCode	18	C	3	N	1	Devise de l'autorisation.
authorizationDate	19	C	25	AN	1	Date de la transaction d'autorisation.
authorizationOrigin	20	C	50	AN	1	Origine de la transaction d'autorisation.
Pan	21	C	19	N	1	Numéro de carte masqué selon règles PCI/DSS.
3DSecure	22	C	1	N	1	Sécurisation par 3DSecure 0=non et 1=oui.
AVS	23	C	1	N	1	Sécurisation par vérification d'adresse postale AVS 0=non et 1=oui.
captureDate	24

authorizationDate

19

C

25

AN

1

Date de la transaction

d'autorisation

authorizationOrigin

de validation.
captureOrigin	25

20

C

50

AN

1

Origine de la transaction

d'autorisation

Pan

de validation.
captureAmount	26

21

C

19

12

N

1

Numéro de carte masqué selon règles PCI/DSS

3DSecure

22

C

1

N

1

Sécurisation par 3DSecure 0=non et 1=oui

AVS

23

C

1

N

A

1

Sécurisation par vérification d'adresse postale AVS 0=non et 1=oui

Code opération D pour débit ou C pour crédit.
settleDate	29

captureDate

24

C

25

AN

1

Date de la

transaction de validation

captureOrigin

réconciliation.
grossAmount	30

25

C

50

12

AN

N

1

Origine

Montant brut de la transaction

de validation

.

captureAmount

feeAmount

26

31

C

12

N

1

Montant brut de la remise (avant déduction des commissions)

Commission sur la transaction.
ifr	32

FileNumber

27

C

50

16

N

2

3

Numéro du lot de remise.

Montant de l'interchange IFR.
Présent uniquement si l'option

« FileNumber »

« IFR » est demandée.
Champs valorisés uniquement si type=

SET

CBK et

option réconciliation demandé (cf.

Option réconciliation bancaire

chap 6)

operationTypeCode

chargebackDate

28

33

C

1

25

A

1

Code opération D pour débit ou C pour crédit

Date de l'impayé
chargebackAmount	34

settleDate

29

C

25

12

AN

1

Date de la réconciliation

Montant de l'impayé
chargebackReason	35

grossAmount

30

C

12

20

N

AN

1

Montant brut de la transaction

feeAmount

Code de l'impayé
chargebackDescription	36

31

C

12

100

N

AN

1

Commission sur la transaction

ifr

La description de l'impayé est limitée à 100 caractères
chargebackNumber	37

32

C

16

N

AN

3

4

Montant de l'interchange IFR.
Présent uniquement si l'option « IFR » est demandée.

N° de dossier rattaché à l’impayé. Présent uniquement si l’option « charge_back_number» est demandé
Champs valorisés uniquement si type=

CBK et option réconciliation demandé

REJ et contrat spécifique* (cf

. chap 6

liste)

chargebackDate

rejectDate

33

R

C

20

25

N

A

1

Date de

l'impayé

chargebackAmount

34

rejet.
rejectAmount		R

C

12

AN

1

Montant

de l'impayé

chargebackReason

35

du rejet.
rejectReason		C	20	AN

1

Code de l'impayé

chargebackDescription

36

	Code du rejet.
rejectDescription		C	100	AN

1

La description de l'impayé est limitée à 100 caractères

chargebackNumber37C16AN4N° de dossier rattaché à l’impayé. Présent uniquement si l’option « charge_back_number» est demandé

Description du rejet tronquée sur 100 caractères.

Légende : R = requis, F = facultatif, C = conditionnel

*Contrat spécifique = Cette fonction n'est pas supportée par tous les moyens de paiement et acquéreur.

En version standard, cette ligne n'existe pas.
En option, il est possible de générer une ligne d'en queue qui aura ce format.

Nom de colonne	N° col	Type	Lg max	Format	Valeur ou description
Type	1	R	6	A	Type de

ligne

ligne : FOOTER.
captureNumber	2	R	8	N	Nombre total de transactions remises dans le fichier.
settlementNumber	3	R	8	N	Nombre total de transactions réconciliées dans le fichier.
chargebackNumber	4	R	8	N	Nombre total de transactions impayées dans le fichier.

Légende : R = requis, F = facultatif, C = conditionnel

Les données liées aux commissions bancaires sont conditionnées par la fourniture de l'information par l'organisme financier et la souscription de cette option auprès de Payline.
La référence archivage (acquierTransactionReference) est par défaut les x premiers caractères de la référence commande communiquée par le commerçant dans la demande d'autorisation. En fonction des contraintes liées aux acquéreurs, x varie entre 10 et 12 des contraintes liées aux acquéreurs, x varie entre 10 et 12 caractères. Les caractères non strictement alphanumériques (autres que [a-z][A-Z][0-9]) sont supprimés de la référence commande avant le découpage à X caractères.
En option, Payline peut appliquer une règle qui permet de déduire la référence commande à partir de la référence archivage. Ainsi, le rapprochement entre la transaction remisées et la commande chez le commerçant est facilitée.

Ancre

	Option réconciliation bancaire
	Option réconciliation bancaire

Ancre

	option
	option

Dans le cas où vous ne souscrivez pas à l'option « Réconciliation bancaire », disponible dans la gestion de votre abonnement depuis le centre d'administration, vous aurez accès uniquement (dans les fichiers XML et CSV) a l'arborescence nominale du fichier image de remise c'est-à-dire les éléments de type « CAPTURE » (Cf. 3 .5)
Dans le cas où le commerçant a souscrit à l'option « réconciliation bancaire », il aura également accès à l'arborescence contenant les éléments « SETTLEMENT » et « CHARGEBACK » dans le fichier XML. Pour le fichier CSV, les lignes de transactions pourront contenir des éléments de type « SET » et « CBK ».

Le numéro du lot de remise sera retourné par l'acquéreur. Cette option doit être demandée lors de la mise en place du fichier.
Si l'option n'est pas demandée, alors les informations suivantes seront avancées d'une position.

Le montant de l'interchange sera retourné par l'acquéreur. Cette option doit être demandée lors de la mise en place du fichier.
Si l'option n'est pas demandée, alors les informations suivantes seront avancées d'une position.

Le montant de l'interchange sera retourné par l'acquéreur. Cette option doit être demandée lors de la mise en place du fichier.
Si l'option n'est pas demandée, alors les informations suivantes seront avancées d'une position.

Les captures et settlements sont dans le même sens :

	CAPTURE	SETTLEMENT
Paiement	C	C
Remboursement	D	D

Opérations	Fichier des transactions	Fichier des paiements	Débit/crédit
Autor (doAutor, action=100)	Autor	-	-
Autor + Validation (doAutor, action=101)	Autor (101)Validation	CAP (J+1)SET (J+2)	C C
Validation (doCapture, action=201)	Validation	CAP (J+1)	C
Autor (doAutor, action=100)Cancel (doReset : avant la validation)	AutorAnnulation	-	-
Autor (doAutor, action=100)Validation (doCapture, action=201)Remboursement (doReund, action=421 : après la validation)	AutorValidationRemboursement	CAP (J+1)SET (J+2) CAP (J+2) SET (J+2)	C CD D
Autor (doAutor, action=100)Validation (doCapture, action=201) Chargeback	AutorValidationImpayé	CAP (J+1)SET (J+2)CBK	C CD
Débit (doDebit, action=204 : opération non garantie)	Débit	CAP (J+1)SET (J+2)	C C
Crédit (doCredit, action=422 : opération non garantie)	Crédit	CAP (J+1)SET (J+2)	D D
Order (commande Paypal)
Ré-autorisation (action.202)	Autor Autor	-	-

Pour certains moyens de paiement, les frais sont présentés dans le fichier de réconciliation dans une ligne de type SET.

Inclusion d'extrait

	Gestion des frais
	Gestion des frais
nopanel	true

Attribut	Type	Lg max	Format	Valeur ou description
NamepaymentTypeCode	R	10020	AN	Enseigne du commerçant	Code du moyen de paiement associé
acquierNameId	R	1430	N	Identifiant Nom de l'acquéreur du commerçant
posNumbercontractNumber	R	50	8	N	Nombre de point de vente dans le fichier

Montant brut de la remise (avant déduction des commissions).

FileNumber

Numéro du lot de remise. Présent uniquement si l'option « FileNumber » est demandée.

Champs valorisés uniquement si type=SET et
option réconciliation demandé (cf. Option réconciliation bancaire)

operationTypeCode