Skip to content

Conversation

@RPallas92
Copy link
Contributor

@RPallas92 RPallas92 commented Jan 22, 2026

Motivation / Description / Changes introduced

Once we release the Apple's Consumption Request V2 API (see PR), we have to update the developer docs

Before After
image image

Links to discussion, or Linear ticket (if applicable)

Additional comments

@RPallas92
Copy link
Contributor Author

This change is part of the following stack:

Change managed by git-spice.

>
> 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).
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this points to v1

| refundPreference | A value that indicates your preference, based on your operational logic, as to whether Apple should grant the refund. | <ul><li> The value for your customer's reserved customer attribute `$appleRefundHandlingPreference` </li><li>Otherwise, we will fall back to the option you chose in the dropdown selector</li></ul> |
| 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. | <ul><li> If the transaction exists in RC: 1 (_The customer’s account is active._)</li><li>If the transaction does not exist in RC: 0 (_undeclared_)</li></ul> |
| Property | Description | What RevenueCat sends |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note that the new API accepts 5 fields, but I am only documenting 4 of them.

The field I am not documenting is consumptionPercentage. It is only needed when refundPreference is partial refund. However, we do not support this in the dashboard (link to discussion)

@RPallas92 RPallas92 marked this pull request as ready for review January 22, 2026 17:22
@RPallas92 RPallas92 requested a review from a team as a code owner January 22, 2026 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants