IAPHUB

IAPHUB makes it much simpler to integrate in-app purchases with your Adalo apps.

Skill Level: Expert

The forgot password flow needs to be made manually using a screen, temporary password, and email with all implementations of IAPHUB.

Before You Begin

• Make sure you are very familiar with Adalo, the database, and how to install components from the marketplace.

• You will need an IAPHUB account to use this integration.

• You will need at least the Adalo Starter plan to use this feature.

• Please prepare to spend 1-3 days implementing this feature. The setup can be complex and may require some approval from the app stores.

Walkthrough

When do I need In-App Purchases?

In-app purchases are needed in two main scenarios:

1. You are selling access to or features of your app.

2. You are selling digital goods such as downloads, credits, seats, licenses, or other non-physical items.

1. Complete the following guides for Google first (if releasing on Android):

1. Create Your Google Developer Account

2. Create Your Firebase Project

3. Register Android App and Download Config File

4. Generate and Download the Private Key

2. Complete the following guides for Apple first (if releasing on iOS):

1. Create Your Apple Developer Account

2. Setup Annual Payment for Your Apple Developer Account

3. Create Your App Bundle ID

4. Create Your Adalo "App-Specific Password"

3. Create your IAPHUB account.

If you haven't already done so, please go to IAPHUB and create a free account.

4. Decide which components you need to use.

IAPHUB offers two methods for integrating in-app purchases into your apps. Which one you choose will be base on the types of products or services you're offering and on which platform. You can use the table below for native apps, or use the decision tree below that for greater nuance.

Product Type	Description	IAPHUB Components to Use	Examples
Consumable	Items consumed by the user and must be repurchased after they are used up.	Start and Custom Paywall	Credits, tickets, game items, or boosts.
Non-consumable	Items that do not expire and cannot be used up by the user.	Start and Custom Paywall	A photo library, PDF templates, or downloads.
Non-renewing subscription	Paid access to an app or feature on a given interval for a limited amount of time.	Start and Plug-and-Play Paywall OR Start and Custom Paywall	Live yoga classes for a year, 4 weeks of virtual therapy, 9 month pregnancy tracker.
Auto-renewing subscription	Paid access to an app or feature on a given interval until the subscription is cancelled.	Start and Plug-and-Play Paywall OR Start and Custom Paywall	Live yoga classes, up to 5 collaborators/month, unlimited exports, custom branding.

5. Create your app in IAPHUB dashboard.

Follow this guide from IAPHUB to create your app in the IAPHUB dashboard.

6. Install the "Start" IAPHUB component from the Adalo Marketplace and place in your app.

You can use this guide from IAPHUB to ensure you are installing the component correctly.

NOTE: The Start component is required for all product types, even consumable and non-consumable products. This component is how IAPHUB tracks your users, products, and purchases.

7. Install either the Plug and Play Paywall or Custom Paywall (use the table above to decide)

• Use this guide from IAPHUB for setting up the Plug-and-Play Paywall

• Use this guide from IAPHUB for setting up a Custom Paywall/Consumables Purchase

At this point, it makes sense to go ahead and completely finish the creation of your app as if you are ready to fully test it. Testing in-app payments before the rest of your app is complete will likely create more work for you in the long run.

8. Complete the following guides for Google (if releasing on Android):

1. Get Your Build File

2. Upload Your App to Google for Testing

9. Complete the following guide for Apple (if releasing on iOS):

1. Start your build in Adalo

10. Complete the following guides from IAPHUB to configure the Google backend:

1. Configure the Google Play API

2. Configure IAPHUB Google Server Notifications (optional, but highly recommended)

3. Configure Google Sandbox Testing

4. Create auto-renewable subscription (if offering subscriptions) If you are offering consumables or non-consumable product types, please set those up under the In-app products portion of Google Play Console as show below:

11. Complete the following guides from IAPHUB to configure the Apple backend:

1. Configure Shared Secret

2. Configure IAPHUB Apple Server Notifications (optional, but highly recommended)

3. Configure Apple Sandbox Testing

4. Create a Subscription Group (if offering subscriptions)

5. Create auto-renewing Subscription (if offering this product type)

If you are offering consumables or non-consumable product types, please set those up in the In-App Purchases portion of App Store Connect as shown below:

12. Now that you have created your products in Google Play and App Store Connect, you can use those Product or Subscription IDs to create the Products in IAPHUB.

• Please follow this guide from IAPHUB to create the products in the IAPHUB dashboard.

13. For Apple, subscriptions live inside Subscription Groups (as seen in #4 in Step 11 above). This means you also need to create a Subscription Group inside of IAPHUB.

• Follow this guide from IAPHUB to create the Subscription Group on the IAPHUB dashboard.

14. Create a Listing in the IAPHUB dashboard.

• Please follow this guide from IAPHUB to create the listing of products.

15. Test in sandbox and switch to production

• Please follow this guide for how to test in Sandbox mode and also switch your app purchases into production mode when ready.

NOTE: Don't forget to complete the other steps in the Adalo Publishing docs to make your app available to users in the app stores!

Learn More

• IAPHUB is working to make guides for consumable and non-consumable products as well!

• While you can test for free, IAPHUB is a paid service once you decide to switch to Production mode.

• Anyone that you want to test your purchasing flow on Android needs to be added as a license tester as show here:

Help

Don't forget that if you experience an issue with this integration, be sure to check the Apple Status page, the Google Status page, and the Adalo Status page to check for issues!

Adalo does not provide support for components developed by third parties, so the best place to reach out for support for IAPHUB is the IAPHUB team directly. You can do this through the bubble in the lower righthand corner of the IAPHUB dashboard. You can also check out their troubleshooting documentation.

If you need additional help with this article, you can always ask in our community forum! Be sure to paste the link to this article in your post as well!

Do you have a tutorial or help doc request? Let us know!