Skip to main content

Migrate to Botsi

Migrating to Botsi involves updating your app’s client and server-side integrations to align with Botsi’s SDK and infrastructure. This includes replacing SDK methods, configuring notification endpoints, and optionally importing historical subscription data. To transition your app to Botsi, just follow these simple steps:

  1. Integrate the Botsi SDK.

  2. Update the Apple/Google server notification endpoints.

  3. (Optional) Import historical subscription data for accurate analytics from day one.

No Manual Migration for Active Users

All users with an active or previously active subscription will be seamlessly transitioned. Once they open the app with the Botsi SDK installed, their subscription status will be verified and premium access will automatically resume — no additional actions required.

Step 1: SDK Integration​

Start by installing the Botsi SDK for your preferred platform:

  • iOS
  • Android
  • React Native (in progress)
  • Flutter (in progress)
  • Unity (in progress)

You’ll then need to replace your legacy subscription logic with Botsi’s equivalents, including:

  • Access checks for premium content
  • Purchase initiation
  • Purchase restoration
  • Managing and syncing user data

Step 2: Configure Server Notification Endpoints​

Apple and Google deliver critical subscription events — such as renewals, cancellations, refunds, or pauses — via server notifications.

While Botsi can technically operate without these hooks, we strongly recommend configuring them for full functionality. Without them:

  • 3rd-party integration events may be delayed
  • Analytics will lack real-time updates
  • A/B test data for paywalls may be inaccurate

You want to keep your current system running alongside Botsi during migration? No problem! Use event forwarding to send subscription data through Botsi and into your legacy backend.

Step 3: Import Subscription History​

While optional, importing historical subscription data ensures a smooth experience and immediate insights. Here’s what it unlocks:

  • Immediate analytics accuracy – Botsi uses original transaction IDs to match users. Without full data import, webhook-only data is incomplete.

  • Enriched user profiles – Your CRM, user segments, and analytics will instantly include prior subscription history and properties.

CSV Export

Please share a CSV export from your system with our support team at hello@botsi.com. To ensure compatibility, kindly refer to the reference file format provided in this link.