How to Use SubMigrations

Follow these instructions to migrate your Stripe data successfully.

IMPORTANT: Migrate Customer Data First

Before using SubMigrations, you must first migrate your customer data directly in Stripe using their self-serve data copy service.

To migrate customer data in Stripe:

  1. Log into your source Stripe account and navigate to the Customers page
  2. Click "Copy customers" and select "Copy all customers" (or choose a partial copy method)
  3. Enter the account ID of your destination Stripe account
  4. The destination account must authorize and accept the copy request
  5. Once authorized, the copying process will begin (may take up to 72 hours)

For detailed instructions on copying customer data, visit the Stripe documentation.

Step 1: Account Setup

Add at least two Stripe accounts to your SubMigrations dashboard: one for the source (old) account and one for the destination (new) account.

🔒 Security Recommendation: Use Restricted API Keys

We strongly recommend creating Stripe restricted API keys for SubMigrations. Restricted keys allow you to grant only the specific permissions needed for migration, enhancing your account security.

Create your restricted keys directly in Stripe:

Restricted keys start with 'rk_' instead of 'sk_'. While standard secret keys will work, restricted keys are more secure.

Step 2: Create a Migration

Navigate to the "Migrations" section and click "New migration". Select your source and destination accounts, then choose which elements to migrate (Products & Prices, Coupons, and/or Subscriptions).

Step 3: Review and Pay

Review the migration details and the associated cost. Confirm and pay for the migration based on the number of items to be transferred.

Step 4: Run the Migration

Once payment is confirmed, start the migration process. Monitor its progress on the migration details page.

Step 5: Verify the Results

After the migration completes, verify the transferred data in your new Stripe account. Check the migration logs for any errors or issues that may require manual intervention.

Important Notes

  • Always backup your Stripe data before initiating a migration.
  • Customer data must be migrated separately through Stripe's self-serve data copy service before migrating subscriptions with SubMigrations.
  • SubMigrations cannot migrate customer data, only subscriptions and related objects that reference the already-migrated customers.
  • Some Stripe-specific IDs will change in the new account.
  • For complex setups, consider testing with a small subset of data first.