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

# Scheduled Settlements

> Jane accepts a one-time settlement payment for next Friday.

## Real-World Example

Jane accepts a one-time settlement payment for next Friday. The account should appear under Scheduled Settlements until the scheduled payment is processed or otherwise changes state.

## Visual Flow

```mermaid placement="top-right" actions={true} theme={"system"}
flowchart TD
    A["Consumer schedules a settlement"] --> B["Portal creates scheduled transaction"]
    B --> C["Account appears in Scheduled Settlements"]
    C --> D{"Payment date arrives?"}
    D -->|Yes| E["Background job processes payment"]
    E --> F["Account moves to paid or failed state"]
    classDef default fill:#F8FAFC,stroke:#64748B,stroke-width:1.5px,color:#0F172A;
    classDef actor fill:#E0F2FE,stroke:#0284C7,stroke-width:2px,color:#0C4A6E;
    classDef system fill:#F8FAFC,stroke:#64748B,stroke-width:1.5px,color:#0F172A;
    classDef decision fill:#FEF3C7,stroke:#D97706,stroke-width:2px,color:#78350F;
    classDef risk fill:#FEE2E2,stroke:#DC2626,stroke-width:2px,color:#7F1D1D;
    classDef outcome fill:#DCFCE7,stroke:#16A34A,stroke-width:2px,color:#14532D;
    class A actor;
    class B,C,E system;
    class D decision;
    class F outcome;
    linkStyle default stroke:#94A3B8,stroke-width:2px;
```

## How It Should Work

* It should show one-time settlements that are accepted and scheduled but not completed.
* It should display the scheduled date, amount, and payment method context clearly.
* It should stay aligned with calendar events and payment history when the transaction changes.

## How It Should Not Work

* It should not show installment plans in this tab when they belong under Payment Plans.
* It should not keep a successful or cancelled settlement in scheduled status.
* It should not allow changes that break the accepted settlement agreement.

## Developer Notes

* Scheduled settlements depend on schedule transactions and background payment processing.
* Calendar sync should update when the settlement date or amount changes.

## Related App Areas

* `app/Enums/ConsumerStatus.php`
* `app/Livewire/Consumer/SchedulePlan.php`
* `app/Console/Commands/ProcessConsumerPaymentsCommand.php`
* `app/Jobs/Concerns/ProcessesScheduleTransactionPayments.php`