Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
OverviewSee all products
About the APIs
Start building
Create an account
Quickstarts
Start developing
Build with an LLM
Use Stripe without code
Migrate to Stripe
    Migrate customer data
    Migrate payment data
      Import payment data
        Payment method data imports
        Map payment data
        Upload supplementary data
      Export payment data
      Copy payment data
Common use cases
OverviewAccept simple payments as a startupSell subscriptions as a Saas startupBuild a subscriptions solution with usage-based pricingAccept payments in personSend invoices to collect payments
United States
English (United States)
HomeGet startedMigrate to StripeMigrate payment dataImport payment data

Map payment data

Map payment data to existing Stripe Customers.

Our standard process creates new customers alongside the payment method data from your previous provider. If you’ve been processing new transactions on Stripe during the migration, you might already have some customers in Stripe. Map imported payment data to these existing Stripe customers to avoid creating duplicates.

After you submit the migration intake form, reply in the same email thread with a CSV file that includes two columns:

  • old_customer_id: The unique identifier from your former processor.
  • stripe_customer_id: The corresponding Stripe customer ID in the cus_xxxx format.

To download a list of customers with their Stripe IDs:

  1. Go to the Customers section in the Stripe Dashboard.
  2. Filter the list based on your desired parameters.
  3. Click Export.
  4. Select the ID field for export.
  5. Export your list.

How it works

Shows the migration mapping process.

Example mapping file

old_customer_idstripe_customer_id
PSP_buyer_ID_1cus_NsKvEuOxdDP111
PSP_buyer_ID_2cus_Nrt6IryCjAK222
PSP_buyer_ID_3cus_OAiRfxde7Ya333

Customer data overwrite

Our current tooling preserves existing customer level data. Mapping doesn’t overwrite any information already present in the customer’s record. Rather, it appends data for any new cards that aren’t already included without altering the customer level information displayed in the Dashboard. If the data file flags a card as the default card, it overrides any previously set default cards in the Dashboard.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc