<!-- generated by php artisan docs:split-brd from brd/BRD-Morvia-Project-Guide-en.md — edit the BRD, not this file -->

#### ADM-019 | Hall commissions and settlement
**Source:** p.81, p.110–111 · **Actor:** admin
- The admin sets **one commission rate** applied to provider bookings: a **global setting**, copied onto
  each booking's commission so a later change never alters it (DEC-22, BR-FIN-03).
  **Morvia commission = booking total × platform commission rate** (e.g. 2,000 SAR × 10% = 200 SAR).
- The commission is **not collected electronically**: the system only computes it, records it as a
  receivable on the provider and shows it in the admin dashboard and reports; it is collected outside
  the system.
- **Commission list:** booking number · provider · hall · booking value · Morvia rate · commission amount ·
  commission status · created at · settled at if any.
- **Commission statuses and lifecycle:** at Accepted → **Pending** (created) · at Booked → **Due** (same
  record updated) · after external collection → **Settled** (admin records the settlement) · when the
  admin cancels the booking → **Cancelled** (after verifying the booking was really cancelled).
- **Settlement:** after receiving the amount the admin chooses **Mark as Settled**, recording status
  Settled and the settlement date.
- **Rules:** no partial settlement; no multiple payments for one commission; no settlement batch; no
  automatic collection; no bank reconciliation; a commission either stays **Due** or becomes fully
  **Settled**.
- **Commission is income only once Booked (DEC-33):** the Pending commission at Accepted is not revenue;
  it becomes Due (revenue) when the provider confirms the booking, and any cancellation or withdrawal
  cancels it.
- **Built as (TD-30):** only the commission rate is built: `PUT /admin/hall-commission` and its history (old rate, new rate, admin, time). The commission list (`GET /admin/hall-commissions`) and Mark as Settled (`POST /admin/hall-commissions/{id}/settle`) are built (hall-bookings 1.0.0); the commission itself is created at Accepted and updated at Booked (TD-36).

**Acceptance, rules and screen notes citing ADM-019:**

- WF-07 — Hall booking — Trainer / center builds request (slots, attendees, features) → validation (capacity, availability, conflict) → Pending → provider accepts (contacts revealed, price fixed, commission Pending) or rejects → external payment → provider confirms Booked (commission Due = income) → Completed after last slot. Booker withdraws before Booked; a Booked booking is cancelled by the provider on the booker's request or offline with a reason; any cancellation cancels the commission (D8, DEC-33); admin settles commission — TRR-031, TRR-032, HPV-007, HPV-008, HPV-009, HPV-010, HPV-011, ADM-018, ADM-019, ADM-020
- BR-FIN-04 — Trainer payouts and hall commissions are settled outside the system and recorded by the admin. — ADM-019, ADM-038
- BR-HALL-14 — ~~Morvia's commission is due as soon as the provider accepts the request and contact details are revealed.~~ **Superseded (DEC-33):** the commission is Pending at Accepted and becomes due (income) only at Booked (BR-ADMIN-HALL-07/08). — HPV-008, ADM-019
- BR-HALL-15 — Morvia's commission is collected from the provider outside the system. — ADM-019
- BR-HALL-18 — Any cancellation or withdrawal cancels the commission linked to the booking (D8, DEC-33). — ADM-020, ADM-019
- BR-ADMIN-HALL-07 — When the booking moves to Accepted the commission is created as Pending. — ADM-019, HPV-008
- BR-ADMIN-HALL-08 — When the booking moves to Booked the same commission is updated from Pending to Due. — ADM-019, HPV-010
- BR-ADMIN-HALL-09 — No new commission record is created at Booked. — ADM-019
- BR-ADMIN-HALL-10 — The commission is collected outside Morvia. — ADM-019
- BR-ADMIN-HALL-11 — After collection the admin can move the commission from Due to Settled. — ADM-019
- BR-ADMIN-HALL-15 — Cancellation or withdrawal cancels the linked Pending or Due commission. — ADM-020, ADM-019
