TEST

Test event issued through the RevenueCat dashboard.

✅

✅

❌

❌

❌

INITIAL_PURCHASE

A new subscription has been purchased.

✅

✅

✅

✅

❌

NON_RENEWING_PURCHASE

A customer has made a purchase that will not auto-renew.

✅

✅

✅

✅

✅

RENEWAL

An existing subscription has been renewed. This may occur at the end of the current billing period or later if a lapsed user re-subscribes.

✅

✅

✅

✅

❌

PRODUCT_CHANGE

A subscriber has changed the product of their subscription.

✅

✅

❌

✅

❌

CANCELLATION

A subscription or non-renewing purchase has been cancelled. See cancellation reasons for more details.

✅

✅

✅

✅

✅

UNCANCELLATION

Auto-renew status has been re-enabled for a subscription.

✅

✅

✅

❌

❌

BILLING_ISSUE

There has been a problem trying to charge the subscriber. This does not mean the subscription has expired.

✅

✅

✅

✅

❌

SUBSCRIBER_ALIAS

Deprecated. A new app_user_id has been registered for an existing subscriber.

SUBSCRIPTION_PAUSED

A subscription has been paused.

❌

✅

❌

❌

❌

TRANSFER

A transfer of transactions and entitlements was initiated between one App User ID(s) to another.

✅

✅

✅

✅

❌

EXPIRATION

Beta: A subscription has expired and access should be removed.

This event should happen shortly after an expiration, but there can be delays.

✅

✅

✅

✅

✅

type

String

Type of the event.

TEST

INITIAL_PURCHASE

NON_RENEWING_PURCHASE

RENEWAL

PRODUCT_CHANGE

CANCELLATION

BILLING_ISSUE

SUBSCRIBER_ALIAS

SUBSCRIPTION_PAUSED

TRANSFER

id

String

Unique identifier of the event.

app_id

String

Unique identifier of the app the event is associated with. Corresponds to an app within a project.

This value will soon be visible in the app's configuration page in project settings.

event_timestamp_ms

Integer

The time that the event was generated. Does not necessarily coincide with when the action that triggered the event occurred (purchased, cancelled, etc).

app_user_id

String

Last seen app user id of the subscriber.

original_app_user_id

String

The first app user id used by the subscriber.

aliases

[String]

All app user ids ever used by the subscriber.

product_id

String

Product identifier of the subscription.

entitlement_ids

[String]

Entitlement identifiers of the subscription.

It can be NULL if the product_id is not mapped to any entitlements.

entitlement_id

String

Deprecated. See entitlement_ids.

Deprecated. See entitlement_ids.

period_type

String

Period type of the transaction.

TRIAL, for free trials.

INTRO, for introductory pricing.

NORMAL, standard subscription.

PROMOTIONAL, for subscriptions granted through RevenueCat.

purchased_at_ms

Integer

Time when the transaction was purchased. Measured in milliseconds since Unix epoch

grace_period_expiration_at_ms

Integer

Only available for BILLING_ISSUE events.

The time that the grace period for the subscription would expire. Measured in milliseconds since Unix epoch. Use this field to determine if the user is currently in a grace period.

It can be NULL if subscription does not have a grace period.

expiration_at_ms

Integer

Expiration of the transaction. Measured in milliseconds since Unix epoch. Use this field to determine if a subscription is still active.

It can be NULL for non-subscription purchases.

auto_resume_at_ms

Integer

The time when an Android subscription would resume after being paused. Measured in milliseconds since Unix epoch.

Only available for Play Store subscriptions and SUBSCRIPTION_PAUSED events.

store

String

Store the subscription belongs to.

AMAZON

APP_STORE

MAC_APP_STORE

PLAY_STORE

PROMOTIONAL

STRIPE

environment

String

Store environment.

SANDBOX

PRODUCTION

is_trial_conversion

Boolean

Only available for RENEWAL events.

Whether the previous transaction was a free trial or not.

true or false

cancel_reason

String

Only available for CANCELLATION events.

See Cancellation and Expiration Reasons.

UNSUBSCRIBE

BILLING_ERROR

DEVELOPER_INITIATED

PRICE_INCREASE

CUSTOMER_SUPPORT

UNKNOWN

expiration_reason

String

Only available for EXPIRATION events.

See Cancellation and Expiration Reasons.

UNSUBSCRIBE

BILLING_ERROR

DEVELOPER_INITIATED

PRICE_INCREASE

CUSTOMER_SUPPORT

UNKNOWN

new_product_id

String

Product identifier of the new product the subscriber has switched to. Only available for App Store subscriptions and PRODUCT_CHANGE events.

presented_offering_id

String

Not available for apps using legacy entitlements.

The identifier for the offering that was presented to the user during their initial purchase.

price

Double

The USD price of the transaction.

Can be NULL if the price is unknown, and 0 for free trials.

Can be negative for refunds.

currency

String

The ISO 4217 currency code that the product was purchased in.

USD, CAD, etc.

Can be NULL if the currency is unknown.

price_in_purchased_currency

Double

The price of the transaction in the currency the product was purchased in.

Can be NULL if the price is unknown, and 0 for free trials.

Can be negative for refunds.

takehome_percentage

Double

The estimated percentage of the transaction price that will be paid out to developers after the Apple/Amazon/Google platform fee.

0.7 or 0.85

subscriber_attributes

Map of attribute names to attribute objects.

For more details see the subscriber attributes guide.

transaction_id

String

Transaction identifier from Apple/Amazon/Google/Stripe.

original_transaction_id

String

transaction_id of the original transaction in the subscription from Apple/Amazon/Google/Stripe.

is_family_share

Boolean

Indicates if the user made this purchase or if it was shared to them via Family Sharing.

true or false

Always false for non-Apple purchases.

transferred_from

[String]

This fields is only available when type is set to TRANSFER.

App User ID(s) that transactions and entitlements are being taken from, and granted to transferred_to.

transferred_to

[String]

This field is only available when type is set to TRANSFER.

App User ID(s) that are receiving the transactions and entitlements taken from transferred_from.

country_code

String

The ISO 3166 country code that the product was purchased in.

The two-letter country code (e.g., US, GB, CA) of the app user's location (this country code is derived from the last seen request from the SDK for the subscriber.)

US, CA, etc.

offer_code

String

This field is not available when type is set to SUBSCRIBER_ALIAS or TRANSFER.

The offer code that the customer used to redeem the transaction.

Available for App Store and Play Store. For App Store this property corresponds to the offer_code_ref_name. For Play Store this corresponds to the promotionCode.

Can be null if no offer code was used for this product.

UNSUBSCRIBE

Subscriber cancelled voluntarily. This event fires when a user unsubscribes, not when the subscription expires.

✅

✅

✅

✅

❌

BILLING_ERROR

Apple, Amazon, orGoogle could not charge the subscriber using their payment method.

The CANCELLATION event with cancellation reason BILLING_ERROR is fired as soon as the billing issue has been detected. The EXPIRATION event with expiration reason BILLING_ERROR is fired if the grace period (if set up) has ended without recovering the payment, and the customer should lose access to the subscription.

✅

✅

✅

❌

❌

DEVELOPER_INITIATED

Developer cancelled the subscription.

✅

✅

❌

❌

✅

PRICE_INCREASE

Subscriber did not agree to a price increase.

✅

❌

❌

❌

❌

CUSTOMER_SUPPORT

Customer cancelled through Apple support and received a refund, a Play Store subscription was refunded through RevenueCat, an Amazon subscription was refunded through Amazon support, or a web subscription was refunded.

✅

✅

✅

✅

❌

UNKNOWN

Apple did not provide the reason of the cancellation.

✅

❌

❌

❌

❌

SUBSCRIPTION_PAUSED

The subscription expired because it was paused (only EXPIRATION event)

❌

✅

❌

❌

❌