Contenu
L'insertion par fichier
Un batch permet l'insertion des éléments en masse dans des listes à partir d'un ou plusieurs fichier(s) envoyé par le commerçant.
Les éléments qui peuvent être insérés par batch dans les différentes listes sont les suivants :
Critère | Liste Blanche | Liste Grise | Liste Noire |
---|---|---|---|
Identifiant client | |||
Numéro de carte bancaire | |||
Compte E-Wallet | |||
Adresse IP du client | |||
Plage de BIN | |||
Plage adresse IP | |||
Adresse e-mail | |||
Numéro de téléphone | |||
Domaine de l'adresse email | |||
Nom du client |
Format du fichier
Les fichiers à traiter sont de format CSV et n'ont pas de header
Le séparateur utilisé dans le fichier CSV est le « ; »
Le format du nom du fichier doit être comme suit : List_nommarchant numerofichier_yyyymmdd_
Exemples :
- list_MonMarchand_1_20120510 : Le premier fichier envoyé par MonMarchand le 10/05/2012
- list_MonMarchand_2_20120510 : Le deuxième fichier envoyé par MonMarchand le 10/05/2012
Description du fichier
# | Nom | Descriptif | Format | Exemple | Obligatoire |
---|---|---|---|---|---|
1 | SEQUENCE_ID | Id de séquence, compteur unique. | Number | 001 | |
2 | MERCHANT_ID | Identifiant Payline du commerçant | Number | 53393424526750 | |
3 | ACTION | Traitement à effectuer avec les données de la ligne en lecture, en base de données. | String | Cf. Tableau ACTION | |
4 | LIST_TYPE | Libellé de la liste dans laquelle l'élément doit être ajout. | String | Cf. Tableau LIST_TYPE | |
5 | OBJECT_TYPE | Le Type d'élément à ajouter, supprimer ou mettre à jour. | String | Cf. Tableau OBJECT_TYPE | |
6 | OBJECT_VALUE | La valeur de l'élément à ajouter. | Alpha | Cf. Tableau OBJECT_VALUE | |
7 | PAYMENT_CARD_CODE | Code du moyen de paiement. | String | SKRILL ou PAYPAL | (1) |
8 | CARD_EXPIRATION_DATE | Date d'expiration de la CB. | MM/yyyy | 05/2013 | (2) |
9 | EXPLANATION_CODE | Code du motif d'ajout à une liste La création du motif est faite à partir du centre d'administration. | String | 1456 | |
10 | EXPIRATION_DATE | Date d'expiration de la règle. | dd/mm/yyyy hh :mm :ss | 01/08/2014 10:50:01 | |
11 | DISSOCIATION_CUSTOMER_CARD | Indicateur pour la dissociation des cartes/wallet et les clients : utiliser l'ACTION DELETE. | String (1) | Valeur : Y ou N | |
12 | ACCOUNT_DATE_CREATE | Date de création du compte client chez le commerçant. | dd/mm/yyyy hh :mm :ss | 01/08/2014 10:50:01 | |
13 | USER_ADD | Le compte de l'utilisateur qui a ajouté l'élément. | String(50) | user@payline.fr ou Payline_Batch | |
14 | COMMENT_DATA | Commentaire. | String (255) |
- si OBJECT_TYPE = ListCard
- si OBJECT_TYPE = ListBuyerEWallet
ACTION
Action | Descriptif |
---|---|
ADD | Insérer un élément dans une liste |
DELETE | Supprimer les éléments d'une liste |
UPDATE | Mise à jour d'un élément d'une liste |
LIST_TYPE
ListType | Descriptif |
---|---|
GreyList | Liste grise |
WhiteList | Liste blanche |
StandardList | Liste standard |
BlackList | Liste noire |
OBJECT_TYPE
ObjectType | Descriptif |
---|---|
ListCustomer | liste des identifiants des clients chez le marchand |
ListBuyerEWallet | liste des identifiants eWallet |
CustomerName | liste des noms de famille de clients |
ListCard | liste des numéros de cartes |
ListBinCard | liste des plages de BIN |
ListIp | liste des adresses IP |
ListRangeIp | liste des plages d'adresses IP |
ListEmail | liste des adresses email |
ListEmailDomain | liste des domaines d'adresses email |
ListPhoneNumber | liste des numéros de téléphone portable |
OBJECT_VALUE
ObjectValue | Format | Exemple | Descriptif |
---|---|---|---|
ListCustomer | String | 53393424526750, John@philo.com | Identifiant client |
ListBuyerEWallet | String | Pour Paypal :paylineuser@monext.fr | Compte e-wallet |
CustomerName | String | Dupont | Nom de famille |
ListCard | Number (19) | 1111222233334444 | Numéro de carte |
ListBinCard | String | 1111111111111111111-2222222222222222222 | Plage de Bin |
ListIp | String | 196.152.235.12 | Adresse IP |
ListRangeIp | String | 196.152.235.12-196.152.235.999 | Plage d'adresses IP |
ListEmail | String | Email d'un client | |
ListEmailDomain | String | gmail.com | Domaine email |
ListPhoneNumber | Number (14) | 0601020304 | Numéro de portable |
HEADER du fichier pour information mais à ne pas intégrer dans le fichier
SEQUENCE_ID;MERCHANT_ID;ACTION;LIST_TYPE;OBJECT_TYPE;OBECT_VALUE;PAYMENT_CARD_CODE;CARD_EXPIRATION_DATE;EXPLANATION_CODE;EXPIRATION_DATE;DISSOCIATION_CUSTOMER_CARD;ACCOUNT_DATE_CREATE;USER_ADD;COMMENT_DATA
Exemple du fichier
001;53393424526750;ADD;BlackList;ListCustomer;ronyCustomer0510;;;001;14/02/2013 10:00:00;;;Batch;ADD d'un customer ID; 002;53393424526750;UPDATE;BlackList;ListCustomer;ronyCustomer0510;;;001;14/02/2013 10:00:00;;;Batch; UPDATE d'un customer ID; 003;53393424526750;DELETE;BlackList;ListCustomer;ronyCustomer0510;;;001;14/02/2013 10:00:00;;;Batch; DELETE d'un customer ID; 004;53393424526750;ADD;BlackList;ListCard;111122223333444;;07/2012;001;14/02/2013 10:00:00;Y;;Batch; ADD d'un card; 005;53393424526750;UPDATE;BlackList;ListCard;111122223333444;;07/2012;001;14/02/2013 10:00:00;Y;;Batch; UPDATE d'un card; 007;53393424526750;ADD;BlackList;ListBuyerEWallet;rony@paypal.fr;SKRILL(MONEYBOOKERS);;001;14/02/2013 10:00:00;Y;;Batch; ADD d'un ewallet; 008;53393424526750;UPDATE;BlackList;ListBuyerEWallet;rony@paypal.fr;SKRILL(MONEYBOOKERS);;001;14/02/2013 10:00:00;Y;;Batch; UPDATE d'un ewallet; 009;53393424526750;DELETE;BlackList;ListBuyerEWallet;rony@paypal.fr;SKRILL(MONEYBOOKERS);;001;14/02/2013 10:00:00;Y;;Batch; DELETE d'un ewallet; 010;53393424526750;ADD;BlackList;ListIp;196.254.255.255;;;001;14/02/2013 10:00:00;Y;;Batch; ADD d'un IP; 011;53393424526750;UPDATE;BlackList;ListIp;196.254.255.255;;;001;14/02/2013 10:00:00;Y;;Batch;Update d'un IP; 012;53393424526750;DELETE;BlackList;ListIp;196.254.255.255;;;001;14/02/2013 10:00:00;Y;;Batch; DELETE d'un IP;