Skip to main content

Set up IAPHUB on your Adalo app

Introduction

Adalo is an amazing platform to design and build custom Android & iOS apps with no code required.
We're proud to support Adalo. This guide will walk you through the differents steps to install IAPHUB and sell in-app purchases on your Adalo app.

info

Our friends at Adalo made a great tutorial video explaining the basic steps to install IAPHUB on an Adalo app.

You should first install IAPHUB from the Adalo marketplace, after doing so you'll be able to use the following components:

IAPHUB Start

The IAPHUB Start component will display an activity indicator and is required to initialize IAPHUB and load your products.

IAPHUB Paywall

The IAPHUB Paywall component will display all the UI necessary to sell your auto-renewable subscriptions.
The component supports one or multiple subscriptions belonging to the same subscription group. It is extremely easy to set up and will load the subscriptions directly from IAPHUB (allowing you to configure your subscriptions directly from the IAPHUB dashboard).

IAPHUB Buy Button

The IAPHUB Buy Button component is needed when developing a custom paywall.
The button will launch a purchase when the user clicks on it.

IAPHUB Restore Button

The IAPHUB Buy Button component is needed when developing a custom paywall.
The button will restore the purchases of the user when he clicks on it.

IAPHUB Manage Subscription Button

The IAPHUB Buy Button component is needed when developing a custom paywall.
The button will redirect the user to the Google/Apple page to manage its subscription when he clicks on it.

IAPHUB Product Price

The IAPHUB Product Price component is needed when developing a custom paywall.
The component will display the price of the product you've configured.

Create app

If did not create an IAPHUB account yet, you can easily do so here, it'll only take a few seconds.
After doing so, log in to your account and create an app. And that's it for now, we'll configure the app later in this guide.

Set up Start component

The first step is to add the Start component in your app.
You will find detailed instructions here, explaining step by step how to set up the component.

Set up Paywall

Once the Start component is set up properly, it's finally time to add the paywall.

If you're selling subscriptions, we've developed a plug&play paywall component that will make your life easier.
You will find detailed instructions here, explaining step by step how to set up the component.

If you're looking to sell consumables or need a custom UI to sell your subscriptions, you'll have to develop a custom paywall by using the Buy Button, Restore Button, Manage Subscription Button and Product Price components. You will find detailed instructions here.

Create products

After you've successfully implemented the IAPHUB components in your Adalo app, you should create your product(s).
Please follow our guide explaining how to create a product.

Offer a subscription with multiple durations

We recommend starting with something easy (such as a single monthly subscription) but if you're looking to offer a subscription with multiple durations, you must create multiple subscriptions that belong to the same subscription group.

Please follow our guide explaining how to create a subscription group.

info

The order of your subscriptions in your App Store Connect subscription group is very important!
It'll determine if the subscription replacement is an upgrade/downgrade or crossgrade.

Let's say you want to sell a 1 month, 6 months and 1 year subscription. The recommended order would be:

  • 1 - 1 month subscription
  • 2 - 6 months subscription
  • 3 - 1 year subscription

That way a user changing a 6 months subscription to 1 month subscription will happen immediately (subscription upgrade).
And a user changing a 1 month subscription to a 6 months subscription will happen at the next renewal date (subscription downgrade).

info

You must create only one subscription group (the Paywall component doesn't support multiple subscription groups).

Create listing

A listing contains the products you have for sale.
Without creating a listing your users won't see your products (even though you've created them on the Products page).
Please follow our guide explaining how to create a listing.

Set up Android app

After you have installed IAPHUB properly in your app, you should, of course, always test your Android app to make sure everything is working. If you didn't do it yet, you should first create and configure your app on the Google Play Store and publish a release in the internal testing track. You can follow this great guide from Adalo explaining everything step by step here.

After you've published your app on the internal testing track, click on the link (on the "Testers" tab of the "Internal testing" page) to join the test. After joining the test, you should now be able to download the app and it should display the paywall with your products properly (if everything is working fine). If your product isn't displayed, take a look at this guide that will walk you through the different possibilities that could cause this issue.

In order to make a purchase we're going to need to configure the Google Play API to allow IAPHUB to validate the payment receipts. Follow this guide explaining step by step how to configure the Google Play API.

Do not forget to enter your Android app Bundle ID on the settings page of the IAPHUB dashboard, it should be the same you've entered on Adalo when building the app.

If you're selling subscriptions, we recommend enabling Google server notifications. It'll allow IAPHUB to be notified in real time when the status of a subscription is updated. Otherwise IAPHUB will only refresh the status of a subscription at regular intervals (usually every 24 hours).

You'll also need to add your account for license testing. License testers will be able to purchase your products for free (sandbox purchase). The subscriptions will also renew more quickly than normal to aid in testing.

After you've configured everything, you should try to make a sandbox purchase.

Set up iOS app

After you have installed IAPHUB properly in your app, you should, of course, always test your iOS app to make sure everything is working. If you didn't do it yet, you should first create an app and publish it on TestFlight. You can follow this great guide from Adalo explaining everything step by step here.

After that check the agreements of your App Store Connect account. You'll have to sign the Paid Applications Agreement and set up your banking and tax. If everything isn't signed and set up correctly, iTunes will not return any products for sale.

Go to the settings page of the IAPHUB dashboard, enable the iOS platform and enter the Bundle ID (the same you've entered on Adalo when building your app) and configure the shared secret.

If you're selling subscriptions, we recommend enabling iTunes server notifications. It'll allow IAPHUB to be notified in real time when the status of a subscription is updated. Otherwise IAPHUB will only refresh the status of a subscription at regular intervals (usually every 24 hours).

You can now download the app on TestFlight. Check that your paywall is displaying your products and try to make a purchase. Users on TestFlight will be able to make a purchase for free (sandbox purchase), The subscriptions will also renew more quickly than normal to aid in testing.

If your product isn't displayed, take a look at this guide that will walk you through the different possibilities that could cause this issue.

Before publishing your app

Upgrade your plan to production

Do not forget to upgrade your IAPHUB plan to production on the IAPHUB dashboard (see screenshot below) in order to be able to process real transactions.



Select in-app purchases on App Store connect

On App Store connect make sure to select your subscriptions before submitting your app for review (see screenshot below).
New in-app purchase products must be selected in the submission when submitting an app version selling in-app purchases for the first time.



Display production data

If you want to display real transactions (instead of sandbox transactions), do not forget to switch the select to production data. It is located in the topbar of IAPHUB dashboard.


Need help?

Our support is available at [email protected].