Skip to main content

Quickstart

Integrating Botsi into your mobile App is quick and simple, taking just a few steps. This guide walks you through the setup process, from adding your App to your first test purchase. You will connect your app store accounts, install the SDK, create your products and paywalls, and validate everything with a test.

1. Add Your App​

Start by opening the Botsi Dashboard. Botsi will ask you to add your first App to get started. You’ll see a form with three fields:

  • App name: Enter the name of your mobile App. This is how it will appear in your dashboard.
  • Category: Select the category that best matches your App, like Entertainment or Weather.
  • App icon (optional): Upload your App’s icon.

Once added, Botsi will redirect you to Setup Guideguide, where all steps to finish the integration and testing will be available.

2. Connect App Stores​

In the Setup Guide, the first step is to connect your App to the appropriate app stores:

  • Apple App Store: Provide your App’s Bundle ID, enable In-App Purchase API, and add your Shared Secret if applicable.
  • Google Play Store: Provide the Package Name, enable the In-App Purchase API, and upload the service account key file.

Depending on your App's availability, you can connect to one or both platforms. Use the toggles to indicate if your App is available on iOS and/or Android.

3. Set Up Server Notifications​

To ensure Botsi receives subscription lifecycle events, such as renewals, cancellations, and billing issues, you must configure server notifications for iOS and Android if your App is available in both operating systems.

The correct configuration of these notifications are required for keeping your subscription status in sync across all users and devices.

4. Install the Botsi SDK​

Install the SDK on your mobile App based on your development platform. Each option includes detailed instructions directly in the Setup Guide, but you can also the documentation guides using the following buttons:

iOS (Swift)

Android (Kotlin)

Flutter

React Native

Unity

In addition, to installing the SDKs, you can add complementary information to the App Settings in the Botsi Dashboard. Check the dashboard pages to complete the configurations:

  • General App Settings
  • iOS SDK
  • Android SDK
  • Apple Search Ads
  • Stripe

5. Create a Product​

After integrating the SDK, it is time to define what product you are selling. In Botsi, a Product is a unified item that works across both iOS and Android, like a subscription. Instead of managing separate products for each store, you create one product in Botsi and link it to the respective identifiers from App Store, Google Play, or Stripe. This simplifies cross-platform pricing and lifecycle management.

To learn more about Products in Botsi, access the existing documentation:

6. Create a Paywall​

Once you have all the products created, you can create new Paywalls. Use Botsi’s no-code Paywall Builder to create beautiful, customizable paywalls that you can update remotely. You can choose which products to display and add text, visuals, layout, and calls to action directly from the Botsi dashboard.

Paywalls in Botsi also unlock powerful features:

  • Run A/B tests to optimize conversions
  • Target specific user segments with custom paywall versions

To learn more about Paywalls in Botsi, access the existing documentation:

7. Create a Placement​

The next step is to define where in your App that paywall should appear. This is done using Placements, which are points in your App’s flow where a paywall is shown. The placement ID is the only thing you need to hardcode in your App. Everything else is managed remotely on the Botsi Dashboard.

With placements, you can:

  • Assign one or more paywalls to a specific moment in the user journey
  • Run A/B tests for different paywalls at the same placement
  • Monitor performance per placement to identify what converts best

To learn more about Placements in Botsi, access the existing documentation:

8. Make a Test Purchase​

Use the sandbox account to simulate a real purchase on your App. Once the operation is completed:

  • Access the Event Feed tab in the Botsi Dashboard
  • You should see the purchase event show up in real-time

If the test event appears, your setup is complete and working.