We’re excited to help you transition from Recharge to Subi! To ensure a smooth migration, you’ll need to export specific data from Recharge and follow a few important pre-migration steps. Don’t worry, we’ll guide you through everything!
To prepare your migration data from Recharge for Subi, you can either share a Recharge API key so we retrieve your data automatically or export and send four specific reports. This guide explains when to use each method and the exact steps.
Before you start: For the complete end-to-end process, see How do I migrate my existing subscriptions to Subi?
When should I use this guide?
Use this guide after you’ve decided to migrate to Subi and completed any pre-migration preparation in your store (for example, installing Subi and recreating your plans). This ensures your export includes the correct data.
Method 1: Provide a Recharge API key (recommended)
If you provide a Recharge API key, Subi can retrieve your data automatically and prepare it for migration.
Steps:
Open the Recharge app.
Go to Tools & apps → API token.
Create a new API token, granting Read access to the relevant data.
Send your API key and API client secret to the Subi team via your migration ticket or our initial email thread.
Then we will retrieve your data and prepare it for migration to Subi. Please ensure you follow the Pre-Migration Preparation steps provided here.
Visual reference: Recharge API token creation (GIF)
Method 2: Export reports from Recharge (manual)
If you prefer manual export, send these four reports to the Subi team:
Subscriptions – All
Customers – Shipping Addresses
Customers – Payment Tokens
Used to identify the payment method for each subscription.
Orders – Processed
Ensure every Subscription ID has at least one corresponding order. If your data spans multiple years, export each year separately.
Important: If you have several years of data, export each year for Orders – Processed to avoid missing records during migration.
How to export reports in Recharge
In the Recharge merchant portal, select Data → Exports.
Click Create Exports.
Choose the export type (for example, Subscriptions – All).
(Optional) Enter a custom export name and your email address.
Click Create Export.
Payment methods and migration readiness
Your customers’ payment methods affect migration readiness. Make sure your subscriptions use an eligible processor:
Shopify Payments: If subscriptions already use Shopify Payments, you can proceed.
Stripe: If subscriptions use Stripe, review Migration Data Preparation – Stripe before proceeding.
Please check: Migration Data Preparation – StripeCustom checkouts: If subscriptions were created via custom checkouts, contact Recharge to convert payments to Shopify Payments; otherwise, existing subscriptions created via custom checkouts cannot be migrated to Subi.
For Shopify’s eligibility rules, see What are Shopify’s eligibility requirements for selling subscriptions?
Knowing the payment method helps ensure a smooth transition for your subscribers, so be sure to double-check this information.
Next Steps
How do I migrate my existing subscriptions to Subi? — Review the full migration workflow and final checks.
Migration Data Preparation – Stripe — Follow the additional steps if your subscriptions use Stripe.
What are Shopify’s eligibility requirements for selling subscriptions? — Confirm supported payment processors and sales channels.
Need Help?
Feel free to contact our support team. We're here for you anytime:
Live Chat: Message us from within the Subi app or your Shopify Admin.
Email: Reach us at [email protected].