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

# Merchant Request Lifecycle

> ABC Collections submits a merchant request.

## Real-World Example

ABC Collections submits a merchant request. Super Admin sees the new request badge, reviews the request, and either moves it forward or asks for more information before consumer payments can safely use that merchant path.

## Visual Flow

```mermaid placement="top-right" actions={true} theme={"system"}
flowchart TD
    A["Creditor submits merchant request"] --> B["Super Admin badge count updates"]
    B --> C["Operator reviews request"]
    C --> D{"Ready to approve?"}
    D -->|Yes| E["Merchant path moves forward"]
    D -->|No| F["More information is requested"]
    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,F system;
    class D decision;
    class E outcome;
    class F risk;
    linkStyle default stroke:#94A3B8,stroke-width:2px;
```

## How It Should Work

* It should make new merchant requests visible through the Super Admin badge count.
* It should keep review status clear for platform operators and creditor users.
* It should block consumer payment readiness until the merchant path is valid.

## How It Should Not Work

* It should not approve incomplete merchant requests.
* It should not lose badge updates when requests are created or resolved.
* It should not mix one creditor merchant request with another creditor account.

## Developer Notes

* Merchant requests are platform review items with downstream payment impact.
* Badge counts are cached and refreshed through sidebar badge events.

## Related App Areas

* `app/Livewire/Creditor/MerchantRequest/ListPage.php`
* `app/Livewire/Creditor/MerchantRequest/Create.php`
* `app/Services/MerchantRequestService.php`
* `app/View/Composers/SidebarComposer.php`