Refund Requests Outcomes Chart
This chart is available in Charts v2 and Charts v3.
When customers request a refund for their App Store or Google Play purchases, they must do so directly through the stores. The Refund Requests Outcomes chart tracks refund and chargeback events, breaking them down by resolution status: Refund Granted, Refund Declined, Refund Reversed, No Resolution, and Total Requests.
To ensure RevenueCat receives notifications about these requests, configure Apple App Store Server Notifications for each Apple app and Google Real-Time Developer Notifications for each Google Play app in your project. For the most accurate and timely App Store data, we recommend using Apple's V2 notifications.
Measures
The Refund Requests Outcomes chart includes two measures:
- Refund Requests: The number of refund review requests RevenueCat received.
- Refund Request Amount: The amount associated with those refund review requests. What this amount represents depends on the request outcome.
Available settings
- Filters: Yes
- Segments: Yes
How to use Refund Requests Outcomes in your business
This chart provides insight into the outcomes of refund requests for your App Store or Google Play purchases, showing the volume of granted, declined, reversed, and unresolved requests. By analyzing these trends, you can identify shifts in approval patterns and understand how frequently your customers are requesting refunds.
It may be especially useful to analyze your refund requests by the refund reasons that your customers are giving. Segmenting the chart by "Refund request reason" and using the 100% stacked column chart type lets you see how often customers cite reasons like "Unintended Purchase" or "Unsatisfied with Purchase", helping you pinpoint specific areas for improvement. For example, a high volume of refund requests under "Unsatisfied with Purchase" might suggest a need to refine descriptions or messaging.
Google Play currently only supports chargebacks for refund review, so that is the only refund request reason available for Google Play rows.
Apple provides refund request reasons through V2 notifications. If App Store rows show only "Unknown" when segmenting by "Refund request reason", your app is most likely using Apple's V1 notifications.
Use Refund Control to configure how RevenueCat responds to Apple and Google refund review requests. A good Refund Control setup should show a balance between Refund Declined and Refund Granted requests. That balance should also be reflected in Refund Request Amount. The Refund Declined amount represents revenue retained by declining refund requests that otherwise would have been granted.
Calculation
Each period counts refund review requests that match a tracked RevenueCat transaction, broken down by outcome. Sandbox requests are excluded.
Requests are counted in the period when RevenueCat received the refund request, not when the purchase happened and not necessarily when the refund was finalized.
Google Play data is available for requests received on or after August 21, 2026, at 17:00 UTC.
Outcome breakdown
| Outcome | Meaning |
|---|---|
| Refund Granted | The store approved the refund. |
| Refund Declined | The store declined the refund, or RevenueCat inferred a decline after the store's waiting period. |
| Refund Reversed | Apple reversed a previously granted refund. Not available for Google Play. |
| No Resolution | The request is recent and no final outcome has been observed yet. |
| Total Requests | The total number of matched refund review requests received. |
The window for unresolved requests is 2 days for App Store purchases and 7 days for Google Play purchases. Requests remain No Resolution during this window, which starts when RevenueCat receives the request.
After the window, RevenueCat classifies unresolved requests as Refund Declined if no refund grant has been observed.
Google Play doesn't send refund declined events, so RevenueCat infers these outcomes. A later grant changes the outcome to Refund Granted, even after the 7-day window.
With V1 notifications, Apple only sends events for granted refunds. RevenueCat classifies unresolved requests as Refund Declined after the 2-day window if no grant has been observed. V2 notifications include granted and declined events, so RevenueCat can update No Resolution when either outcome arrives.
Refund Request Amount
Refund Request Amount is the amount tied to the refund review request. Its meaning depends on the outcome:
| Outcome | What Refund Request Amount represents |
|---|---|
| Refund Granted | The refunded amount |
| Refund Declined | The purchase amount that was at risk and was not refunded |
| Refund Reversed | The original granted refund amount that was reversed |
| No Resolution | The purchase amount still pending an outcome |
This chart only includes refunds where RevenueCat received a refund review request. The Refunds Chart includes all refunds, including refunds that did not go through the refund request or review flow.
Google Play chargebacks are refund review outcomes, but they are distinct from standard store refund events. A granted Google Play chargeback may therefore appear in this chart without appearing as a Refunded Transaction in the Refunds chart or as a refund deduction in the Revenue chart.