Help for owners
I want to move my customers' saved cards from Braintree to Stripe
Short answer
Stripe imports saved customers and payment methods from your previous processor through its Data Migrations team. The old processor exports the data, encrypts it and uploads it to Stripe, which sends back a mapping file. Stripe cannot import card security codes or subscriptions. Start the export request early, because the old processor sets the pace.
Does this sound like your situation?
- I want to leave Braintree but not lose my customers' saved cards.
- Subscribers would have to re-enter payment details if I switch.
- Braintree support said they will take time to produce an export.
- My developer asked for a database of customer and card IDs I do not have.
- I do not know who is allowed to handle card data.
Why does this happen?
Card numbers cannot be sent by email or spreadsheet
Stripe states you should never send sensitive card details directly to it. Data is encrypted with Stripe's public PGP key and delivered over SFTP, and your previous processor performs the encryption and upload.
Confirmed by docs.stripe.com
The old processor sets the timeline
Stripe says processors can take anywhere from a few days to several months to produce the export, and some charge a fee or require specific forms. Stripe gives a standard processing time of 10 business days once it has received correct data.
Confirmed by docs.stripe.com
Some data never comes across
Stripe lists what it cannot import: card security codes, data your previous processor never stored, and subscriptions, invoices and other billing data. Subscriptions have separate tools, the Billing migration toolkit or the API.
Confirmed by docs.stripe.com
Your own database must be re-pointed
When the import ends, Stripe returns a mapping file linking old processor IDs to new Stripe IDs. Until your database is updated with it, your system still points at the old records.
Confirmed by docs.stripe.com
Switching can raise declines for a while
Stripe notes your account has its own merchant identifier, so issuers may not recognise it at first and you might see a temporary rise in declines. It recommends ramping up volume instead of switching everything at once, and sending one-time customer-initiated payments before recurring ones. If you also migrate subscriptions, Stripe warns that the previous ones must be cancelled as soon as the Stripe ones become active, or customers are billed twice.
Confirmed by docs.stripe.com
What can I do about it today?
- Ask your old processor for the export nowContact their support, in writing, and ask what they need from you. Stripe provides a sample message you can adapt.
- Do not close the old accountYou need it until the export is delivered and the new charges work. Closing it first can lose the data.
- Never email card data to anyoneNot to a developer, not to Stripe. If someone asks for card numbers in a file or a message, stop and check how it is to be sent.
- Open your Stripe account and set it upStripe says you need an account to start the request, and you can begin taking new customers on it while existing ones stay on the old processor.
- List your customers and subscriptionsCount them and note which have active subscriptions. You will use this to check the import.
When should I bring someone in?
- You have subscriptions that must keep billing on the same dates after the switch.
- Your app stores the old processor's customer IDs in many places.
- The old processor is slow, unclear or refusing to release the data.
How do I handle it?
- Inventory the old IDsI find every place your database and app use the old customer, card and subscription IDs.
- Prepare the mapping and the cut-overI write a plan for applying Stripe's mapping file, tested on a copy of your data, with a rollback step.
- Switch in stagesAs Stripe suggests, volume moves gradually: new customers first, then one-time payments, then recurring ones, watching declines.
- Check nobody is billed twiceI compare invoices and charges from both providers around the switch date and stop the old subscriptions in step with the new.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Can customers keep their saved cards?
Stripe can import saved payment details your previous processor provides. It cannot import data the processor never stored, or card security codes.
How long will it take?
Stripe gives 10 business days as the standard processing time once it has received correct data. The wait for the old processor's export can range from days to months.
Do I pay for the migration?
Stripe notes some processors charge a fee for the export. I cannot give figures; ask the processor and Stripe.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.