Getting Started

Product Catalog



Invoices, Credit Notes, and Quotes



Site Configuration

Data Privacy & Security

Data Operations

Reports and Analytics


Migrating Cards 

Migrating cards involve mapping card tokens from the new gateway to your customers in Chargebee.

Steps Involved 

1) In your Chargebee app, click Settings > Import and Export data > Raise a migration request.

2) Take the required action based on your use case:

Use Case Currently Using Moving To Action Required


Stripe, Braintree, Adyen or Auth.Net One of the other three gateways Request your current gateway to move your customers' card details to the new gateway's vault.
2. Stripe, Braintree, Adyen or Auth.Net Spreedly gateways If you have an existing process for transferring secure data (like an SFTP server), Spreedly can use this for data transfer. Send the SFTP credentials to Spreedly encrypted with Spreedly's key for accessing the server.

If you have no process in place for secure transfer, contact Spreedly. They can help you by setting up their own SFTP server. You need to provide Spreedly your public key so they can create a new server and encrypt credentials for you.
3. Spreedly gateways Stripe, Braintree, Adyen or Auth.Net If you are using any of the Spreedly gateways and moving to Adyen, it is the same SFTP server way mentioned in Use case 2.

In case you want to move to the other direct integration gateways, we can take care of that using Spreedly APIs.
4. Spreedly gateways Spreedly gateways Our Migration engineers can take care of it using Spreedly APIs.

3) Finally, send us an export of the Reference IDs(card tokens) from the new gateway, in CSV or JSON format. We would then import and map it to the associated customers in Chargebee.


  • The changes done in your Live site are irreversible. Hence, make sure you carefully review all data before Live site import.

  • While mapping the payment details to the imported subscriptions, any unpaid invoices other than current-term invoices will not be created and there will be no payment method validation.

  • You can move cards from PayPal Express Checkout only to Braintree, not to any other gateway vault.

Other Platforms 


PayPal Payflow Pro and PayPal Payments Pro are supported in Chargebee via Spreedly. Moving from the above two payment gateways to other Spreedly gateways follows the same steps as Use case 2.

Was this article helpful?