Stripe’s self-serve data copy service allows you to copy customer and payment data from one Stripe account to another Stripe account in the Dashboard.
A data copy involves two parties: the sender account and the recipient account.
- Sender account: The Stripe account currently storing the customer data. This is the account to copy the data from.
- Recipient account: The Stripe account where you want to store the customer data. This is the account to copy the data to.
Before beginning the copying process, the sender and the recipient must provide their account IDs to each other. If you’re the sender account, work with a user of the recipient account to share account IDs. If you’re the recipient account, work with a user of the sender account to share account IDs. Find your account ID by going to the User settings in the Dashboard while logged into your account.
Data copying considerations
Consider the following when copying data to a new account:
We can only copy data from one account to another. We can’t merge or move the data. After it’s complete, the copied data exists on both the destination and source accounts.
We only copy the raw Customer objects and associated payment data objects. The supported payment methods include cards stored as Card, Source, Payment method, and Bank account objects. We can’t copy Single Euro Payments Area (SEPA), BACs, or ACH records stored as payment method objects at this time.
The copy operation doesn’t change customer IDs, resulting in the same IDs for customers in both the destination and source account data.
The copy process assigns new object IDs of the same payment type to payment data. For example, the process assigns a new card object ID to all card objects and new payment method object IDs to all payment method objects. After the copy process is complete, Stripe creates and uploads a CSV mapping file to the Documents section of the recipient’s Dashboard. The mapping file is available to the recipient only. The mapping file contains the following headers:
Customer IDs don’t change during the copying process, so
customer_id_newhave the same value after the copy finishes.
source_id_oldis the old payment method ID from the sharing account, and
source_id_newis the new payment method ID from the recipient account.
Source account data remains intact. We recommend keeping the original source account as a backup for your data.
The recipient account must be an activated account. To activate the account, log in to the Dashboard and follow the prompts at the top-left of the home screen to activate payments.
You can’t copy deleted customers from the sharing account to the recipient account. After you delete a Customer, there’s no way to restore that customer.
If you delete a customer in the recipient account, a second copy doesn’t restore that customer.
During a second copy involving the same accounts and same customers, previously-copied Customer objects aren’t duplicated. The second copy copies over brand new Stripe Customer objects or new payment methods only for previously-copied Customer objects. If you delete a customer in the account, re-copying that customer from the sharing account doesn’t restore that customer.
The copy includes only Stripe Customer objects (
cus_xxx). We can’t copy Guest (
gcus_xxxx) customers—see Guest customers to learn more. Sender accounts must have Customer objects stored to process a data copy.
Accounts can perform up to 50 copies per day. Stripe limits copies to unauthorized accounts to one copy until the recipient account authorizes the first copy request.
Full or partial copy
You can perform a full or partial copy. A full copy sends all customers from the sender account. A partial copy sends a subset of customers from the sender account.
A partial copy entails sending a subset of customers from the sender account to the recipient account. There are two ways to complete a partial copy:
- Select customers in the Dashboard: Recommended for copies of less than 15 customers
- Upload a CSV file with a list of customer IDs: Recommended for copies of more than 15 customers
Copy into or out of a Connect account
If the sender account is a Connect account without access to the Stripe Dashboard, reach out to your contact at the Platform to let them know you need a data copy. The Platform account owner or Data Migration Specialist needs to follow these steps:
Partial copy with customer selection isn’t available for Connect accounts.
If the recipient account is a Connect account that doesn’t have access to the Stripe Dashboard, reach out to your contact at the Platform to let them know you need a data copy.
The Platform account owner, Admin, or Data Migration Specialist need to authorize and accept customer data from the sender after the sender shares it.
To authorize the data, the recipient logs into the Platform Stripe account, navigates to the Connect page, locates the Connect account where the customers were shared, and clicks Authorize and Accept on the banner in the Customers section.
If your customers are stored in a Platform account that you don’t own, inform your contact at the Platform that you need a data copy. Direct them to follow the steps to share your customers with the recipient account. Platform accounts typically store customers for several unrelated Connected accounts. Make sure the Platform account shares only your customers, by following the steps to do a partial copy.
If you’re an account owner or data migration specialist, you can view in-progress and completed copies by going to the Customers page and selecting Copy customers then Status page. You can toggle between Shared data and Received data.
For all other roles, you can view in-progress and complete copies on the copy status page.
On the Shared tab, you can see copies where your account was the sender account, sharing your customers to other accounts.
In progress copies are copies that are currently processing or where the sender account has initiated the copy, but the recipient hasn’t authorized and accepted it. For Pending copies, the recipient needs to authorize and accept the copy to proceed. Most In progress copies finish within 72 hours. Copies of fewer than 10,000 customers typically complete within a couple of hours.
Previously shared copies are copies that were successful or canceled from your account to another.
On the Received tab, you can see copies where your account was the recipient account, receiving customers from other accounts.
In progress copies are copies that are currently processing or where the sender account has initiated the copy, but you as the recipient haven’t authorized and accepted it. For Pending copies, you need to authorize and accept the copy to proceed. Most In progress copies in this state finish within 72 hours. Copies of fewer than 10,000 customers typically complete within a couple of hours.
Previously shared with you copies are copies that were successful or canceled from another account to your account.
Sharing permissions are the accounts that have previously shared their customers with you. For any future copies from these accounts to yours, the sender account still needs to share customer data with you, and you still need to accept the data. Authorized accounts see your business name when they enter your account ID during the sharing step.
View all navigates to the Authorized accounts page, which shows the accounts authorized to send you their data. You still need to accept the data copy requests from these accounts, but these accounts now have the ability to see your business name when they enter your account ID during the sharing step. You can revoke permission from any accounts in this list, which prevents them from seeing your business name during the sharing process. When revoked, future copy requests must be authorized and accepted. Only account owners, admins, and data migration specialists can add and revoke authorized accounts.
Only the account owner or a Data Migration Specialist can perform actions from the sender account. Only the account owner, an account admin, or a Data Migration Specialist can perform actions from the recipient account.
Learn how to add a team member as a Data Migration Specialist.
India account considerations
Data copies aren’t permitted between India Stripe accounts and accounts outside of India. There are regulations in India that require local storage of certain payments data. As part of our continued investment in India and to meet these requirements, we’re updating our systems and have reviewed the data migrations we offer to Stripe users. The data storage requirements prevent us from proceeding with the data copy you’ve requested. If you attempt to complete a copy between an India Stripe account and an account outside of India, you receive an error message stating that the copy isn’t permissible.
Tokenized cards aren’t copied.
Get Stripe support
If you run into issues or have any questions when completing the data copy, contact the Data Migration Team with this intake form. You must be logged in to your Stripe account before clicking this link.
In the intake form, for migration type, select Tell us about your other data migration use case, and fill out the form accordingly. If you’ve already initiated a data copy, provide the migration request ID associated with the copy request. The migration request ID is in the pending banner or the status page.