Black Friday
Skip to documentation content

Booking Operations

Understand booking status and payment status

A booking's stay status and its payment status answer different questions. A saved reservation can be Pending while its payment is Paid; a cancelled booking can still need a refund. Read both values before taking action.

A booking’s stay status and its payment status answer different questions. A saved reservation can be Pending while its payment is Paid; a cancelled booking can still need a refund. Read both values before taking action.

Read the two records

Open Hotel Booking → Bookings and select the booking. Check its dates, room quantity, booking status, payment history and activity log.

Record States Meaning
Booking Pending, Confirmed, Checked In, Checked Out, Cancelled, No-show The reservation’s operational lifecycle
Payment Unpaid, Partially Paid, Paid, Partially Refunded, Refunded The result of settled payment and refund ledger entries
Gateway attempt Pending, failed, cancelled or other provider state An individual attempt; it cannot replace settled ledger facts

Payment status is derived from the ledger and is read-only in booking administration. A browser return saying success, an initiated payment or a pending refund is not a settled financial entry. A latest failed attempt does not erase an earlier received payment.

Choose the correct action

  • To accept a Pending booking, use the available booking transition after reviewing inventory and hotel procedure.
  • To record money actually received outside an online gateway, use Record Payment with an auditable reference.
  • To return money, follow the refund workflow for the original payment owner. Changing booking status does not send funds.

Receipt layouts can vary with the theme. Where the receipt contract is enabled, an unavailable ledger is shown as unknown: missing Paid or Balance amounts must not be interpreted as zero. Staff should investigate the stored transaction rather than override a display label.

Verify and recover

After an action, reload the booking and compare the activity log with settled amounts. Do not edit database status columns to force agreement. Preserve a redacted booking code, timestamp, amount and provider state for support; never include access tokens or payment credentials.

See lifecycle actions and payment recovery.

Was this article helpful?

Your feedback helps us improve the documentation.