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

> ABC Collections requests merchant setup.

## Real-World Example

ABC Collections requests merchant setup. Super Admin sees a Merchant Requests badge, opens the request, reviews the details, and moves the request forward or resolves it.

## Visual Flow

```mermaid placement="top-right" actions={true} theme={"system"}
flowchart TD
    A["Creditor submits merchant request"] --> B["Sidebar badge increases"]
    B --> C["Super Admin reviews request"]
    C --> D{"Request approved?"}
    D -->|Yes| E["Merchant setup moves forward"]
    D -->|No| F["Request is closed or needs more info"]
    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,E outcome;
    class C system;
    class D decision;
    class F risk;
    linkStyle default stroke:#94A3B8,stroke-width:2px;
```

## How It Should Work

* It should show new merchant requests to Super Admin.
* It should keep request records tied to the correct creditor.
* It should update badge counts when requests are handled.

## How It Should Not Work

* It should not treat a creditor as payment-ready before merchant setup is complete.
* It should not expose one creditor merchant details to another.
* It should not leave handled requests counted as new.

## Developer Notes

* Merchant request count is surfaced in the Super Admin sidebar.
* Merchant readiness affects consumer scheduled payments.

## Related App Areas

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