Subscription Migration to Dodo Payments

A subscription migration transfers your existing subscribers and their payment methods from your current processor to Dodo Payments. Your customers won’t need to re-enter payment details or experience any billing interruption.

We support migration for card tokens only. Apple Pay, Google Pay, and other wallet payment methods cannot be transferred between processors due to tokenization restrictions.

What Is a Subscription Migration?

A subscription migration transfers your existing subscribers from your legacy payment processor to Dodo Payments, giving you a single source of truth for all your customer data. Without a migration, customers you’ve acquired to date remain in your legacy system, and only new customers would be visible in Dodo Payments.

Migration Process Overview

The subscription migration process consists of three key parts:

Payment method transfer — Secure transfer of sensitive card data from your current processor
Subscriber data transfer — Export of customer details, subscription plans, and billing schedules
Import and validation — Unifying payment methods and subscriber data in Dodo Payments

To begin a subscription migration, contact our support team. They will connect you with a dedicated Solutions Engineer who will guide you through the entire process.

Requirements

Before initiating a migration, ensure you meet the following requirements:

PCI DSS compliance: Your current processor must be PCI DSS Level 1 compliant and able to export encrypted card data. Dodo Payments is PCI DSS Level 1 compliant. View our Attestation of Compliance (AOC) to share with your processor.
Dodo Payments integration: Complete your integration and route all new customers to Dodo Payments checkout before migrating. This prevents data inconsistencies.
Data access authorization: You have permission to export customer and payment data from your current processor. This typically requires account owner verification and completion of their security steps.

Step-by-Step Migration Guide

Request payment method export from your current processor

Contact your current payment processor’s support team and submit a formal request for a complete export of your customer card tokens.You will need to:

Provide verification of your identity and authorization
Request they encrypt the export using Dodo Payments’ PGP public key (provided below)
Ask them to transfer the encrypted file directly to our secure SFTP server

Your Solutions Engineer will provide the SFTP credentials to share with your current processor. On average, this process takes around 2 weeks, although timing varies depending on your current processor’s policies and response times.

Prepare subscriber data export

While the payment method transfer is in progress, export your subscriber data from your legacy system. Your Solutions Engineer will provide a CSV template and guide you through the required fields.

Required Subscriber Data

Field	Description
`customer_id`	Your internal customer identifier
`email`	Customer’s email address
`name`	Customer’s full name
`country`	Two-letter country code (ISO 3166-1 alpha-2)
`currency`	Three-letter currency code (ISO 4217)
`payment_amount`	Subscription amount in smallest currency unit
`payment_interval`	Billing frequency (monthly, yearly, etc.)
`next_billing_date`	Next scheduled billing date (ISO 8601)
`card_token`	Unique token from your current processor

The card_token field is critical—it’s used to match subscriber records with their payment methods during import. Ensure this matches exactly with the token in the payment method export.

Sample Data Format

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

Before the import date, our team will:

Verify file integrity and encryption of the payment method data
Validate your subscriber CSV for correct formatting
Run a test import in Test Mode
Identify and resolve any data mapping issues

You’ll receive a validation report confirming everything is ready for the production import.

Production import

On the agreed import date, our engineering team will:

Import the payment method data into our PCI-compliant Card Vault
Import your subscriber data
Match subscribers to their payment methods using the card tokens
Activate all migrated subscriptions

Typical processing time is 2-3 business days for standard migrations, depending on the volume of subscribers.

Post-migration verification

After the import completes, you’ll receive:

A comprehensive migration report
A CSV mapping your old subscription IDs to new Dodo Payments IDs
Access to all migrated customers in your Dodo Payments dashboard

We recommend:

Verifying a sample of migrated subscriptions in your dashboard
Testing a few subscription renewals in Test Mode
Updating your internal database references with the new IDs
Running parallel monitoring for the first billing cycle

Migratable Data

The following data can be transferred during a subscription migration:

Data type	Supported	Notes
Credit/debit card numbers	✅	Encrypted via PGP
Card expiration dates	✅
Cardholder names	✅
Billing addresses	✅
Customer email addresses	✅
Customer metadata	✅	Custom key-value pairs
Subscription details	✅	Plan, amount, interval
Apple Pay tokens	❌	Cannot be transferred
Google Pay tokens	❌	Cannot be transferred
Other wallet tokens	❌	Cannot be transferred
Payment history	❌	Export from your current processor

Payment history and transaction records cannot be migrated. We recommend exporting this data from your current processor for your records before completing the transition.

PGP Encryption

For maximum security when transferring sensitive card data, all files must be encrypted using our PGP public key. This provides an additional layer of protection beyond transport-level encryption. Share this key with your current payment processor for encrypting the card data export:

Dodo Payments PGP Public Key

Timeline Expectations

Phase	Duration
Initial setup and planning	1-2 days
Payment method transfer	~2 weeks
Subscriber data preparation	3-5 days (parallel)
Validation and testing	2-3 days
Production import	2-3 business days
Post-migration verification	1-2 days

The total migration typically takes 3-4 weeks from start to finish. Starting your subscriber data preparation while the payment method transfer is in progress helps minimize the overall timeline.

Get Started

Ready to migrate your subscriptions to Dodo Payments? Contact our team to begin the process:

Contact Support

Reach out to start your migration and get connected with a Solutions Engineer.

API Documentation

Explore our API to understand how subscriptions work in Dodo Payments.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

What Is a Subscription Migration?

Migration Process Overview

Requirements

Step-by-Step Migration Guide

Required Subscriber Data

Sample Data Format

Migratable Data

PGP Encryption

Timeline Expectations

Get Started

Contact Support

API Documentation

​What Is a Subscription Migration?

​Migration Process Overview

​Requirements

​Step-by-Step Migration Guide

​Required Subscriber Data

​Sample Data Format

​Migratable Data

​PGP Encryption

​Timeline Expectations

​Get Started

Contact Support

API Documentation

What Is a Subscription Migration?

Migration Process Overview

Requirements

Step-by-Step Migration Guide

Required Subscriber Data

Sample Data Format

Migratable Data

PGP Encryption

Timeline Expectations

Get Started