Migrating subscriptions from outside of Shopify (Woocommerce, BigCommerce, Magento, Custom solutions)

This document is meant to serve as a breakdown of the steps required for the Skio team to determine whether or not it is possible for Skio to migrate subscriptions from outside of Shopify into Shopify / Skio.

Important Considerations

1. The most important piece of information when attempting to migrate subscriptions from outside of Shopify into Shopify / Skio will be the payment processors currently used for the outside-Shopify store when processing subscription orders.
   
   A list of the Shopify supported subscription payment gateways can be found here: https://help.shopify.com/en/manual/products/purchase-options/subscriptions/shopify-subscriptions/considerations#supported-subscription-product-payment-gateways .
   
   If the payment gateway for your outside-Shopify store is NOT listed on this page, then it may not be compatible with the Shopify Subscriptions API. In this case, we recommend migrating the payment method data stored in your current incompatible payment gateway over to a compatible payment gateway such as Stripe or Authorize.net .
   
   If the payment gateway for your outside-Shopify store is listed on this page, then the Skio team will be able to get started with running a "test" to determine what percentage of subscriptions in your current platform may be able to be migrated into Shopify / Skio, as well as what percentage may not be able to be migrated due to missing payment method data.
    
2. Once the data migration into Shopify / Skio is complete, the merchant will be responsible for turning off all recurring billing in the outside-Shopify store, as well as ensuring that no new subscriptions can be created in the previous platform. This is to ensure that all future recurring billing takes place only in Shopify / Skio going forward.
    
3. Please note that the Skio team is not responsible for managing data changes that take place to subscriptions in the outside-Shopify store "accidentally" after the migration over to Shopify / Skio, such as the merchant's Customer Support team updating the outside-Shopify store mistakenly after the migration has been completed.

Timeline / Limitations

1. It is not a simple process for the Skio team to migrate subscriptions from an outside-Shopify store to Shopify / Skio; for this reason, we cannot accommodate "multiple" rounds of migrations in this way (ex. migrating customers / subscriptions on a regular basis).
    
2. It may take some time (anywhere from 1 to 3 weeks) for the Skio Launch team to process this kind of request. This has to do with our existing workload / processes, and cannot be expedited. The best way to expedite the process is by replying to emails promptly, with clear and concise questions / answers.
    
3. The Skio team is not able to migrate "Prepaid gift" subscriptions from outside-Shopify into Shopify / Skio at this time.

Requirements / Steps

1. All Customer accounts for subscribers in the outside-Shopify store must be exported from the current platform and imported into the new Shopify store: https://help.shopify.com/en/manual/customers/import-export-customers . 
    
2. The Skio team will need to run a "test" to determine what percentage of subscriptions in your current platform may be able to be migrated into Shopify / Skio, as well as what percentage may not be able to be migrated due to missing payment method data.
   
   In order to run this test, the Skio team will need:
   - CSV containing email addresses for 100% of current subscription customers
   - Payment processor of the outside-Shopify store to be connected to the Shopify store as a Primary or Secondary payment gateway
   - API keys for Stripe / CIM export from Authorize.net for mapping payment method data to each customer record
   
   Once this data has been provided, the Skio team will run the initial test and provide an analysis of success / failures to the merchant for review. 
   
   This is a REQUIREMENT before moving forward with the Skio front-end integration process.
    
3. Once the test has been run and the results have been approved by the merchant, the Skio team will generate a CSV for mapping all product data from the outside-Shopify store into Shopify product variants for the new Shopify store. 
   
   In order to move forward with the migration, the Skio team will request the merchant to fill out this CSV with the proper variant-mapping data (ex. if in store A, product B has id C and price D, what is the matching Shopify product variant id value and price in the new Shopify store). 
   
   The merchant will need to fill out this CSV and provide it to the Skio team for review prior to the data migration being completed. This is considered a verification by the merchant, and any errors in this CSV may cause discrepancies in the subscription data that is migrated. 
    
4. Depending on the payment processors used by the outside-Shopify store, the Skio team may require the merchant to provide Stripe API keys / Braintree API keys / Authorize.net CIM exports . 
   
   This data will be used to generate payment methods in the new Shopify store for each subscription customer using the following Shopify API mutation: https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/customerpaymentmethodremotecreate . 
    
5. The Skio team will provide a "data migration preview", which will detail the subscription data being migrated into the new Shopify store. The merchant will need to review and approve this data. 
   
   This is considered a verification by the merchant, and any errors in the data migration preview which are approved may cause discrepancies in the subscription data that is migrated.
    
6. Once the data migration preview has been approved, the Skio team will be able to complete the data migration into Shopify / Skio!
   
   At this time, the merchant will be responsible for turning off all recurring billing in the outside-Shopify store, as well as ensuring that no new subscriptions can be created in the previous platform. This is to ensure that all future recurring billing takes place only in Shopify / Skio going forward.