Skip to main content
This guide covers how to migrate customers and their vaulted payment methods from Stripe to Supercycle.

​
Prerequisites

Before starting the migration, ensure you have:
  • Completed the migrations overview requirements
  • Access to your Stripe dashboard to export customer data
  • The Stripe import feature enabled for your store
The Import from Stripe option is not enabled by default. Contact Supercycle support to request this feature be enabled for your store before proceeding.

​
Export customers from Stripe

Export your customer data from Stripe including their payment method information.
1

Go to Stripe dashboard

Navigate to Customers in your Stripe dashboard.
2

Export customer data

Click Export and download a CSV file containing your customer records.
3

Prepare the CSV

Ensure your CSV includes the following columns:
ColumnDescriptionRequired
idThe Stripe customer ID (e.g., cus_xxx)Yes
emailCustomer email addressYes
nameCustomer full nameYes
card_idThe Stripe payment method ID (e.g., pm_xxx)No

​
Import customers to Supercycle

Once you have your CSV file ready, import it into Supercycle.
1

Open the import modal

In Supercycle, navigate to Settings > Migrations and select Import from Stripe.
2

Upload your CSV

Upload the CSV file exported from Stripe.
3

Map columns

Supercycle will automatically detect and map the columns. Verify the mappings are correct:
  • id → Stripe ID
  • email → Email
  • name → Name
  • card_id → Card ID (optional)
4

Preview and import

Review the preview to ensure the data looks correct, then click Import to begin the migration.

​
What happens during import

For each row in your CSV, Supercycle will:
  1. Find or create the Shopify customer by email address
  2. Link the Stripe payment method to the Shopify customer using Shopify’s remote payment method API
  3. Store the payment method locally for future billing
If a customer with the same email already exists in Shopify, Supercycle will link the Stripe payment method to the existing customer rather than creating a duplicate.

​
After the import

Once the import is complete:
  • Customers will appear in your Shopify admin and Supercycle
  • Payment methods will be available for subscription and membership billing
  • You can begin creating subscriptions or memberships for the imported customers

​
Troubleshooting

Problem
The import fails with “multiple Shopify customers were found”.Why it happens
You have duplicate customer records in Shopify with the same email address.How to fix it
Merge or remove the duplicate customers in Shopify before retrying the import.
1

Find duplicates in Shopify

In Shopify Admin, go to Customers and search for the email address.
2

Merge or delete duplicates

Keep one customer record and merge or delete the others.
3

Retry the import

Run the Stripe import again.
Problem
The payment method from Stripe is not linking to the customer.Why it happens
The card_id in your CSV is using a legacy card token (starting with card_) instead of a payment method ID (starting with pm_).How to fix it
Convert legacy card tokens to payment methods in Stripe before importing.
1

Identify legacy tokens

Check your CSV for any card_id values starting with card_.
2

Convert in Stripe

In Stripe, convert the legacy card tokens to payment methods using the Stripe API or dashboard.
3

Update your CSV

Replace the card_ values with the new pm_ payment method IDs.
4

Retry the import

Upload the updated CSV and run the import again.