Customer History

The 'Customer History' card shows a timeline of transactions and activity for the selected customer. These can be useful for debugging and triaging support issues by understanding when critical events happened for the customer.

The timeline events are generated from changes to the user's purchase receipt. This is the raw purchase data from Apple/Google presented in a more readable form and enhanced with RevenueCat price estimates. If there's no purchase history present, then the user either never sent RevenueCat a receipt or the receipt is empty.


If the Customer History is empty, it means we haven't received a purchase receipt for the user. If you think this may be a mistake, check out our community article on re-syncing a user's purchases.


Event Types

Below is a table with all the event types you can expect in the customer history and a description of what they mean.


User Description

Webhook Event

Made a purchase

Purchased a non-renewing product


Started a subscription

Started a subscription without any free trial period.


Started a trial

Started a subscription with a $0 introductory price.


Converted from a trial

Entered a paid subscription period after previously starting a trial.



Entered a paid subscription period after previously being in a paid period.


Changed renewal preference

Changed the product identifier of an existing subscription.


Opted out of renewal

Disabled the auto-renew status for an active subscription.



Re-enabled the auto-renew status for an active subscription after previously cancelling.


Had a billing issue

Apple / Google received an error when attempting to charge the user's credit card.


Was issued a refund

Apple customer support cancelled and refunded a user's subscription, or a Google subscription was refunded through RevenueCat.


Cancelled due to not agreeing to a price increase

Did not agree to a price increase.


Cancelled due to a billing error

Apple / Google was not able to charge the user's credit card and their subscription failed to renew.


Cancelled due to unknown reasons

Apple cancelled the user's subscription and did not provide a cancellation reason.


Created a new alias

Was aliased with another App User Id.



Missing or incorrect prices

It is possible for prices to be missing or incorrect, especially for apps that have migrated from a different system to RevenueCat. The stores provide very minimal pricing information for developers, so RevenueCat estimates the transaction price based off the data that is available - if you have old products that are no longer available for sale or changed the price of your products before using RevenueCat, you can expect some prices to be missing or incorrect. We do our best to backfill prices over time if more up-to-date information becomes available.

Event Details

You can click into events in the Customer History to view additional details about the event, including any integrations that may have been triggered as a result of the event.


Refunding Purchases

Android purchases can be refunded directly through the RevenueCat dashboard. Granting a refund will immediately expire the subscription and remove any entitlement access. By refunding directly through RevenueCat you can ensure that refunds are accounted for in all charts and integrations.

Apple doesn’t allow developers to grant refunds themselves, only through Apple customer support. However, Apple refunds are tracked with RevenueCat and accounted for in all charts and integrations.


Next Steps

Did this page help you?