From ea62be34b19e35c90e6f3f50206eda653e4e85a4 Mon Sep 17 00:00:00 2001 From: Ricardo Pallas Date: Thu, 22 Jan 2026 18:16:21 +0100 Subject: [PATCH] Update Consumption Request docs --- .../handling-refund-requests.md | 22 ++++++------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/docs/platform-resources/apple-platform-resources/handling-refund-requests.md b/docs/platform-resources/apple-platform-resources/handling-refund-requests.md index 6be33b46f..33ae2926b 100644 --- a/docs/platform-resources/apple-platform-resources/handling-refund-requests.md +++ b/docs/platform-resources/apple-platform-resources/handling-refund-requests.md @@ -60,7 +60,7 @@ Here's a template to help get you started: > > By using our app and making in-app purchases, you consent to our sharing of data regarding your usage and consumption of purchased content with Apple, as part of our efforts to resolve refund requests. This information may include details about how you have accessed and interacted with the purchased content. The purpose of sharing this data is to help Apple make an informed decision regarding refund requests. We ensure that such data sharing is done in compliance with Apple's policies and only as necessary to process your requests. -For general guidelines from Apple, visit their [documentation](https://developer.apple.com/documentation/appstoreserverapi/send_consumption_information#3921151). +For general guidelines from Apple, visit their [documentation](https://developer.apple.com/documentation/appstoreserverapi/send-consumption-information). If you have a use case where you only update your Terms & Conditions (or an equivalent document) for new customers, while existing customers remain on the original terms, contact [RevenueCat support](https://app.revenuecat.com/settings/support) for assistance. @@ -68,20 +68,12 @@ If you have a use case where you only update your Terms & Conditions (or an equi Below are the [properties](https://developer.apple.com/documentation/appstoreserverapi/consumptionrequest) and data that RevenueCat will send to Apple when a refund request comes in. -| Property | Description | What RevenueCat sends | -| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| accountTenure | The age of the customer’s account. | | -| appAccountToken | The optionally UUID of the in-app user account that completed the in-app purchase transaction. | Empty string | -| consumptionStatus | A value that indicates the extent to which the customer consumed the in-app purchase. | 0 (_undeclared_) | -| customerConsented | A Boolean value of true or false that indicates whether the customer consented to provide consumption data. | true, by turning this on this functionality, we assume you are asking your customers for consent. | -| deliveryStatus | A value that indicates whether the app successfully delivered an in-app purchase that works properly. | | -| lifetimeDollarsPurchased | A value that indicates the total amount, in USD, of in-app purchases the customer has made in your app, across all platforms. | Calculate the total of non-refunded transactions in USD and assess the [range](https://developer.apple.com/documentation/appstoreserverapi/lifetimedollarspurchased). | -| lifetimeDollarsRefunded | A value that indicates the total amount, in USD, of refunds the customer has received, in your app, across all platforms. | Calculate the total of refunded transactions in USD and assess the [range](https://developer.apple.com/documentation/appstoreserverapi/lifetimedollarsrefunded). | -| platform | A value that indicates the platform on which the customer consumed the in-app purchase. | | -| playTime | A value that indicates the amount of time that the customer used the app. | 0 (_undeclared_) | -| refundPreference | A value that indicates your preference, based on your operational logic, as to whether Apple should grant the refund. | | -| sampleContentProvided | A Boolean value of true or false that indicates whether you provided, prior to its purchase, a free sample or trial of the content, or information about its functionality. | true | -| userStatus | The status of the customer’s account. | | +| Property | Description | What RevenueCat sends | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| customerConsented | A Boolean value that indicates whether the customer consented to provide consumption data. | `true`, by enabling this functionality, we assume you are asking your customers for consent. | +| deliveryStatus | A value that indicates whether the app successfully delivered an in-app purchase that works properly. | | +| sampleContentProvided | A Boolean value that indicates whether you provided, prior to its purchase, a free sample or trial of the content, or information about its functionality. | `true` | +| refundPreference | A value that indicates your preference, based on your operational logic, as to whether Apple should grant the refund. | | :::info Share your feedback If you have any feedback about this feature, please reach out to our [RevenueCat support](https://app.revenuecat.com/settings/support) and we'll be happy to discuss your feedback or feature request!