šŸ’øIn-App Purchases

Before reading this page, please make sure you've set up your RevenueCat account.

šŸˆpageSetup RevenueCat App

šŸ§‹ Bubble.io Plugin

[Element] Natively - Purchases

Events:

  • Purchase Success

  • Purchase Failed

  • Set Customer Success

  • Set Customer Failed

  • Purchase Cancelled

  • Customer ID Received

  • Get Price Success

  • Get Price Failed

  • Restore Purchase Success [iOS]

  • Restore Purchase Failed [iOS]

States:

  • Latest Transaction Id - Transaction Id after Purchase Package

  • Latest Customer Id - Customer Id after Set Customer ID or Purchase Package

  • Latest Error - Empty if no error

  • Latest GetPrice price - 9.99

  • Latest GetPrice price (Localized) - "$9.99" / "9.99 USD"

  • Latest GetPrice currency - "USD", "UAH", etc.

  • Latest PurchasePackage packageId

Actions:

  • Purchase Package - Initiate purchase of product or subscription

  • Set Customer ID - Link your user's id with RevenueCat customer

    • Customer Identifier - (We're recommending using a Current User's unique id to identify customers in the RevenueCat dashboard)

  • Reset Customer ID - Unlink Customer ID from a device

  • Get Package Price - Returns a price for specific product

  • Get Customer ID - Returns a current customer id

  • Restore Purchase [iOS] - Restores purchases (Handled by RevenueCat automatically)

How to use?

  1. Make sure you've set up your Revenue Cat for your app

  2. Add revenuecat_apiKey in plugin settings. To find API Key, go to RevenueCat App > API keys > Secret API keys.

  3. Call Set Customer ID

  4. Call Purchase Package action

How to verify User's subscription?

Make sure you've added revenuecat_apiKey in plugin settings. To find API Key, go to RevenueCat App > API keys > Secret API keys. āš ļøāš ļøāš ļø MAKE SURE YOU'RE USING API KEY V1

RevenueCat - Verify Subscription

  • Customer ID - Revenue cat user id that was used on RevenueCat Login.

A new customer will be created if the customer with such ID does not exist. More details here

  • Entitlements ID - your entitlements id, more details here.

Returns a result as:

  • Product ID - text

  • Purchase Date - date

  • Grace Period Expires Date - date

  • Expiration Date - date

  • Is Active - yes / no (Expiration Date > Current Date)

  • Error - empty text if no error

Bubble Setup example:

  1. On each User Login or first Signup you need to set the RevenueCat customer ID to your own user's unique id.

  2. Purchase a subscription (package) with action

  3. Verify user's subscription whenever you need it

  4. If you have any issues and, for some reasons, purchases doesn't work. You can check Latest Error value from Natively Purchases element

  5. You can also use RevenueCat API for your purpose (for example, validation of purchases)

šŸ›  JavaScript SDK

NativelyPurchases

const purchases = new NativelyPurchases();
const login_callback = function(resp) {
    console.log(resp.status); // SUCCESS or FAILED
    console.log(resp.customerId); // Customer Id
    
    // Empty if no error (should contain an error if status === "FAILED"
    console.log(resp.error); 
};

// Link your user with the customer on RevenueCat
const userId = "sdfdsr-2345-3rsd-fsd3432";
purchases.login(userId, login_callback);

// Unlink your user with the customer on RevenueCat
const logout_callback = function(resp) {
    console.log("Logged out");
}
purchases.logout(logout_callback);

// Get the current user's customer id (Useful in case you're not linking the user with the RevenueCat customer)
const customer_id_callback = function(resp) {
    console.log(resp.customerId);
}
purchases.customerId(customer_id_callback);

// Make a purchase
const packageId = "$rc_monthly";
const purchases_package_callback = function(resp) {
    console.log(resp.status);
    console.log(resp.transactionId);
    console.log(resp.error);
};
purchases.purchasePackage(packageId, purchases_package_callback);

// Restore a purchase
const restore_callback = function(resp) {
    console.log(resp.status); // SUCCESS / FAILED
    console.log(resp.customerId);
    console.log(resp.error);
};
purchases.restore(restore_callback);

How to verify subscription with JS?

You need to fetch a user from RevenueCat API and verify it's entitlements. More details can be found here.

Where to find Package ID?

You can find it in your RevenueCat App dashboard, more details here

For custom package identifier

For default package identifier

We recommend checking this guide if you plan to use a Stripe subscription through RevenueCat.

Create a request in API Connector (more details about the endpoint you can find here)

Where fetch_token & app_user_id is:

Last updated