> ## 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.

# Instalment plans

> Let a customer spread a recovery case across monthly instalments that collect automatically.

When a customer cannot pay a [recovery case](/billing/recovery) in full, they can set up an instalment plan on the hosted recovery page. Yorlet then collects each instalment automatically from the payment method they add, until the enrolled invoices are paid or the plan is cancelled or defaults.

You do not create the plan from the Dashboard. The customer chooses the terms and accepts the plan themselves.

## How a plan is set up

On the hosted recovery page, the customer can:

1. Choose to set up a plan instead of paying in full.
2. Pick 2, 3, 6 or 12 monthly instalments.
3. Add a payment method.
4. Accept the plan.

The first instalment is collected immediately if it is already due. Remaining instalments are collected automatically on their due dates.

Once the plan is accepted, the recovery case moves to `plan_active` and the escalated email sequence stops.

## View a plan

Open the [recovery case](/billing/recovery) to see the instalment plan. Each instalment shows its due date, amount and status:

| Status     | Description                                                                                               |
| ---------- | --------------------------------------------------------------------------------------------------------- |
| `pending`  | The instalment is scheduled and has not been collected yet.                                               |
| `paid`     | The instalment was collected.                                                                             |
| `failed`   | The most recent collection attempt failed. Yorlet retries on following days.                              |
| `canceled` | The instalment will not be collected, because the debt was settled another way or the plan was cancelled. |

The plan itself can be:

| Status      | Description                                                                                     |
| ----------- | ----------------------------------------------------------------------------------------------- |
| `proposed`  | The customer has started a plan but has not accepted it yet.                                    |
| `active`    | Instalments are being collected.                                                                |
| `completed` | The enrolled invoices are settled. Remaining scheduled instalments are canceled.                |
| `defaulted` | Collection failed repeatedly, the plan was torn down, and the recovery case returned to `open`. |
| `canceled`  | You or a full settlement cancelled the plan.                                                    |

<Note>
  If an instalment fails, Yorlet retries collection for up to three days. After that the plan defaults, the recovery case returns to `open`, and escalated emails can resume.
</Note>

## Paying the balance in full

A customer with an active plan can still pay the remaining balance in full from the hosted recovery page. That settles the enrolled invoices, completes the recovery case, and cancels the rest of the plan.

## Cancel a plan

Cancelling a [recovery case](/billing/recovery) also cancels its active instalment plan. Future instalments are not collected. The invoices remain outstanding and the case is marked `canceled`. Amounts already paid stay applied to the enrolled invoices.