Migration ยท From Recurly

Migrate from Recurly without losing customers.

Recurly holds your recurring billing and recovery state. Azotte mirrors your accounts, subscriptions, and lifecycle first, runs alongside Recurly, then cuts over cohort by cohort. Recovery state and billing history are carried forward, not dropped.

Start with what must stay true.

A Recurly migration must protect access, renewal timing, cancellation state, coupon logic, recovery and grace-period state, and payment references. Azotte uses those invariants to shape the import and cutover order, so customers keep their subscription exactly as it was.

Mirror first. Cut over second.
What Moves

Keep the billing record. Move subscription control.

What Recurly holds today

  • Accounts, plans, and add-ons
  • Subscriptions, status, and renewal anchors
  • Invoices, coupons, and transaction history
  • Dunning, retries, and recovery state
  • Payment references and gateway links
  • Catalog and currency configuration

What moves into Azotte

  • Customer access and entitlements as the source of truth
  • Lifecycle across web, app stores, and partners
  • Plans and add-ons mapped to access bundles
  • Recovery that connects access, grace periods, and campaigns
  • PSP routing by region, storefront, or policy
  • Recurly IDs preserved for reconciliation and support
Migration Steps

Import, map, validate, then move.

Pull Recurly accounts, plans, subscriptions, invoices, and recovery state through the API. Mirror them in Azotte while Recurly keeps billing, then move customers in controlled cohorts.

  • Import customer, subscription, access, and payment data
  • Match old IDs to Azotte customer and subscription records
  • Check subscription status before switching storefronts or providers
  • Move by brand, market, storefront, or channel when needed
Migration pipeline: Source to Data enrichment to Customer to Run โ€” Ingest, Prepare, Decide, Act
Cohort Sequencing

Move by risk, not all at once.

A big-bang switch breaks subscriptions at the worst moment, usually at renewal. Group customers by risk and validate each cohort before the next one moves.

  • Internal and free users first
  • Monthly card subscribers with simple plans
  • Annual subscribers far from renewal
  • Customers with active coupons or trials
  • Failed-payment and recovery cases on a dedicated path
  • High-value and enterprise accounts last
Mirror
Validate
Entitlements
Access live
Cohort move
Payment cutover
Migration Questions

Migrating from Recurly, answered plainly.

How long does a Recurly migration take?

It depends on subscription complexity and channel count. A mirror-first migration lets you run in parallel within weeks, then move customers in cohorts at their own pace rather than one risky cutover.

Will customers lose access during a Recurly migration?

No, when entitlement migration is separated from payment migration. Azotte becomes the access and lifecycle source of truth first, while Recurly keeps billing, so access never depends on the payment cutover being finished.

What Recurly data moves to Azotte?

Accounts, plans and add-ons, subscriptions and status, renewal and billing-cycle anchors, coupons, and the IDs that map back to Recurly. Invoice history and recovery state stay preserved and are carried forward.

What happens to Recurly dunning and recovery during migration?

Recovery state is treated as first-class. Grace periods are preserved, no duplicate retries are sent, and mid-recovery customers move on a dedicated path into Azotte recovery once their cohort is ready.

Do I have to stop using Recurly immediately?

No. Azotte runs alongside Recurly. New subscriptions can start on Azotte while existing ones migrate cohort by cohort. Billing execution can stay on Recurly until you choose to move it.

Leave Recurly intact. Move subscription control to Azotte.

Preserve billing history. Carry recovery state forward. Move in controlled cohorts.