purchases/com.revenuecat.purchases

Package-level declarations

Types

enum CacheFetchPolicy : Enum<CacheFetchPolicy>

Specifies behavior for a caching API.

data class CustomerInfo(val entitlements: EntitlementInfos, val allExpirationDatesByProduct: Map<String, Date?>, val allPurchaseDatesByProduct: Map<String, Date?>, val requestDate: Date, val schemaVersion: Int, val firstSeen: Date, val originalAppUserId: String, val managementURL: Uri?, val originalPurchaseDate: Date?, jsonObject: JSONObject) : Parcelable, RawDataContainer<JSONObject>

Class containing all information regarding the customer

DangerousSettings

data class DangerousSettings

Only use a Dangerous Setting if suggested by RevenueCat support team.

EntitlementInfo

data class EntitlementInfo(val identifier: String, val isActive: Boolean, val willRenew: Boolean, val periodType: PeriodType, val latestPurchaseDate: Date, val originalPurchaseDate: Date, val expirationDate: Date?, val store: Store, val productIdentifier: String, val productPlanIdentifier: String?, val isSandbox: Boolean, val unsubscribeDetectedAt: Date?, val billingIssueDetectedAt: Date?, val ownershipType: OwnershipType, jsonObject: JSONObject, val verification: VerificationResult = VerificationResult.NOT_REQUESTED) : Parcelable, RawDataContainer<JSONObject>

This object gives you access to all of the information about the status of a user's entitlements.

EntitlementInfos

class EntitlementInfos(val all: Map<String, EntitlementInfo>, val verification: VerificationResult) : Parcelable

This class contains all the entitlements associated to the user.

EntitlementVerificationMode

enum EntitlementVerificationMode : Enum<EntitlementVerificationMode>

Verification strictness levels for EntitlementInfo.

ErrorPurchaseCallback

typealias ErrorPurchaseCallback = (StoreTransaction, PurchasesError) -> Unit

ExperimentalPreviewRevenueCatPurchasesAPI

@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY])

annotation class ExperimentalPreviewRevenueCatPurchasesAPI

This annotation marks the experimental preview of the RevenueCat Purchases API. This API is in a preview state and has a very high chance of being changed in the future.

LogHandler

interface LogHandler

Interface that allows handling logs manually. See also Purchases.logHandler

LogLevel

enum LogLevel : Enum<LogLevel>

Offering

data class Offering(val identifier: String, val serverDescription: String, val metadata: Map<String, Any>, val availablePackages: List<Package>)

An offering is a collection of Package available for the user to purchase. For more info see https://docs.revenuecat.com/docs/entitlements

Offerings

data class Offerings(val current: Offering?, val all: Map<String, Offering>)

This class contains all the offerings configured in RevenueCat dashboard. For more info see https://docs.revenuecat.com/docs/entitlements

OwnershipType

enum OwnershipType : Enum<OwnershipType>

Enum of supported ownership types for an entitlement.

Package

data class Package(val identifier: String, val packageType: PackageType, val product: StoreProduct, val offering: String)

Contains information about the product available for the user to purchase. For more info see https://docs.revenuecat.com/docs/entitlements

PackageType

enum PackageType : Enum<PackageType>

Enumeration of all possible Package types.

PeriodType

enum PeriodType : Enum<PeriodType>

Enum of supported period types for an entitlement.

ProductType

enum ProductType : Enum<ProductType>

ProrationMode

interface ProrationMode : Parcelable

Contains information about the proration mode to use in case of a product upgrade. Use the platform specific subclasses in each implementation.

PurchaseParams

data class PurchaseParams(val builder: PurchaseParams.Builder)

PurchaseResult

data class PurchaseResult(val storeTransaction: StoreTransaction, val customerInfo: CustomerInfo)

The result of a successful purchase operation. Used in coroutines.

Purchases

class Purchases : LifecycleDelegate

Entry point for Purchases. It should be instantiated as soon as your app has a unique user id for your user. This can be when a user logs in if you have accounts or on launch if you can generate a random user identifier. Make sure you follow the quickstart guide to setup your RevenueCat account.

PurchasesConfiguration

open class PurchasesConfiguration(builder: PurchasesConfiguration.Builder)

PurchasesError

class PurchasesError(val code: PurchasesErrorCode, val underlyingErrorMessage: String? = null)

This class represents an error

PurchasesErrorCallback

typealias PurchasesErrorCallback = (PurchasesError) -> Unit

PurchasesErrorCode

enum PurchasesErrorCode : Enum<PurchasesErrorCode>

PurchasesException

open class PurchasesException(val error: PurchasesError) : Exception

PurchasesTransactionException

class PurchasesTransactionException(purchasesError: PurchasesError, val userCancelled: Boolean) : PurchasesException

Store

enum Store : Enum<Store>

Enum of supported stores

SuccessfulPurchaseCallback

typealias SuccessfulPurchaseCallback = (StoreTransaction, CustomerInfo) -> Unit

VerificationResult

enum VerificationResult : Enum<VerificationResult>

The result of the verification process.

Functions

awaitCustomerInfo

suspend fun Purchases.awaitCustomerInfo(fetchPolicy: CacheFetchPolicy = CacheFetchPolicy.default()): CustomerInfo

Get latest available customer info. Coroutine friendly version of Purchases.getCustomerInfo.

awaitGetProducts

suspend fun <Error class: unknown class>.awaitGetProducts(productIds: List<String>, type: ProductType? = null): List<StoreProduct>

Gets the StoreProduct(s) for the given list of product ids of type type, or for all types if no type is specified.

awaitLogIn

suspend fun Purchases.awaitLogIn(appUserID: String): LogInResult

This function will change the current appUserID. Typically this would be used after a log out to identify a new user without calling configure

awaitLogOut

suspend fun Purchases.awaitLogOut(): CustomerInfo

Logs out the Purchases client clearing the save appUserID. This will generate a random user id and save it in the cache.

awaitOfferings

suspend fun <Error class: unknown class>.awaitOfferings(): Offerings

Fetch the configured offerings for this users. Offerings allows you to configure your in-app products via RevenueCat and greatly simplifies management. See the guide for more info.

awaitPurchase

suspend fun <Error class: unknown class>.awaitPurchase(purchaseParams: PurchaseParams): PurchaseResult

Initiate a purchase with the given PurchaseParams. Initialized with an Activity either a Package, StoreProduct, or SubscriptionOption.

awaitRestore

suspend fun Purchases.awaitRestore(): CustomerInfo

Restores purchases made with the current Play Store account for the current user. This method will post all purchases associated with the current Play Store account to RevenueCat and become associated with the current appUserID. If the receipt token is being used by an existing user, the current appUserID will be aliased together with the appUserID of the existing user. Going forward, either appUserID will be able to reference the same user.

awaitSyncPurchases

suspend fun Purchases.awaitSyncPurchases(): CustomerInfo

getCustomerInfoWith

fun Purchases.getCustomerInfoWith(onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (customerInfo: CustomerInfo) -> Unit)

Get latest available customer info.

fun Purchases.getCustomerInfoWith(fetchPolicy: CacheFetchPolicy, onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (customerInfo: CustomerInfo) -> Unit)

Get customer info from cache or network depending on fetch policy.

getOfferingsWith

fun <Error class: unknown class>.getOfferingsWith(onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (offerings: Offerings) -> Unit)

Fetch the configured offerings for this users. Offerings allows you to configure your in-app products vis RevenueCat and greatly simplifies management. See the guide for more info.

getProductsWith

fun <Error class: unknown class>.getProductsWith(productIds: List<String>, onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onGetStoreProducts: (storeProducts: List<StoreProduct>) -> Unit)

Gets the StoreProduct(s) for the given list of product ids for all product types.

fun <Error class: unknown class>.getProductsWith(productIds: List<String>, type: ProductType?, onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onGetStoreProducts: (storeProducts: List<StoreProduct>) -> Unit)

Gets the StoreProduct(s) for the given list of product ids of type type

logInWith

fun Purchases.logInWith(appUserID: String, onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (customerInfo: CustomerInfo, created: Boolean) -> Unit)

This function will change the current appUserID. Typically this would be used after a log out to identify a new user without calling configure

logOutWith

fun Purchases.logOutWith(onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (customerInfo: CustomerInfo) -> Unit)

Logs out the Purchases client clearing the save appUserID. This will generate a random user id and save it in the cache.

purchaseWith

fun <Error class: unknown class>.purchaseWith(purchaseParams: PurchaseParams, onError: (error: PurchasesError, userCancelled: Boolean) -> Unit = ON_PURCHASE_ERROR_STUB, onSuccess: (purchase: StoreTransaction?, customerInfo: CustomerInfo) -> Unit)

restorePurchasesWith

fun Purchases.restorePurchasesWith(onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (customerInfo: CustomerInfo) -> Unit)

syncPurchasesWith

fun Purchases.syncPurchasesWith(onError: (error: PurchasesError) -> Unit = ON_ERROR_STUB, onSuccess: (CustomerInfo) -> Unit)

This method will send all the purchases to the RevenueCat backend. Call this when using your own implementation for subscriptions anytime a sync is needed, such as when migrating existing users to RevenueCat. The onSuccess callback will be called if all purchases have been synced successfully or there are no purchases. Otherwise, the onError callback will be called with a PurchasesError indicating the first error found.