Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
OverviewExplore all products
Start building
Start developing
Sample projects
About the APIs
Build with LLMs
Use Stripe without code
Set up Stripe
Create an account
Web Dashboard
Mobile Dashboard
Migrate to Stripe
    Migrate customer data
    Migrate payment data
Manage fraud risk
Understand fraud
Radar fraud protection
Manage disputes
Verify identities
HomeGet startedMigrate to Stripe

Migrate your customer data to Stripe

Successfully migrate your customers' data to Stripe.

Copy page

Migrating your customer data to Stripe is a multi-step process. After you read through this guide, you’ll:

  • Understand the Stripe migration process.
  • Be able to scope the timeline for your migration.
  • Know the integration elements required for a successful migration.
  • Understand how to migrate payment details with minimal disruption to your users.

If you run into issues while trying to migrate customer data, contact Stripe support.

Build your integration

  • Develop your data migration plan, starting with new customers. Your end goal is to migrate 100% of new customers, then migrate existing customers.
  • Design a process for customers to update their card information.

Learn about the migration process

  • Review Stripe’s migration documentation.
  • Contact your previous processor to understand their migrations process.

Plan a migration and connect with an existing processor

  • Identify which payment details you want to migrate.
  • Identify which payment methods you want to migrate.
  • Find out how many customer records you want to migrate.
  • Plan a migration timeline that considers your previous processor, your customer count, and any upcoming deadlines.
  • Send the Stripe Migrations team details about your previous processor, Stripe account number, number of records to be migrated, and types of payment methods that you plan to import.

The Stripe Migrations team

  • Introduce your existing processor to Stripe’s Migrations team.
  • Complete any action items or provide any additional information requested by Stripe or your existing processor’s migrations team.

Migrate and update

  • Follow communication between Stripe and your previous processor to ensure your team is prepared.
  • Respond to any issues identified during migration.
  • Look for an email from the Stripe Migration team with the JSON mapping file.
  • Parse JSON mapping file and update your database accordingly.
  • Implement a process for customers to update their card information.
  • Design your remapping plan, and include subscription remapping where applicable.
  • Begin charging existing customers on Stripe.

PAN data

If you need to transfer sensitive payment information to or from another payment processor, or even between Stripe accounts, we can help you do so in a secure and PCI-compliant way.

The process differs depending on the type of transfer:

  • Transfer PAN data from one Stripe account to another Stripe account
  • Import PAN data to Stripe from another payment processor
  • Export PAN data from Stripe to another payment processor

For each type of data migration, we can only assist you if your request includes both customer records and the associated payment data. Use Stripe’s Customer API to create, update, or retrieve customer data that doesn’t include payment information.

Note

You can perform PAN data migrations without using Stripe’s Sigma or Data Pipeline products.

See also

  • The Customer object
  • The Subscription object
  • Default payment source
  • Products and prices
  • Billing cycle anchor
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc