SubPorter

Getting started

Check whether your migration is a fit for SubPorter, and what to prepare before you open a migration project.

SubPorter does one job: migrate active subscriptions from one Stripe account to another while you stay on Stripe Billing. Use this page to check the fit and to prepare.

When SubPorter fits

  • The source and the destination are both Stripe accounts.
  • Most subscriptions are active and charge a saved payment method automatically.
  • The destination owner is ready to bill from the destination account.
  • You want a decision gate before any source subscription changes.
  • Your team updates the application, database, and webhooks separately.

Subscriptions that need a decision

SubPorter flags these before anything is scheduled. The source owner decides each one: move now, or leave for now.

  • Renews within 48 hours
  • No saved payment method, or no default payment method
  • Two customer records with the same email, each with an active subscription
  • Trial, past due, or already set to cancel
  • Coupon or discount
  • Manual tax rates, or billed by invoice
  • Already on a subscription schedule, or an unusual item shape

A flag does not stop the migration. It puts the decision in front of a person.

Subscriptions billed by invoice (send_invoice) are flagged and cannot move in the current version. Leave them for now.

Your first session

  1. Create a migration project. Name it, and choose your role: source owner or destination owner.
  2. Invite the other owner, or run both sides yourself.
  3. Connect the source account with a read-only restricted key from the one-click link.
  4. Run the scan. It reads every product, price, meter, customer, and active subscription. Nothing is written.
  5. Decide each flagged subscription.

The result is a plan, not a change. It shows what moves, what waits and why, and what must be true before SubPorter writes to the destination account. Everything in the first session is free.

Prepare

  • A source owner who can create a restricted key in the source account.
  • A destination owner who can create a restricted key in the destination account, or one person for both.
  • A migration window that ends more than 48 hours before most renewals.
  • A plan for who updates the application-side Stripe references.
  • A customer message, if you plan to tell subscribers.

On this page