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 |
|
| 8 | CARD_EXPIRATION_DATE | Date d'expiration de la CB. | MM/yyyy | 05/2013 | |
| 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;