Migrazione dei dati verso un nuovo PSP
Questa guida è rivolta agli esercenti che attualmente operano con Open Payments di Fabrick e che sono interessati a migrare verso altri PSP (Payment Service Provider). Lo scopo di questa documentazione è di dare indicazioni sui formati di file condivisi e le modalità di condivisione.
Concetti fondamentali
Token carta
Un token carta è un identificativo univoco che sostituisce il PAN (Primary Account Number), cioè il numero stampato sulla carta di pagamento. La tokenizzazione consente di effettuare transazioni senza utilizzare direttamente il PAN, migliorando la sicurezza contro frodi e furti di dati.
Consulta l’articolo: “Tokenizzazione nei pagamenti e-commerce: cos’è e perché è utile”.
Pagamenti ricorrenti
I pagamenti ricorrenti sono transazioni effettuate con una frequenza regolare (es. abbonamenti mensili, rateizzazioni) senza che il cliente debba inserire ogni volta i dati della carta. Nei pagamenti MIT (Merchant Initiated Transaction), l’esercente avvia il pagamento in autonomia, basandosi su un'autenticazione avvenuta in precedenza.
Obiettivo della migrazione
Fornire tutti i dati necessari perché il nuovo gestore dei pagamenti possa continuare con i pagamenti ricorrenti esistenti e perché l’esercente possa beneficiare della libertà di scelta con continuità operativa
Esempi di file forniti
Formato dei file:
- Formato CSV con codifica UTF‑8
- Tutte le righe devono avere lo stesso numero di colonne
Migrazione di token PayPal
Esempio di file
Esempio di intestazione e prima riga:
TOKENVALUE;CREATEDATE;DELETED;DELETEDATE;REFERENCEID;AGREEMENTDESC
PPPXOEXXXXX8CBO3;1/17/2017 9:04 AM;0;;B-0C311XXXXXX344154M;edicola1@mail.com
Descrizione dei campi
| Campo | Descrizione |
|---|---|
| TOKENVALUE | Identificativo del token PayPal |
| CREATEDATE | Data di creazione del token |
| DELETED | Valore binario: 0/1 |
| DELETEDATE | Data di eventuale cancellazione. Può essere vuoto |
| REFERENCEID | Riferimento alla transazione PayPal |
| AGREEMENTDESC | descrizione testuale dell’accordo tra esercente e cliente. Spesso usato per indicare un riferimento dell’utente (ad esempio l’email) |
Migrazione di token carta
Esempio di file
Esempio di intestazione e prima riga:
IDTOKEN;IDSHOP;TOKENVALUE;TOKENTYPE;CARDNUMBER;EXPIRYMONTH;EXPIRYYEAR;CREATEDATE;DELETED;DELETEDATE;WITHAUTHORIZATION;WITHCVV;THREEDLEVEL;ONLYMASKEDPAN;IDGROUP;LASTABUUPDATEDATE
325XX397;160817;52MUOMYXXXEY4375;STD;522694XXXXX74375;09;26;4/2/2022 7:41 AM;0;;1;1;2;0;1864;
Descrizione dei campi
| Campo | Descrizione |
|---|---|
| IDTOKEN | Identificativo univoco del token in Fabrick |
| IDSHOP | Codice negozio Fabrick associato |
| TOKENVALUE | Token utilizzato in sostituzione del PAN |
| TOKENTYPE | Tipologia di token |
| CARDNUMBER | PAN della carta |
| EXPIRYMONTH | Mese di scadenza (MM) |
| EXPIRYYEAR | Anno di scadenza (YY) |
| CREATEDATE | Data di creazione (YYYY-MM-DD HH:MM:SS) |
| DELETED | Valore binario: 0/1 |
| DELETEDATE | Data di cancellazione |
| WITHAUTHORIZATION | Valore binario: 0/1 |
| WITHCVV | Valori ammessi: Y / N |
| THREEDLEVEL | Livello autenticativo 3DS |
| ONLYMASKEDPAN | Valore binario |
| IDGROUP | Gruppo token Fabrick |
| LASTABUUPDATEDATE | Data aggiornamento Automatic Billing Updater in formato (YYYY-MM-DD HH:MM:SS) |
Migrazione delle catene di pagamenti ricorrenti
Esempio di file
Esempio di intestazione e prima riga:
ID;IDSHOP;IDTOKEN;AUTH_DATA;AUTH_METHOD;AUTH_TIMESTAMP;ACS_TRANS_ID;BANKTRANSACTIONID;GLOBALPAYID;XID;FIRST_PAYMENT_ID;GATEWAY_FIRST;IDTRANSACTION_FIRST;IDCREDITCARDTRANSACTION_FIRST;RECOVERY;CREATED_DATE;RECURRING_TYPE;LAST_NEXT_DATE
234345;160817;9856927;;;;;-100;0;;f01c4eec-xxxx-4f29-b9e2-ea458286648b;I;689047016;1340432970;0;10/6/2022 2:04 PM;01;
Descrizione dei campi
| Campo | Descrizione |
|---|---|
| ID | Identificativo della catena ricorrente |
| IDSHOP | Store ID Fabrick |
| IDTOKEN | Token associato |
| AUTH_DATA | Dati di autenticazione (se presenti) |
| AUTH_METHOD | Metodo di autenticazione |
| AUTH_TIMESTAMP | Timestamp dell’autenticazione |
| ACS_TRANS_ID | Identificativo ACS 3DS |
| BANKTRANSACTIONID | ID lato negozio Fabrick |
| GLOBALPAYID | ID globale transazione Fabrick |
| XID | Identificatore GUID della catena |
| FIRST_PAYMENT_ID | ID del primo pagamento della catena |
| GATEWAY_FIRST | Entry point della transazione |
| IDTRANSACTION_FIRST | ID univoco della transazione che ha originato la catena |
| IDCREDITCARDTRANSACTION_FIRST | Riferimento credit card transaction |
| RECOVERY | true / false / Y / N / vuoto |
| CREATED_DATE | Data creazione (YYYY-MM-DD HH:MM:SS) |
| RECURRING_TYPE | 01 o 03 |
| LAST_NEXT_DATE | Data dell’ultima MIT eseguita. Può essere vuoto |
Sicurezza e invio dei file
Il file CSV deve essere criptato utilizzando la chiave pubblica fornita dal Payment Service Provider di destinazione, che dovrà fornire anche i dettagli dell’indirizzo del server sFTP e delle credenziali per permettere a Fabrick di depositare direttamente i file.
I dettagli per la connessione sono:
- nome del server
- porta
- utenza
Tempistiche previste
Una volta ricevuti i dati indicati nel capitolo “Sicurezza e invio”, Fabrick si impegna a fornire i dati al nuovo PSP nel minor tempo possibile. A seconda della quantità e dei dati da esportare, il processo può richiedere da alcuni giorni fino a diverse settimane.
Contatti
Per assistenza nella preparazione dei dati o nella configurazione dell’invio sicuro, contattare il team di supporto tecnico Fabrick