{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Documentation","type":"markdown"},"seo":{"title":"Migrate subscriptions from another platform","description":"Learn how to migrate subscriptions from another platform to Rebilly.","siteUrl":"https://www.rebilly.com","image":"/assets/rebillysocial.94fb32fc280c9e84b963c440ec462771d25f4e6fdaaa6c59de41e8135113b46b.db81178d.png","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"migrate-subscriptions-from-another-platform","__idx":0},"children":["Migrate subscriptions from another platform"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide describes how to migrate existing subscriptions from another platform to Rebilly."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this guide if your organization is moving from another payment platform to Rebilly and you have active subscriptions that must continue without interruption."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/orders"]}," operations used in this guide are experimental. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/contact"},"children":["Contact Rebilly"]}," to enable this functionality for your organization."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"migration-process","__idx":1},"children":["Migration process"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following steps to migrate your subscriptions."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test in the sandbox before migrating in the live environment.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Complete the full migration process in the sandbox using test customers and test payment instruments to confirm the results are correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When migrating in the live environment, migrate subscriptions in batches and check that the results are correct before migrating the next batch."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-set-up-your-rebilly-integration","__idx":2},"children":["Step 1: Set up your Rebilly integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set up your Rebilly integration and begin collecting new subscriptions through Rebilly."," ","This ensures that your Rebilly environment functions as expected before you migrate existing data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To set up your Rebilly integration, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/dev-docs#get-started"},"children":["Get started"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-import-customer-payment-data","__idx":3},"children":["Step 2: Import customer payment data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request an export of your customer and payment data from your previous payment processor."," ","Rebilly imports this data and creates the associated customers and payment instruments in your Rebilly organization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To keep your existing customer IDs for mapping during the migration, include them in the export."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/migrate-sensitive-payment-data"},"children":["Migrate sensitive payment data"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-export-your-subscription-data","__idx":4},"children":["Step 3: Export your subscription data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Export your active subscription data from your previous platform."," ","Include all details required to recreate the subscriptions in Rebilly, such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer ID (matching the ID imported in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-2-import-customer-payment-data"},"children":["step 2"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Product or plan details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Billing interval and amount"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Currency"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Current renewal period start and end dates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Details of the payment instrument"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-write-a-migration-script","__idx":5},"children":["Step 4: Write a migration script"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Write a script that processes your exported subscription data, transforms each record to match the Rebilly API format, and creates a subscription in Rebilly using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/catalog/all/orders-experimental/postorder"},"children":["Create an order"]}," operation on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/orders"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startTime"]}," of each subscription in Rebilly to the beginning of the current renewal period."," ","For example, if the renewal period is March 1st to March 31st, set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startTime"]}," to March 1st."," ","This date can be in the past."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autopay"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," on all new subscriptions to avoid unintentional double charges during the migration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-verify-subscriptions-in-rebilly-and-cancel-the-previous-subscriptions","__idx":6},"children":["Step 5: Verify subscriptions in Rebilly and cancel the previous subscriptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you create the subscriptions in Rebilly, review them to verify that the data is correct."," ","After verification, cancel the subscriptions in your previous platform."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-6-update-autopay-settings","__idx":7},"children":["Step 6: Update ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autopay"]}," settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For subscriptions that must use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autopay"]},", use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/catalog/all/orders-experimental/putorder"},"children":["Upsert an order"]}," operation to set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autopay"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":8},"children":["Related topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/migrate-sensitive-payment-data"},"children":["Migrate sensitive payment data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/dev-docs/orders"},"children":["Orders - conceptual overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/dev-docs/subscriptions"},"children":["Subscriptions - conceptual overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/catalog/all/orders-experimental/"},"children":["Orders API reference"]}]}]}]},"headings":[{"value":"Migrate subscriptions from another platform","id":"migrate-subscriptions-from-another-platform","depth":1},{"value":"Migration process","id":"migration-process","depth":2},{"value":"Step 1: Set up your Rebilly integration","id":"step-1-set-up-your-rebilly-integration","depth":3},{"value":"Step 2: Import customer payment data","id":"step-2-import-customer-payment-data","depth":3},{"value":"Step 3: Export your subscription data","id":"step-3-export-your-subscription-data","depth":3},{"value":"Step 4: Write a migration script","id":"step-4-write-a-migration-script","depth":3},{"value":"Step 5: Verify subscriptions in Rebilly and cancel the previous subscriptions","id":"step-5-verify-subscriptions-in-rebilly-and-cancel-the-previous-subscriptions","depth":3},{"value":"Step 6: Update autopay settings","id":"step-6-update-autopay-settings","depth":3},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Migrate subscriptions from another platform","description":"Learn how to migrate subscriptions from another platform to Rebilly.","lang":"en-US"}},"lastModified":"2026-03-23T11:31:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/dev-docs/migrate-subscriptions-from-another-platform","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}