Interface PurchaseParams

Parameters used to customise the purchase flow when invoking the .purchase method.

interface PurchaseParams {
    customerEmail?: string;
    defaultLocale?: string;
    discountCode?: string;
    htmlTarget?: HTMLElement;
    metadata?: PurchaseMetadata;
    onDiscountCodeChanged?: (discountCode: null | string) => void;
    purchaseOption?: null | PurchaseOption;
    rcPackage: Package;
    selectedLocale?: string;
    showDiscountCodeField?: boolean;
    skipSuccessPage?: boolean;
}

Properties

customerEmail? defaultLocale? discountCode? htmlTarget? metadata? onDiscountCodeChanged? purchaseOption? rcPackage selectedLocale? showDiscountCodeField? skipSuccessPage?

Properties

OptionalcustomerEmail

customerEmail?: string

The email of the user. If undefined, RevenueCat will ask the customer for their email.

OptionaldefaultLocale

defaultLocale?: string

The default locale to use if the selectedLocale is not available. Defaults to english.

Optional ExperimentaldiscountCode

discountCode?: string

Initial discount code to display as applied in the Web Billing checkout. This is useful when the code originated outside of the checkout UI, for example from a URL parameter.

OptionalhtmlTarget

htmlTarget?: HTMLElement

The HTML element where the billing view should be added. If undefined, a new div will be created at the root of the page and appended to the body.

Optionalmetadata

metadata?: PurchaseMetadata

The purchase metadata to be passed to the backend. Any information provided here will be propagated to the payment gateway and to the RC transaction as metadata.

Optional ExperimentalonDiscountCodeChanged

onDiscountCodeChanged?: (discountCode: null | string) => void

Called when the applied discount code changes in the Web Billing checkout. This can be used by host applications to keep external state, such as the URL, in sync with the checkout.

OptionalpurchaseOption

purchaseOption?: null | PurchaseOption

The option to be used for this purchase. If not specified or null the default one will be used.

rcPackage

rcPackage: Package

The package you want to purchase. Obtained from Purchases.getOfferings.

OptionalselectedLocale

selectedLocale?: string

The locale to use for the purchase flow. If not specified, English will be used

Optional ExperimentalshowDiscountCodeField

showDiscountCodeField?: boolean

If set to true, the Web Billing checkout will show a discount input code field.

OptionalskipSuccessPage

skipSuccessPage?: boolean

If set to true, the SDK will skip the success page and automatically continue the flow once the purchase completes successfully. Defaults to false.

Settings

Member Visibility

On This Page

Properties