All Collections
Multi-Platform Subscription App (Not for Shopify)
Configuring PayWhirl Settings For Your Business
How to import customers and migrate credit card data from other payment platforms.
How to import customers and migrate credit card data from other payment platforms.

You can import customers, billing information and credit card numbers from any payment gateway supported by PayWhirl.

Ryan P. avatar
Written by Ryan P.
Updated over a week ago

If you would like to migrate to PayWhirl from another payment platform and have existing customers in one of our supported payment gateways, you can import them with a few clicks from within the gateway settings page in your account.

Note: Currently, imports are only supported through Stripe, Braintree, and 

The example below shows how to import customers from Stripe but this can be done from any of our supported gateways from the settings page in PayWhirl:

Once you have connected your PayWhirl account to the same gateway your existing customers are in, you can use the import link on the gateway settings page in PayWhirl to import all of your customer information. If you are importing a lot of customers, make sure to click the 'run import in the background' checkbox.

After you've finished importing your customers into PayWhirl you can "map" your customers to existing payment plans in your account using their imported payment methods. 

Note: We are only able to pull in information that is saved in the gateway account through this method.

Sometimes it is the customer's billing info instead of shipping info that is imported into the account. If you are migrating over from another recurring payment system, you may want to export your customer's shipping information and use our import tool to fill in the missing info. If you go to the Manage Customer's page, you can upload a CSV with the correct info to update it. You can also click 'edit' and update their information manually.

A sample import file can be used as a guide to formatting the import correctly.

If all your customer's bill on the same day of the month, it's relatively easy to match prior billing scheduled because you can just use a billing cycle start date on the plan that you will be subscribing customers to in PayWhirl. This will make sure all START billing on the specific day of the month you'd like.

However, if your existing customers all bill on different days of the month and you'd like to keep them billing on the same days they billed prior to the migration, you will need to be careful to change the billing cycle start date on your plan as you go through your subscriptions.

For example... If half of your customers billed on the 5th of the month and half of your customers billed on the 20th, of each month you could do the following:

  1. Setup a PLAN with a billing cycle start date of the 5th

  2. Subscribe all the customers to the plan that should fill on the 5th

  3. Change the PLAN settings for billing cycle start date to be the 20th

  4. Subscribe all the customers to the plan that should fill on the 20th

  5. Repeat as necessary for all the different days your customer's bill.

To summarize, the process goes like this to migrate to PayWhirl:

  1. Get all your customers into a supported payment gateway.

  2. Import your customers using the gateway settings page in PayWhirl after you've connected to the gateway with your customers.

  3. Update your customers with any additional information through the customer import tool. 

  4. Map your imported customers to NEW plans in the system with the correct billing cycle start date set as you are doing the migration to ensure customers are billed on the correct day(s) of the month going forward.

You will also want to be careful about EMAILS that are sent when you subscribe customers to plans. You might want to disable one or more of the emails during the migration to make sure that customers are not notified of changes, etc.

Note: If you are a current client and switching payment gateways (say from Stripe to, you can now use the 'overwrite existing customers' option. This will import the clients from the new gateway and will keep all of the rest of their data so you won't have to resubscribe them. 

Related Articles:

Please let us know if you have any questions. 

The PayWhirl Team

Did this answer your question?