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_
format.xxxx
To download a list of customers with their Stripe IDs:
- Go to the Customers section in the Stripe Dashboard.
- Filter the list based on your desired parameters.
- Click Export.
- Select the
ID
field for export. - Export your list.
How it works![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
![Shows the migration mapping process.](https://b.stripecdn.com/docs-statics-srv/assets/dm-mapping.5205a45bfb84e031c593db5525349ce2.jpg)
Example mapping file![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
old_customer_id | stripe_customer_id |
PSP_ | cus_ |
PSP_ | cus_ |
PSP_ | cus_ |
Customer data overwrite![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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.