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

# Creating Installments

> Schedule an installment plan on an Order using the Manage Installments component, either by frequency or by number of installments.

## Overview

You schedule installments from the **Manage Installments** component on an Order record page. The component reads the Order's eligible products, lets you preview a schedule, and then generates the installments.

Each generated installment is a `FCORE_PAY__Financial_Event__c` record with `Type__c = 'Installment'` and `Status__c = 'Pending'`, with one `FCORE_PAY__Financial_Event_Line__c` child per product in the split. fusionCore also writes a summary of the plan back to the Order — for example `Installment_Start_Date__c`, `Installment_Frequency__c`, and `Number_of_Installments__c`.

When you first open the component, its fields are pre-filled from the `Default` record of the `Installment_Generator_Setting__mdt` custom metadata type. See [Metadata Settings for Installments](/end-user-guides/orders/installments/metadata-settings-for-installments) to change those defaults.

## Prerequisites

* The Order is a draft quote or an unpaid invoice with a balance due greater than `$0`.
* The Order has order products, and at least one of them has **Allow Installments** checked. See [Enabling Installments](/end-user-guides/orders/installments/enabling-installments).

## How to Create an Installment Plan

<Steps>
  <Step title="Open Manage Installments">
    On the Order record page, click **Manage Installments**.

    <Frame caption="Manage Installments button on an Order">
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4857823292/image-20251209-171533.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=707299cad500506225be1a68d8e17039" alt="Manage Installments button on an Order record page" width="1889" height="686" data-path="images/end-user-guides/4857823292/image-20251209-171533.png" />
    </Frame>
  </Step>

  <Step title="Choose how to split the balance">
    Pick a plan type:

    * **By Frequency** — installments fall on a repeating cadence. Choose a **Frequency** of Quarterly, Monthly, Bi-Weekly, or Weekly.
    * **By Number of Installments** — you enter how many installments to create, and the balance is divided across them.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4857823292/Screenshot_2025-12-09_at_11.17.30-AM.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=38c364c097bb6d094d874f6349f41d89" alt="Manage Installments plan type set to By Frequency" width="1897" height="711" data-path="images/end-user-guides/4857823292/Screenshot_2025-12-09_at_11.17.30-AM.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4857823292/Screenshot_2025-12-09_at_11.17.37-AM.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=3c875ce63decd31a3770753ff17f7aa4" alt="Manage Installments plan type set to By Number of Installments" width="1885" height="709" data-path="images/end-user-guides/4857823292/Screenshot_2025-12-09_at_11.17.37-AM.png" />
    </Frame>
  </Step>

  <Step title="Select the products and calculate">
    Select the eligible products you want to split, then click **Calculate Installments**. This shows a preview of the schedule before any records are created.

    <Frame caption="Installment preview after clicking Calculate Installments">
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4857823292/image-20251209-172419.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=c674a6834a37a42ef510f248633fd33e" alt="Preview of calculated installments" width="1886" height="648" data-path="images/end-user-guides/4857823292/image-20251209-172419.png" />
    </Frame>
  </Step>

  <Step title="Generate the installments">
    Once the preview looks correct, click **Generate Installments**. fusionCore creates the installment Financial Events and writes the plan summary to the Order.

    <Frame caption="Generate Installments confirmation">
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4857823292/image-20251209-172539.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=788ddefeaa940965c282d301e666a163" alt="Generate Installments confirmation" width="1878" height="701" data-path="images/end-user-guides/4857823292/image-20251209-172539.png" />
    </Frame>
  </Step>

  <Step title="(Optional) Set up a payment method for auto-charge">
    If you want installments collected automatically, add a credit card or ACH payment method to the Order and click **Add and Continue**. Otherwise, click **Skip for now**.

    <Frame caption="Add a payment method or skip">
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4857823292/image-20251209-172822.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=a2751aa933a6c2f4aa7b708cebfade1f" alt="Add a payment method to the Order or skip for now" width="1897" height="560" data-path="images/end-user-guides/4857823292/image-20251209-172822.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  The amount is split in whole cents, and any rounding remainder is added to the **last** installment, so the installments always add up to the full balance.
</Note>

## Limitations and Common Pitfalls

* **Generation is blocked for some Order states.** You cannot generate installments when the Order is both a quote and already activated (`Installment_Generator_Error_Quote_And_Activated_Order`), when an invoice has a zero balance, or when the Order's status is Payment Received, Written Off, or Voided.
* **Unsupported frequencies fail.** A frequency value the calculator does not recognize throws an error rather than generating a partial plan.
* **Bad requests can no-op silently.** The installment calculator validates each request and may quietly produce nothing for an invalid one rather than raising an error, so always check the preview before generating.
* **By Number of Installments spaces dates unevenly.** When you split by number of installments, the dates are not guaranteed to be evenly spaced — this is by design.
* **The plan summary fields on the Order are formula-driven.** `Next_Installment_Date__c` and `Next_Installment_Balance_Due__c` are formula fields and cannot be edited directly.
