Chart · Churn and refunds

Refunds Chart: Refunded Revenue and Transactions by Refund Date

The Refunds chart shows the money refunded and the number of refunded transactions in each period, placed on the date of the refund, not the date of the purchase. Reversed refunds are subtracted. The money is in USD, and you can segment it by store, product, country and more.

Formula

Refunded revenue = refunds recorded in the period - refunds reversed in the period

Shape

What happened during each period

API name

refunds

Measures

Refunded Revenue (USD), Refunded Transactions (Count)

Filter and segment by

App, Store, Product, Product duration, Offering, Country, Platform, App version

The Refunds chart in the RevenueDot dashboard, with demo data, its chart rail, plot and table
Captured from the RevenueDot dashboard with demo data.

Definition

How RevenueDot calculates Refunds

Every refund and every refund reversal is a row in the transaction ledger. In each period RevenueDot adds the refunded amounts as positive refunded revenue and counts one refunded transaction per refund. A reversal in the same period removes its amount and one count. Refunds count on the refund date, the same rule the Revenue chart uses when it subtracts refunds.

Money is in USD under the same rules as every money chart, and you can show another display currency. Sandbox purchases, granted access and Family Sharing are excluded. Filters and segments: app, store, product, product duration, offering, country, platform and app version. You can open it in the dashboard under Charts or fetch it with GET /v2/projects/{project_id}/charts/refunds. The response has the same shape as RevenueCat's Charts API, so scripts written for that API keep working. The secret key needs the charts_metrics:charts:read permission. The Charts guide lists every parameter.

Worked example

Refunds, step by step

One week of refunds recorded by RevenueDot.

MeasureTransactionsAmount
Refunds recorded in the week30$270
Refunds reversed in the week2$18

The chart shows 28 refunded transactions and $252 of refunded revenue for the week.

Why it matters

What Refunds tells you

Refunds is the cash view. It tells you how much revenue left the account this week, which is what reconciles against your store payouts and against the Revenue chart. A spike is something you can act on today, for example after a bad release, a billing bug or a wave of Apple refund requests.

Use it with Refund Rate. Refunds shows how much went out and when. Refund Rate shows how many of each period's purchases were refunded, which tells you whether the rate is changing or the volume is.

How to read it

  • A big refund on one day can come from a refund of an old annual purchase. Check the date of purchase in the customer view.
  • The count and the amount are separate measures. A few large refunds and many small refunds look different.
  • Segment by store when a refund spike appears, then by product.
  • Revenue already includes refunds. Do not subtract Refunds from Revenue a second time.
  • Refunded transactions can go down in a period when reversals exceed refunds.

API

Get Refunds from the Charts API

Same path and response shape as RevenueCat's Charts API, so existing scripts keep working.

Requestshell
curl "https://api.revenuedot.app/v2/projects/$PROJECT_ID/charts/refunds?resolution=day" \
  -H "Authorization: Bearer $SECRET_KEY"   # sk_... with charts_metrics:charts:read

Reference: Charts guide · REST API v2

FAQ

Refunds: questions people ask

Do refunds show on the purchase date or the refund date?

On the refund date. A refund in March for a January purchase shows in March.

Does the revenue chart already subtract refunds?

Yes. Revenue subtracts refunds recorded in the period, on the refund date.

What happens when Apple reverses a refund?

The reversal subtracts the amount and one transaction from refunds in the period it is recorded.

Can I see refunds by product?

Yes. Segment the chart by product, store, offering or country.

Get started

See your Refunds in minutes.

Connect your app to RevenueDot Cloud, free up to $10,000 a month in tracked revenue, and all 43 charts fill from your store history after import.

Already have an account? Sign in · Prefer your own servers? Self-host free