React Native SDK Models

Interfaces

AdaptyOnboarding

Information about an onboarding.

Name	Type	Description
id	string	An identifier of an onboarding, configured in Adapty Dashboard
placement	AdaptyPlacement	A placement, configured in Adapty Dashboard
hasViewConfiguration	boolean	If true, it is possible to fetch the view object and use it with AdaptyUI library
name	string	Name of the onboarding flow
remoteConfig	AdaptyRemoteConfig (optional)	A remote config configured in Adapty Dashboard for this onboarding
variationId	string	An identifier of a variation, used to attribute purchases to this onboarding
version	number (optional)	Version of the onboarding configuration
payloadData	string (optional)	Additional payload data
requestLocale	string	Requested locale for the onboarding
onboardingBuilder	AdaptyOnboardingBuilder (optional)	Builder configuration for the onboarding

AdaptyOnboardingBuilder

Name	Type	Description
url	string	URL for the onboarding builder
lang	string	Language for the onboarding builder

AdaptyPaywallProduct

An information about a product.

Name	Type	Description
vendorProductId	string	Unique identifier of a product from App Store Connect or Google Play Console
adaptyId	string	Unique identifier of the product in Adapty
paywallVariationId	string	Same as variationId property of the parent AdaptyPaywall
paywallABTestName	string	Same as abTestName property of the parent AdaptyPaywall
paywallName	string	Same as name property of the parent AdaptyPaywall
paywallProductIndex	number	The index of the product in the paywall
localizedDescription	string	A description of the product
localizedTitle	string	The name of the product
regionCode	string (optional)	The region code of the locale used to format the price of the product. ISO 3166 ALPHA-2 (US, DE)
price	AdaptyPrice (optional)	The cost of the product in the local currency
subscription	AdaptySubscriptionDetails (optional)	Detailed information about subscription (intro, offers, etc.)
webPurchaseUrl	string (optional)	URL for web purchase functionality
payloadData	string (optional)	Additional payload data
ios	object (optional)	iOS-specific properties
ios.isFamilyShareable	boolean	Boolean value that indicates whether the product is available for family sharing in App Store Connect. Will be false for iOS version below 14.0 and macOS version below 11.0. iOS Only.

AdaptyPrice

Name	Type	Description
amount	number	Price as number
currencyCode	string (optional)	The currency code of the locale used to format the price of the product. The ISO 4217 (USD, EUR)
currencySymbol	string (optional)	The currency symbol of the locale used to format the price of the product. ($, €)
localizedString	string (optional)	A price's language is determined by the preferred language set on the device. On Android, the formatted price from Google Play as is

AdaptySubscriptionDetails

Name	Type	Description
subscriptionPeriod	AdaptySubscriptionPeriod	The period details for products that are subscriptions. Will be null for iOS version below 11.2 and macOS version below 10.14.4.
localizedSubscriptionPeriod	string (optional)	The period's language is determined by the preferred language set on the device
offer	AdaptySubscriptionOfferId (optional)	A subscription offer if available for the auto-renewable subscription
ios	object (optional)	iOS-specific properties
ios.subscriptionGroupIdentifier	string (optional)	An identifier of the subscription group to which the subscription belongs. Will be null for iOS version below 12.0 and macOS version below 10.14. iOS Only.
android	object (optional)	Android-specific properties
android.basePlanId	string	The identifier of the base plan. Android Only.
android.renewalType	string (optional)	The renewal type. Possible values: 'prepaid', 'autorenewable'. Android Only.

AdaptySubscriptionPeriod

Name	Type	Description
numberOfUnits	number	A number of period units
unit	ProductPeriod	A unit of time that a subscription period is specified in. The possible values are: day, week, month, year

AdaptySubscriptionOffer

Subscription offer model to products.

Name	Type	Description
identifier	AdaptySubscriptionOfferId	Subscription offer identifier
phases	array of AdaptyDiscountPhase	Array of discount phases
android	object (optional)	Android-specific properties
android.offerTags	array of strings (optional)	Tags associated with this offer

AdaptySubscriptionOfferId

Name	Type	Description
id	string (optional)	Identifier for promotional or win_back offers
type	string	Type of offer. Possible values: introductory, promotional, win_back

AdaptyDiscountPhase

Name	Type	Description
localizedNumberOfPeriods	string (optional)	A formatted number of periods of a discount for a user's locale
localizedSubscriptionPeriod	string (optional)	A formatted subscription period of a discount for a user's locale
numberOfPeriods	number	A number of periods this product discount is available
price	AdaptyPrice	Discount price of a product in a local currency
subscriptionPeriod	AdaptySubscriptionPeriod	An information about period for a product discount
paymentMode	OfferType	A payment mode for this product discount. Possible values: free_trial, pay_as_you_go, pay_up_front

AdaptyPaywall

An information about a paywall.

Name	Type	Description
placement	AdaptyPlacement	A placement, configured in Adapty Dashboard
hasViewConfiguration	boolean	If true, it is possible to fetch the view object and use it with AdaptyUI library
name	string	A paywall name
remoteConfig	AdaptyRemoteConfig (optional)	A remote config configured in Adapty Dashboard for this paywall
variationId	string	An identifier of a variation, used to attribute purchases to this paywall
products	array of ProductReference (deprecated)	Array of initial products info (deprecated, use productIdentifiers instead)
productIdentifiers	array of AdaptyProductIdentifier	Array of product identifiers for this paywall
id	string	An identifier of a paywall, configured in Adapty Dashboard
version	number (optional)	Version of the paywall configuration
webPurchaseUrl	string (optional)	URL for web purchase functionality
payloadData	string (optional)	Additional payload data
requestLocale	string	Requested locale for the paywall
paywallBuilder	AdaptyPaywallBuilder (optional)	Builder configuration for the paywall

AdaptyPaywallBuilder

Name	Type	Description
id	string	ID for the paywall builder
lang	string	Language for the paywall builder

AdaptyPlacement

Name	Type	Description
abTestName	string	Parent A/B test name
audienceName	string	A name of an audience to which the paywall belongs
id	string	ID of a placement configured in Adapty Dashboard
revision	number	Current revision (version) of a paywall. Every change within a paywall creates a new revision
isTrackingPurchases	boolean (optional)	Whether the placement is tracking purchases
audienceVersionId	string	Version ID of the audience

AdaptyRemoteConfig

Name	Type	Description
lang	string	Identifier of a paywall locale
data	object	A custom dictionary configured in Adapty Dashboard for this paywall
dataString	string	A custom JSON string configured in Adapty Dashboard for this paywall

AdaptyProfile

An information about a user's subscription status and purchase history.

Name	Type	Description
profileId	string	An identifier of the user in Adapty
customerUserId	string (optional)	An identifier of the user in your system
customAttributes	object	Previously set user custom attributes with the updateProfile method
accessLevels	object<string, AdaptyProfile.AccessLevel>	The keys are access level identifiers configured by you in Adapty Dashboard. The values are AccessLevel objects. Can be null if the customer has no access levels
subscriptions	object<string, AdaptyProfile.Subscription>	The keys are product ids from App Store Connect. The values are Subscription objects. Can be null if the customer has no subscriptions
nonSubscriptions	object<string, array of AdaptyProfile.NonSubscription>	The keys are product ids from App Store Connect. The values are arrays of NonSubscription objects. Can be null if the customer has no purchases

AdaptyProfile.AccessLevel

Information about the user's access level.

Name	Type	Description
id	string	Unique identifier of the access level configured by you in Adapty Dashboard
isActive	boolean	Whether the access level is active. Generally, you have to check just this property to determine if the user has access to premium features
vendorProductId	string	The identifier of the product in the App Store Connect that unlocked this access level
store	string	The store of the purchase that unlocked this access level. The possible values are: app_store, play_store, adapty
activatedAt	Date	The time when the access level was activated
renewedAt	Date (optional)	The time when the access level was renewed
expiresAt	Date (optional)	The time when the access level will expire (could be in the past and could be null for lifetime access)
isLifetime	boolean	Whether the access level is active for a lifetime (no expiration date). If set to true you shouldn't check expires_at, or you could just check isActive
activeIntroductoryOfferType	string (optional)	The type of active introductory offer. Possible values are: free_trial, pay_as_you_go, pay_up_front. If the value is not null, it means that the offer was applied during the current subscription period
activePromotionalOfferType	string (optional)	The type of active promotional offer. Possible values are: free_trial, pay_as_you_go, pay_up_front. If the value is not null, it means that the offer was applied during the current subscription period
activePromotionalOfferId	string (optional)	An identifier of active promotional offer
offerId	string (optional)	Offer identifier
willRenew	boolean	Whether the auto-renewable subscription is set to renew
isInGracePeriod	boolean	Whether the auto-renewable subscription is in the grace period
unsubscribedAt	Date (optional)	The time when the auto-renewable subscription was cancelled. Subscription can still be active, it just means that auto-renewal turned off. Will be set to null if the user reactivates the subscription
billingIssueDetectedAt	Date (optional)	The time when billing issue was detected. Subscription can still be active. Will be set to null if the charge will be made
startsAt	Date (optional)	The time when this access level has started (could be in the future)
cancellationReason	string (optional)	The reason why the subscription was cancelled. Possible values are: voluntarily_cancelled, billing_error, refund, price_increase, product_was_not_available, unknown
isRefund	boolean	Whether the purchase was refunded
android	object (optional)	Android-specific properties
android.offerId	string (optional)	Offer identifier

AdaptyProfile.Subscription

Information about the user's subscription.

Name	Type	Description
store	string	The store of the purchase. The possible values are: app_store, play_store, adapty
vendorProductId	string	The identifier of the product in the App Store Connect
vendorTransactionId	string	Transaction id from the App Store
vendorOriginalTransactionId	string	Original transaction id from the App Store. For auto-renewable subscription, this will be the id of the first transaction in the subscription
isActive	boolean	Whether the subscription is active
isLifetime	boolean	Whether the subscription is active for a lifetime (no expiration date). If set to true you shouldn't check expires_at, or you could just check isActive
activatedAt	Date	The time when the subscription was activated
renewedAt	Date (optional)	The time when the subscription was renewed
expiresAt	Date (optional)	The time when the subscription will expire (could be in the past and could be null for lifetime access)
startsAt	Date (optional)	The time when the subscription has started (could be in the future)
unsubscribedAt	Date (optional)	The time when the auto-renewable subscription was cancelled. Subscription can still be active, it just means that auto-renewal turned off. Will be set to null if a user reactivates the subscription
billingIssueDetectedAt	Date (optional)	The time when billing issue was detected (Apple was not able to charge the card). Subscription can still be active. Will be set to null if the charge will be made
isInGracePeriod	boolean	Whether the auto-renewable subscription is in the grace period
isSandbox	boolean	Whether the product was purchased in the sandbox environment
isRefund	boolean	Whether the purchase was refunded
willRenew	boolean	Whether the auto-renewable subscription is set to renew
activeIntroductoryOfferType	string (optional)	The type of active introductory offer. Possible values are: free_trial, pay_as_you_go, pay_up_front. If the value is not null, it means that the offer was applied during the current subscription period
activePromotionalOfferType	string (optional)	The type of active promotional offer. Possible values are: free_trial, pay_as_you_go, pay_up_front. If the value is not null, it means that the offer was applied during the current subscription period
activePromotionalOfferId	string (optional)	An identifier of active promotional offer
offerId	string (optional)	Offer identifier
cancellationReason	string (optional)	The reason why the subscription was cancelled. Possible values are: voluntarily_cancelled, billing_error, refund, price_increase, product_was_not_available, unknown

AdaptyProfile.NonSubscription

Information about the user's non-subscription purchases.

Name	Type	Description
purchaseId	string	The identifier of the purchase in Adapty. You can use it to ensure that you've already processed this purchase (for example tracking one time products)
store	string	The store of the purchase. The possible values are: app_store, play_store, adapty
vendorProductId	string	The identifier of the product in the App Store Connect
vendorTransactionId	string (optional)	Transaction id from the App Store
purchasedAt	Date	The time when the product was purchased
isSandbox	boolean	Whether the product was purchased in the sandbox environment
isRefund	boolean	Whether the purchase was refunded
isConsumable	boolean	Whether the product should only be processed once. If true, the purchase will be returned by Adapty API one time only

ProductReference

Name	Type	Description
vendorId	string	Vendor ID of the product
adaptyId	string	Adapty ID of the product
ios	object (optional)	iOS-specific properties
ios.promotionalOfferId	string (optional)	Promotional offer ID. iOS Only.
ios.winBackOfferId	string (optional)	Win back offer ID. iOS Only.
android	object (optional)	Android-specific properties
android.basePlanId	string (optional)	Base plan ID. Android Only.
android.offerId	string (optional)	Offer ID. Android Only.

AdaptyProductIdentifier

Interface representing a product identifier with vendor and platform-specific information.

Name	Type	Description
vendorProductId	string	The vendor-specific product identifier (e.g., App Store or Google Play product ID)
basePlanId	string (optional)	The base plan identifier for Google Play subscriptions (Android only)
adaptyProductId	string	Internal Adapty product identifier

AdaptyProfileParameters

Parameters for updating user profile.

Name	Type	Description
analyticsDisabled	boolean (optional)	Whether to disable analytics
codableCustomAttributes	object (optional)	Custom attributes to set
appTrackingTransparencyStatus	AppTrackingTransparencyStatus (optional)	App Tracking Transparency status
firstName	string (optional)	User's first name
lastName	string (optional)	User's last name
gender	Gender (optional)	User's gender
birthday	string (optional)	User's birthday
email	string (optional)	User's email
phoneNumber	string (optional)	User's phone number

AdaptyPurchaseResult

Union type representing purchase result.

Name	Type	Description
type	string	Result type. Possible values: pending, user_cancelled, success
profile	AdaptyProfile (optional)	Updated user profile (only present when type is success)

AdaptyAndroidPurchaseParams

Android purchase parameters structure.

Name	Type	Description
subscriptionUpdateParams	object (optional)	Android subscription update parameters
subscriptionUpdateParams.oldSubVendorProductId	string	The product id for current subscription to change
subscriptionUpdateParams.prorationMode	AdaptyAndroidSubscriptionUpdateReplacementMode	The proration mode for subscription update
isOfferPersonalized	boolean (optional)	Whether the offer is personalized
obfuscatedAccountId	string (optional)	Obfuscated account ID
obfuscatedProfileId	string (optional)	Obfuscated profile ID

AdaptyAndroidSubscriptionUpdateParameters

Android subscription update parameters (deprecated).

Name	Type	Description
oldSubVendorProductId	string	The product id for current subscription to change
prorationMode	AdaptyAndroidSubscriptionUpdateReplacementMode	The proration mode for subscription update
isOfferPersonalized	boolean (optional)	Whether the offer is personalized (deprecated, use AdaptyAndroidPurchaseParams instead)

Enums

VendorStore

• app_store - Apple App Store
• play_store - Google Play Store
• adapty - Adapty

OfferType

• free_trial - Free trial offer
• pay_as_you_go - Pay as you go offer
• pay_up_front - Pay up front offer

CancellationReason

• voluntarily_cancelled - User voluntarily cancelled
• billing_error - Billing error occurred
• refund - Purchase was refunded
• price_increase - Price was increased
• product_was_not_available - Product was not available
• unknown - Unknown reason

ProductPeriod

• day - Day period
• week - Week period
• month - Month period
• year - Year period

AdaptyAndroidSubscriptionUpdateReplacementMode

• charge_full_price - Charge full price
• deferred - Deferred
• without_proration - Without proration
• charge_prorated_price - Charge prorated price
• with_time_proration - With time proration

FetchPolicy

• reload_revalidating_cache_data - Always reload data from server
• return_cache_data_else_load - Return cached data if available, otherwise load from server
• return_cache_data_if_not_expired_else_load - Return cached data if not expired, otherwise load from server

LogLevel

• verbose - Logs any additional information that may be useful during debugging
• error - Logs only errors
• warn - Logs messages from the SDK that do not cause critical errors
• info - Logs various information messages

Gender

• f - Female
• m - Male
• o - Other

AppTrackingTransparencyStatus

• 0 - Not determined
• 1 - Restricted
• 2 - Denied
• 3 - Authorized
• 4 - Unknown

RefundPreference

• no_preference - No preference
• grant - Grant refund
• decline - Decline refund