> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yorlet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recover

> Escalate invoices more than 28 days overdue into a recovery case, with instalment plans and a success fee only on what is collected.

export const OverflowMenu = () => {
  return <span>overflow menu (•••)</span>;
};

Recover picks up where [automatic arrears reminders](/billing/arrears) stop. From the [Arrears page](https://dashboard.yorlet.com/billing/arrears), you send a customer's invoices that are more than 28 days past due into a **recovery case**. The customer then receives an escalated email sequence and a hosted page where they can pay in full or set up an [instalment plan](/billing/recovery/payment-plans) that collects itself.

You only pay a success fee on what Recover collects. There is nothing to pay up front, and if nothing is recovered you pay nothing.

## Enable Recover

To enable Recover, follow these steps:

1. Go to [Your plans](https://dashboard.yorlet.com/settings/plans).
2. Find **Recover** and click **Get started**.
3. Review the success-fee pricing and click **Enable Recover**.

Once enabled, a **Recovery** item appears under **Billing** in the sidebar, and a **Send to recovery** action appears on qualifying rows in [Arrears](https://dashboard.yorlet.com/billing/arrears) and [Invoices](https://dashboard.yorlet.com/invoices).

<Note>
  Recover only enrols invoices that are more than 28 days past due. Younger overdue invoices stay on the standard arrears reminder sequence, so the success fee never applies to payments those reminders would have collected.
</Note>

## Send invoices to recovery

To send a customer's overdue invoices to recovery, follow these steps:

1. Go to the [Arrears page](https://dashboard.yorlet.com/billing/arrears).
2. Find a customer whose oldest invoice is more than 28 days past due.
3. Open the row's <OverflowMenu /> and select **Send to recovery**.
4. Review the invoices that will be enrolled. Untick any you do not want to include. **Total to enrol** shows the amount outstanding across the selected invoices.
5. Click **Send to recovery**.

Yorlet opens a recovery case for that customer, emails them immediately, and takes you to the case.

You can also open existing cases from the [Recovery page](https://dashboard.yorlet.com/billing/recovery).

### Send several at once

Select the customers or invoices you want to enrol, then click **Send to recovery**.

* On [Arrears](https://dashboard.yorlet.com/billing/arrears), select customers whose oldest invoice is more than 28 days past due. Each customer’s eligible invoices are enrolled together.
* On [Invoices](https://dashboard.yorlet.com/invoices), select open invoices that are more than 28 days past due. Invoices for the same customer are grouped into one case.

If the customer already has an open recovery case, the invoices are added to it. You cannot add invoices while a payment plan is active.

### Add invoices to a case

To add further eligible invoices to an open case, follow these steps:

1. Open the case from the [Recovery page](https://dashboard.yorlet.com/billing/recovery).
2. Use the <OverflowMenu /> and select **Add invoices**.
3. Tick the invoices to enrol and click **Add invoices**.

## What your customer receives

As soon as you enrol a case, the customer is emailed a link to a hosted recovery page. On that page they can:

* See the overdue invoices and the amount outstanding.
* Pay the balance in full.
* Set up an [instalment plan](/billing/recovery/payment-plans) of 2, 3, 6 or 12 monthly payments, collected automatically from a payment method they add.

If they do not pay or set up a plan, Recover continues the email sequence on days 3, 7, 14, 21 and 28 after enrolment. The sequence stops if they accept a plan, clear the balance, or you cancel the case.

You can click **Copy recovery link** on the case, or open **View recovery page** from the <OverflowMenu />.

## Recovery case statuses

A recovery case can have one of the following statuses:

| Status        | Description                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `open`        | The case is chasing the outstanding balance. Escalated emails continue until the customer pays, sets up a plan, or you cancel. |
| `plan_active` | The customer has accepted an instalment plan. Remaining emails stop, and instalments are collected automatically.              |
| `recovered`   | Every enrolled invoice has been paid in full.                                                                                  |
| `canceled`    | You stopped the case. The invoices stay outstanding, and no further recovery fee is charged.                                   |

The case moves to `recovered` automatically once the enrolled invoices are fully paid, whether the customer paid in full, through a plan, or by another payment in Yorlet.

## View a recovery case

The [Recovery page](https://dashboard.yorlet.com/billing/recovery) lists every case, with tabs for **Open**, **Plan active**, **Recovered** and **Canceled**. Charts at the top of the page show recovered revenue over the selected period and the amount still outstanding on open and plan-active cases. The same Recover charts also appear on the [Billing overview](https://dashboard.yorlet.com/billing), and you can pin them to your home dashboard.

Open a case to see:

* The amount enrolled, recovered and still outstanding.
* The recovery fee charged so far, and the percentage applied.
* When the case was enrolled, when the customer was last contacted, and how many emails have been sent.
* The [instalment plan](/billing/recovery/payment-plans), if the customer has accepted one.
* The enrolled invoices.

## Cancel a recovery case

Cancelling stops the escalated emails, closes the hosted recovery page, and cancels any active instalment plan. The invoices remain outstanding and no further recovery fee is charged.

You can only cancel a case while it is `open` or `plan_active`.

To cancel a recovery case, follow these steps:

1. Navigate to the case you want to cancel.
2. Use the <OverflowMenu /> and select **Cancel case**.
3. Click **Cancel case** to confirm.

## Success fee

Recover charges a success fee of 5% on each payment collected against an enrolled invoice. The fee is deducted from the payment alongside your usual payment fees, and is shown on the case as **Recovery fee**.

* The fee only applies to payments against invoices enrolled in a recovery case.
* If you cancel the case, later payments on those invoices do not carry the fee.
* There is no monthly charge and nothing to pay if nothing is recovered.

<Tip>
  Use Recover for debt the standard reminder sequence has already had a chance to collect. That keeps the success fee on aged arrears, rather than on rent you would have collected anyway.
</Tip>
