--- title: "Migrazione dei dati verso un nuovo PSP" description: "Come esportare da Fabrick i dati di carte e token verso un nuovo PSP: formati dei file condivisi e modalità di condivisione." url: "https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/features/token/migration/migration-out/" language: "it" --- # 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. > **Approfondimento** > > Consulta l’articolo: [*“Tokenizzazione nei pagamenti e-commerce: cos’è e perché è utile”*](https://www.fabrick.com/it-it/insight/blog/tokenizzazione-pagamenti-ecommerce/). --- ### 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. > **Documentazione** > > Consulta [*“Pagamenti ricorrenti – Fabrick Docs Payment Orchestra”*](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/features/recurring-payments/). --- ## 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: ```text 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: ```text 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: ```text 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 > **Portale di Assistenza Fabrick.**