# Projected billing report

> These are the ODUS guides for Core API v2. Core API v1 and Checkout SDK versions before 1.12.0 stop working at 00:00 UTC on 4 November 2026. See [Upgrading from v1 to v2](https://docs.odus.com/docs/guides/upgrading/v1-to-v2.md). Every page is listed in [llms.txt](https://docs.odus.com/llms.txt). To read your own ODUS data, [connect your AI assistant to the ODUS MCP server](https://docs.odus.com/docs/guides/ai-connector.md).

The **Projected billing** report shows the subscription charges coming up. Each active subscription counts once, by its next scheduled charge: a rebill, which is its next renewal, or a recycle, which is the next retry of a renewal that failed. Choose it in the **Report** menu of [Explore](https://docs.odus.com/docs/guides/dashboard/insights/.md).

## Which charges it counts

Each charge falls into a bucket by its position:

| Bucket          | The charge                                                |
| --------------- | --------------------------------------------------------- |
| **Rebill #1**   | A subscription's first renewal after its initial purchase |
| **Rebill #2**   | Its second renewal                                        |
| **Rebill #3**   | Its third renewal                                         |
| **Rebill #4+**  | Its fourth renewal or a later one                         |
| **Recycle #1**  | The first retry of a renewal that failed                  |
| **Recycle #2**  | The second retry                                          |
| **Recycle #3**  | The third retry                                           |
| **Recycle #4+** | The fourth retry or a later one                           |

The date range selects charges by their billing date, in your timezone: the renewal date of a rebill, the next retry of a recycle. The report looks forward, so it starts on **Next 7 days**, and the **Date range** menu offers **Today**, **Next 7 days**, **Next 14 days**, **Next 4 weeks**, **Next 3 months** and **Next 6 months**. A saved insight keeps the period relative to the day you open it. A **Custom** date range that ends before the start of yesterday, UTC, is refused, and so is a comparison with a period that does.

## Approval rates

**Projected revenue** multiplies each charge by the approval rate of its bucket: the share of those charges expected to succeed. Under **Approval rates**, each bucket has a field for its rate.

Leave a field empty and the bucket uses the approval rate your own charges in it achieved up to yesterday, over the days **Measured over** names: the last 30 days, 90 days, 6 months or 12 months, or **All time**, your whole history, which it starts on. Until those days have been measured, the rate covers the renewals billed on as many full days before today, in your timezone, but never more than the last 90. A saved insight keeps the **Measured over** you chose. The empty field shows that rate, and the info icon beside its name says how many charges it was measured from. Type a rate from 0 to 100 to project the bucket at it instead, for example to see what a better rate would bring in. Clear the field to go back to the measured rate.

The measured rates count each renewal of each subscription by its position, and only the charges your gateway answered with an approval or a decline:

* Its first charge counts in its **Rebill** bucket.
* Each retry counts in the **Recycle** bucket of its place in your retry schedule: the second retry is **Recycle #2**, even when the first got no answer. A retry that was never sent to your gateway is not seen, so the retries after it count one bucket earlier.
* A charge your gateway did not answer is left out, and so is a retry not made yet. When an unanswered charge is sent again within minutes, the charge that answered counts in its place.
* A renewal of several subscriptions charged together counts once for each subscription in it that is not free.
* A free renewal is left out, since nothing is charged for it.

The rates are measured over all your renewals, whatever filters the insight sets, from the charges made before today: a charge made today, and its approval, count from tomorrow.

A saved insight keeps the rates you typed, and follows the measured rate of every bucket you left empty, so its projection changes as your charges are approved or declined. A bucket with no charges in the measured days has no measured rate: until you type a rate for it, its charges are left out of **Projected revenue**, and **Attempts with no rate** counts them.

The rates apply after the filters, so filtering to one bucket projects that bucket alone.

## Results

The **Results** table lists **Projected revenue** for each day, week or month of the period, with the total last, or the total alone when **Interval** is **Total**. Hover over a value, or move to it with the Tab key, to see how it was projected, one bucket to a line: its charges, their average amount, its rate and what they project, for example `Rebill #1: 120 × $50.00 × 92% = $5,520.00`. A bucket with no rate says so, as in `Recycle #4+: 1 charge, no rate`. Each charge is projected and rounded on its own, so the lines can add up to slightly more or less than the value. The explanation is shown when the insight has no breakdown.

## Measures

Explore charts **Projected revenue**, the only measure it offers for this report. The others below count and sum the upcoming charges bucket by bucket.

| Measure                                          | What it counts                                                                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| **Scheduled attempts**                           | The upcoming charges, rebills and recycles together: each active subscription's next scheduled charge, counted once.     |
| **Projected revenue**                            | What the upcoming charges are projected to collect: each charge's amount multiplied by the approval rate of its bucket.  |
| **Attempts with no rate**                        | The upcoming charges left out of **Projected revenue**: you typed no rate for their bucket, and it has no measured rate. |
| **Rebill #1 attempts**, **Rebill #1 amount**     | How many **Rebill #1** charges are coming up, and what they bill before any approval rate.                               |
| **Rebill #2 attempts**, **Rebill #2 amount**     | How many **Rebill #2** charges are coming up, and what they bill before any approval rate.                               |
| **Rebill #3 attempts**, **Rebill #3 amount**     | How many **Rebill #3** charges are coming up, and what they bill before any approval rate.                               |
| **Rebill #4+ attempts**, **Rebill #4+ amount**   | How many **Rebill #4+** charges are coming up, and what they bill before any approval rate.                              |
| **Recycle #1 attempts**, **Recycle #1 amount**   | How many **Recycle #1** charges are coming up, and what they bill before any approval rate.                              |
| **Recycle #2 attempts**, **Recycle #2 amount**   | How many **Recycle #2** charges are coming up, and what they bill before any approval rate.                              |
| **Recycle #3 attempts**, **Recycle #3 amount**   | How many **Recycle #3** charges are coming up, and what they bill before any approval rate.                              |
| **Recycle #4+ attempts**, **Recycle #4+ amount** | How many **Recycle #4+** charges are coming up, and what they bill before any approval rate.                             |

## Breakdowns and filters

The **Breakdown** column says whether you can choose the entry in **Break down by**, and the **Filter** column whether you can filter on it.

| Name                | Breakdown | Filter | What it means                                                                                                                                                                                        |
| ------------------- | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Currency**        | Yes       | Yes    | The currency the charge bills in.                                                                                                                                                                    |
| **Gateway profile** | Yes       | Yes    | The gateway profile the subscription bills through.                                                                                                                                                  |
| **Product**         | Yes       | Yes    | The product of the price the subscription bills on.                                                                                                                                                  |
| **Price**           | Yes       | Yes    | The price the subscription bills on.                                                                                                                                                                 |
| **Amount due**      | No        | Yes    | The charge's amount before any approval rate, in its own currency and not converted: **Amount due** at least `50` keeps charges of 50 or more in their own currency, such as 50 dollars or 50 euros. |
| **Attempt type**    | No        | Yes    | **Rebill** for a subscription's next renewal, or **Recycle** for the next retry of a renewal that failed.                                                                                            |
| **Attempt bucket**  | No        | Yes    | The charge's bucket, **#1** to **#4+**, where **#4+** holds the fourth charge and every later one. With **Attempt type**, it selects one bucket, such as the second retries.                         |

**Gateway profile**, **Product** and **Price** have no **Unspecified**: broken down by any of them, a charge with no value for it is left out, and the total leaves it out as well.
