In this guide, we'll cover connecting your Stripe account to Shopify to migrate your existing customer payment methods so they can be used with Shopify's new subscription tools.

Requirements to migrate customer payment methods subscriptions

  • Your existing customer payment methods need to be stored in a Stripe account.

  • You'll need an export of your customer data from Stripe.

  • You'll need an export of your subscription data from your previous platform.

  • Shopify Payments needs to be connected as your main gateway in Shopify.

  • Stripe needs to be connected as a secondary gateway in Shopify.


Import customer data into Shopify (names, email, addresses)

First, import all your customers using Shopify's native import tool located on the customer's page in your Shopify account. In this step, you'll use the .csv import tool in Shopify to migrate basic data from your subscription customers to Shopify. This should include their names, email addresses, shipping addresses, etc. Alternatively, Shopify makes a store importer app that can assist with importing customer information.

Detailed instructions for this step can be found at the following link: https://help.shopify.com/en/manual/customers/import-export-customers

***Connect Stripe to your Shopify account****

Next, you'll need to ensure that Shopify Payments is configured and connect your Stripe account to Shopify using the following link.

- Stripe is no longer an option as a stand-alone gateway in Shopify. Only this link will connect Shopify to stripe for import

https://shopify.com/admin/payments/legacy_subscription

If your Shopify domain were my-coffee-co.myshopify.com, you would change the link like this:

https://my-coffee-co.myshopify.com/admin/payments/legacy_subscription


Detailed instructions for connecting Stripe you Shopify can be found here:

https://shopify.dev/tutorials/migrate-existing-subscription-contracts-to-shopify#connect-stripe-as-a-secondary-payment-gateway

Export your customer data from Stripe

Once you have imported your customer data and connected your Stripe account to Shopify, you'll need to export your customer data from Stripe and send it to a PayWhirl team member to process the import file. We need a .csv export from Stripe, or another system, that contains your customers' Stripe IDs, Card IDs, and Email addresses.

You will need to update the column headers in the spreadsheet you send to our team to the following values: stripe_customer_id, email, and stripe_payment_method_id before sending it to our team.


Note: If the Card ID values in your Stripe export are blank, this is most likely because the payment methods have not been "Set as default" in Stripe. You can fix this by using the UI in Stripe to set the payment methods to be the default before exporting or by exporting from another system that may have the default card ID saved.

Contact our team to process the import file

The last step is to connect with a PayWhirl team member through live chat or email team@paywhirl.com, so we can process your import. Our system will import and match the customers from Stripe with your existing customers using their email addresses (imported in the first step).

**Verifying the import worked**

During the import to Shopify, we do not have access to your stripe or payment data directly. We can only confirm that Shopify has received the payment information you gave us. There can be circumstances where Shopify vaults the card, but there are issues trying to charge the cards down the road. We highly recommend making a few live charges to reduce the chance of issues.

Migrating Subscriptions

Once the import is complete, you'll be able to re-create subscriptions for your customers (or create new subscriptions) using their existing payment methods from Stripe. You can use the create subscription tool in the PayWhirl app to ensure customers bill on the same schedule and with the same products or services they were subscribed to previously.

Detailed instructions for creating subscriptions can be found at the link below:

https://docs.paywhirl.com/PayWhirl/en/articles/4961656-how-to-subscribe-a-shopify-customer-to-a-product-in-your-store

If you have more than 50 active subscriptions to create, we can also assist by importing your legacy subscriptions. This process is in BETA. To learn more, please see the following link. https://docs.paywhirl.com/en/articles/5497441-how-to-migrate-active-subscriptions-to-shopify-in-bulk-with-paywhirl-2020-version

Related Articles:

If you have any questions, please reach out to our support team. We're happy to help.

Sincerely,

Team PayWhirl

Did this answer your question?