> ## Documentation Index > Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # Migrazione degli abbonamenti a Dodo Payments > Scopri come migrare i tuoi abbonati esistenti e i metodi di pagamento dal tuo attuale processore di pagamento a Dodo Payments. ## Cos'è una migrazione degli abbonamenti? Una migrazione degli abbonamenti trasferisce i tuoi abbonati esistenti dal tuo processore di pagamento legacy a Dodo Payments, fornendoti una fonte unica di verità per tutti i dati dei tuoi clienti. Senza una migrazione, i clienti acquisiti fino ad oggi rimangono nel tuo sistema legacy e solo i nuovi clienti sarebbero visibili in Dodo Payments. Il processo di migrazione garantisce un'esperienza di fatturazione senza interruzioni per i tuoi clienti: non dovranno reinserire i propri dati di pagamento né subire interruzioni nei loro abbonamenti. Attualmente supportiamo solo la migrazione per i **token delle carte**. Apple Pay, Google Pay e altri metodi di pagamento wallet non possono essere trasferiti tra i processori di pagamento a causa delle restrizioni di tokenizzazione imposte da questi fornitori. ## Panoramica del processo di migrazione Il processo di migrazione degli abbonamenti consiste in tre parti chiave: 1. **Trasferimento del metodo di pagamento** — Trasferimento sicuro dei dati sensibili della carta dal tuo attuale processore 2. **Trasferimento dei dati degli abbonati** — Esportazione dei dettagli dei clienti, dei piani di abbonamento e dei programmi di fatturazione 3. **Importazione e validazione** — Unificazione dei metodi di pagamento e dei dati degli abbonati in Dodo Payments Per iniziare una migrazione di abbonamento, contatta il nostro [team di supporto](mailto:support@dodopayments.com). Ti metteranno in contatto con un Solutions Engineer dedicato che ti guiderà durante l’intero processo. ## Requisiti Prima di avviare una migrazione, assicurati di soddisfare i seguenti requisiti: Dodo Payments è conforme a PCI DSS Livello 1. Per soddisfare gli obblighi di conformità, possiamo ricevere i dati delle carte solo da un processore di pagamento conforme a PCI DSS Livello 1. Il tuo attuale processore deve fornire: * La loro attuale Attestazione di Conformità PCI (AOC), o la loro registrazione nel Registro Globale dei Fornitori di Servizi di Visa * Conferma che supportano esportazioni sicure dei dati della carta Consulta la nostra [Attestazione di Conformità (AOC)](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf) da condividere con il tuo processore attuale. Completa l’integrazione con Dodo Payments e assicurati che tutti i nuovi clienti vengano indirizzati alla checkout di Dodo Payments prima di iniziare la migrazione. Ciò previene incoerenze nei dati durante il periodo di transizione. Assicurati di avere l’autorizzazione necessaria per richiedere un’esportazione dei dati dal tuo processore attuale. Questo di solito richiede: * Verifica del proprietario dell’account * Autorizzazione scritta per l’accesso ai dati sensibili * Completamento dei passaggi di verifica di sicurezza del tuo processore ## Guida passo-passo alla migrazione Contatta il team di supporto del tuo processore di pagamento attuale e invia una richiesta formale per un’esportazione completa dei token delle carte dei tuoi clienti. Dovrai: * Fornire verifica della tua identità e autorizzazione * Richiedere che l'esportazione venga crittografata utilizzando la chiave pubblica PGP di Dodo Payments (fornita di seguito) * Chiedere loro di trasferire il file crittografato direttamente al nostro server SFTP sicuro I trasferimenti sicuri avvengono direttamente da server a server via SFTP. Il tuo Solutions Engineer ti fornirà le credenziali SFTP da condividere con il tuo processore attuale. In media, questo processo richiede circa **2 settimane**, anche se i tempi variano in base alle politiche e ai tempi di risposta del tuo processore attuale. Mentre il trasferimento del metodo di pagamento è in corso, esporta i dati degli abbonati dal tuo sistema legacy. Il tuo Solutions Engineer ti fornirà un modello CSV e ti guiderà nei campi richiesti. ### Dati degli abbonati richiesti | Campo | Descrizione | | ------------------- | ------------------------------------------------------------ | | `customer_id` | Il tuo identificatore interno del cliente | | `email` | Indirizzo email del cliente | | `name` | Nome completo del cliente | | `country` | Codice paese di due lettere (ISO 3166-1 alpha-2) | | `currency` | Codice valuta di tre lettere (ISO 4217) | | `payment_amount` | Importo dell’abbonamento nell’unità più piccola della valuta | | `payment_interval` | Frequenza di fatturazione (mensile, annuale, ecc.) | | `next_billing_date` | Prossima data di fatturazione programmata (ISO 8601) | | `card_token` | Token univoco dal tuo processore attuale | Il campo `card_token` è fondamentale: viene utilizzato per associare i record degli abbonati ai loro metodi di pagamento durante l’importazione. Assicurati che corrisponda esattamente al token presente nell’esportazione del metodo di pagamento. ### Formato dei dati di esempio ```json theme={null} { "customers": [ { "customer_id": "cus_abc123", "email": "jane.doe@example.com", "name": "Jane Doe", "country": "US", "currency": "USD", "payment_amount": 2999, "payment_interval": "monthly", "next_billing_date": "2025-01-15T00:00:00Z", "card_token": "tok_xyz789", "metadata": { "plan": "pro", "signup_source": "website" } } ] } ``` Prima della data di importazione, il nostro team: * Verificherà l'integrità del file e la crittografia dei dati del metodo di pagamento * Validerà il tuo CSV degli abbonati per la corretta formattazione * Eseguirà un'importazione di prova nel nostro ambiente sandbox * Identificherà e risolverà eventuali problemi di mappatura dei dati Riceverai un report di validazione che conferma che tutto è pronto per l’importazione in produzione. Nella data di importazione concordata, il nostro team di ingegneria: 1. Importerà i dati del metodo di pagamento nel nostro Vault di Carte conforme al PCI 2. Importerà i tuoi dati degli abbonati 3. Abbinerà gli abbonati ai loro metodi di pagamento utilizzando i token della carta 4. Attiverà tutti gli abbonamenti migrati Il tempo di elaborazione tipico è di **2-3 giorni lavorativi** per migraciones standard, a seconda del volume di abbonati. Dopo il completamento dell’importazione, riceverai: * Un rapporto di migrazione completo * Un CSV che mappa i tuoi vecchi ID di abbonamento ai nuovi ID di Dodo Payments * Accesso a tutti i clienti migrati nel tuo dashboard di Dodo Payments Raccomandiamo di: * Verificare un campione di abbonamenti migrati nella tua dashboard * Testare alcuni rinnovi di abbonamenti in modalità sandbox * Aggiornare i riferimenti interni del database con i nuovi ID * Eseguire un monitoraggio parallelo per il primo ciclo di fatturazione ## Dati migrabili I seguenti dati possono essere trasferiti durante una migrazione degli abbonamenti: | Tipo di dato | Supportato | Note | | --------------------------------- | ---------- | --------------------------------------- | | Numeri di carte di credito/debito | ✅ | Crittografati tramite PGP | | Date di scadenza della carta | ✅ | | | Nomi dei titolari di carta | ✅ | | | Indirizzi di fatturazione | ✅ | | | Indirizzi email dei clienti | ✅ | | | Metadati dei clienti | ✅ | Coppie chiave-valore personalizzate | | Dettagli dell'abbonamento | ✅ | Piano, importo, intervallo | | Token Apple Pay | ❌ | Non possono essere trasferiti | | Token Google Pay | ❌ | Non possono essere trasferiti | | Altri token wallet | ❌ | Non possono essere trasferiti | | Storico dei pagamenti | ❌ | Esportazione dal tuo attuale processore | Lo storico dei pagamenti e le registrazioni delle transazioni non possono essere migrati. Ti consigliamo di esportare questi dati dal tuo processore attuale per i tuoi archivi prima di completare la transizione. ## Crittografia PGP Per la massima sicurezza durante il trasferimento di dati sensibili della carta, tutti i file **devono** essere crittografati utilizzando la nostra chiave pubblica PGP. Questo fornisce un ulteriore livello di protezione oltre alla crittografia a livello di trasporto. Condividi questa chiave con il tuo attuale processore di pagamento per crittografare l'esportazione dei dati della carta: ``` -----BEGIN PGP PUBLIC KEY BLOCK----- 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 1OSDhXaPYtJnVApUzaCrC5PJCXU= =nHcw -----END PGP PUBLIC KEY BLOCK----- ``` ## Aspettative temporali | Fase | Durata | | ---------------------------------------- | ------------------------- | | Configurazione iniziale e pianificazione | 1-2 giorni | | Trasferimento del metodo di pagamento | \~2 settimane | | Preparazione dei dati degli abbonati | 3-5 giorni (in parallelo) | | Validazione e test | 2-3 giorni | | Importazione in produzione | 2-3 giorni lavorativi | | Verifica post-migrazione | 1-2 giorni | La migrazione totale richiede in genere **3-4 settimane** dall’inizio alla fine. Iniziare la preparazione dei dati degli abbonati mentre il trasferimento del metodo di pagamento è in corso aiuta a ridurre al minimo la tempistica complessiva. ## Inizia Pronto a migrare i tuoi abbonamenti a Dodo Payments? Contatta il nostro team per iniziare il processo: Contattaci per iniziare la migrazione e metterti in contatto con un Solutions Engineer. Esplora la nostra API per capire come funzionano gli abbonamenti in Dodo Payments.