payment-gateways

How do I migrate my customers’ card details to my Stripe account and map them to my customers in Zoho Subscriptions to collect charges automatically? 

Here are some cases where this FAQ could help you: 

Migrating your customers’ card details 

Before you start using the Stripe integration to collect charges, you have to move your customers’ card details from your existing payment gateway or subscription management system, and import them into your Stripe account. 

To do this, you need to contact your current payment processor, and ask them to get in touch with Stripe’s support team. Next, Stripe’s team will co-ordinate with your current payment processor and help migrate your customers’ card details to Stripe.

Similarly, if you want to move your customers’ card details from one Stripe account to another, you must contact Stripe’s support team and they’ll help you with it. 

Once your customers’ card details have been migrated to your Stripe account, you need to set up the Zoho Subscriptions - Stripe integration and map these card details to your customers in Zoho Subscriptions. 

Importing your customers into Zoho Subscriptions

(Skip this section if you already use Zoho Subscriptions and just want to import your customers’ card details from Stripe.)

If you’re moving to Zoho Subscriptions from a different system, you can import your customers into Zoho Subscriptions. You can also create customers manually, if you wish to do so.

After this, you can proceed to set up the Stripe integration and map your customers’ card profiles to your customers. 

Importing your customers’ Stripe card profiles into Zoho Subscriptions

Prerequisite: Set up the Zoho Subscriptions - Stripe integration with the Stripe account that has your customers’ card details.

To collect payments automatically using Stripe in Zoho Subscriptions, you must import your customers’ card profiles (tokens) into Zoho Subscriptions. To do this:

Now, a CSV export file will be downloaded with the customer details that you selected. 

This export file needs to be imported into Zoho Subscriptions, in order to map it with your customers. 

To do this, visit the following link:

https://subscriptions.zoho.com/app#/customers/stripecustomerimport

Note: Access to the card import UI via this link will not be available by default. To access the card import UI, write to us at support@zohosubscriptions.com. 

Warning: This process will differ if you’re trying to switch your customers’ card details from one Stripe account to another Stripe account in Zoho Subscriptions. In this case, write to us at support@zohosubscriptions.com to learn how you can proceed.

Once you’ve gained access, visit the link, select your exported CSV file, and click Next.  

You’ll now be faced with a mapping screen. The columns from the export file would be mapped with the fields in Zoho Subscriptions automatically. If not, you can select the column headers manually.

Stripe Card Export

Pro Tip: The fields Tax NameTax PercentageTax TypeExemption Reason, and Tax Authority are optional and will not be available in the export file from Stripe. These fields are not related to your customers’ card details and are part of the Customers module. So, if you’re planning to create new customers in Zoho Subscriptions via the card import process, filling these fields up manually in your export file can help save you time in the future.

When you’re ready to import, click Next. Check the summary of your import on the next screen, and click Import.

Now, your card profiles from Stripe will be imported and mapped to your customers in Zoho Subscriptions, provided that certain conditions are met (read notes below).

Important notes about mapping card profiles:

Now, all you have to do is associate these payment methods to your customers’ subscriptions to collect charges for them automatically. 

Warning: The card profiles in Zoho Subscriptions have a 2-way sync with Stripe. So, if you delete your customers’ Stripe card details in Zoho Subscriptions, their card details will be deleted in Stripe as well. Because of this, we strongly recommend to import your customers’ card profiles from Stripe only for live organizations and not for test organizations in Zoho Subscriptions. 


Was this document helpful?
Yes
No
Thank you for your feedback!
Want a feature?
Suggest
zoho subscriptions

Uncomplicate Subscription Billing for your business.