How to build: Booking Management

List and change the guest’s bookings through Middleware Backend. Paid cancel needs a refunds folder (not live yet).

Routes: /account/bookings, /manage-booking, /modify-booking, /cancel-booking, /reservation/[reference].

---

My Bookings / Booking Details / Manage Booking / Reservation Status

Middleware Backend · winner · liveimplemented (UI still lists Core in getUserBookings)

GET https://middleware-dev.bookdirect.live/api/v1/nellalink/bookings

GET https://middleware-dev.bookdirect.live/api/v1/nellalink/bookings/{id}

Bearer required. Middleware lists this JWT only.

---

Modify Booking

Middleware Backend · winner · live

PUT https://middleware-dev.bookdirect.live/api/v1/nellalink/bookings/{id}

{
  "checkIn": "2026-10-02T14:00:00.000Z",
  "checkOut": "2026-10-05T11:00:00.000Z",
  "numGuests": 3
}

Only while pending (Middleware enforces).

---

Cancel Booking / Payment Status / Refund Status

Unpaid cancel:

Middleware Backend · winner · live

DELETE https://middleware-dev.bookdirect.live/api/v1/nellalink/bookings/{id}

Paid cancel / refund:

Middleware Backend · winner · to implement

POST https://middleware-dev.bookdirect.live/api/v1/bookdirect/refunds

No refunds folder in config/routes.json yet. Do not PUT Core booking to cancelled and walk away if money was captured.

Payment status: read the booking after webhook, or POST .../payments/verify/{reference}.