Migrazione degli abbonamenti 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:

Trasferimento del metodo di pagamento — Trasferimento sicuro dei dati sensibili della carta dal tuo attuale processore
Trasferimento dei dati degli abbonati — Esportazione dei dettagli dei clienti, dei piani di abbonamento e dei programmi di fatturazione
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. 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:

PCI DSS compliance verification

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) da condividere con il tuo processore attuale.

Dodo Payments integration

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.

Data access authorization

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

Request payment method export from your current processor

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.

Prepare subscriber data export

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

{
  "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"
      }
    }
  ]
}

Validation and testing

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.

Production import

Nella data di importazione concordata, il nostro team di ingegneria:

Importerà i dati del metodo di pagamento nel nostro Vault di Carte conforme al PCI
Importerà i tuoi dati degli abbonati
Abbinerà gli abbonati ai loro metodi di pagamento utilizzando i token della carta
Attiverà tutti gli abbonamenti migrati

Il tempo di elaborazione tipico è di 2-3 giorni lavorativi per migraciones standard, a seconda del volume di abbonati.

Post-migration verification

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:

Dodo Payments PGP Public Key

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:

Contact Support

Contattaci per iniziare la migrazione e metterti in contatto con un Solutions Engineer.

API Documentation

Esplora la nostra API per capire come funzionano gli abbonamenti in Dodo Payments.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Cos’è una migrazione degli abbonamenti?

Panoramica del processo di migrazione

Requisiti

Guida passo-passo alla migrazione

Dati degli abbonati richiesti

Formato dei dati di esempio

Dati migrabili

Crittografia PGP

Aspettative temporali

Inizia

Contact Support

API Documentation

​Cos’è una migrazione degli abbonamenti?

​Panoramica del processo di migrazione

​Requisiti

​Guida passo-passo alla migrazione

​Dati degli abbonati richiesti

​Formato dei dati di esempio

​Dati migrabili

​Crittografia PGP

​Aspettative temporali

​Inizia

Contact Support

API Documentation

Cos’è una migrazione degli abbonamenti?

Panoramica del processo di migrazione

Requisiti

Guida passo-passo alla migrazione

Dati degli abbonati richiesti

Formato dei dati di esempio

Dati migrabili

Crittografia PGP

Aspettative temporali

Inizia