Confirm Booking

POST

/properties/{tenant_id}/bookings/{booking_id}/confirm

Confirm a pending booking, optionally adding payments. The booking status will be updated to “confirmed”.

Scope Required: bookings:write

URL Parameters:

• booking_id (required): The booking code to confirm (must exist and be in pending status)

Body Parameters:

• payments (optional): Array of payment records to attach during confirmation
• payments[].amount (required): Payment amount (numeric, min: 0)
• payments[].method (optional): Payment method (one of system payment method (cash, bank_transfer, debt, atm_transfer, credit_card, apple_pay, pos, wechat_pay..v.v))
• payments[].paid_at (optional): Payment date (format: Y-m-d H:i:s)
• payments[].notes (optional): Payment notes (max: 500 characters)

Important Notes:

• Only pending bookings can be confirmed
• Payments are optional - booking can be confirmed without payment
• Booking status will be updated to “confirmed” automatically
• If booking is already confirmed, checked_in, checked_out, or cancelled, the request will fail

Authorizations

• http

Parameters

Path Parameters

tenant_id

required

string

booking_id

required

string

Request Body ^required

ConfirmBookingRequest

object

booking_id

required

string

payments

array | null

object

amount

required

number

method

string | null

paid_at

string | null format: date-time

Example

2025-11-19 16:54:00

notes

string | null

<= 500 characters

Responses

200

object

422

Validation error

object

message

required

Errors overview.

string

errors

required

A detailed description of each field that failed validation.

object

key

additional properties

Array<string>