Hotel Booking Pro 1.39.0 adds two settings under Hotel Booking → Settings → Payments, below Payment policy. Booking confirmation decides whether a booking paid online is confirmed automatically or waits for hotel staff. Unpaid online checkout hold releases rooms when a guest chooses an online payment but does not complete it.
Before you start
- Update to Hotel Booking Pro 1.39.0 or later and KimoraPro Hotel Booking (free) 3.28.1 or later. Version 3.30.0 of the free plugin is recommended. With version 3.28.0, the two sections do not appear and both settings stay off.
- Both settings need the online payments feature of your Hotel Booking Pro license. Releasing rooms also needs the cancellations and refunds feature. Without them, the sections show a notice and every booking waits for staff.
- Make sure WordPress cron runs regularly. WP-Cron only runs when someone visits the site, so production sites should run it from a real server cron job.
- Test with each gateway’s sandbox or test mode before relying on these settings for live bookings.
Choose how bookings are confirmed
- Go to Hotel Booking → Settings → Payments and find Booking confirmation.
- Choose Manual — staff confirm every booking. or Automatic for online payments.
- Click Save booking confirmation.
Manual is the default, also after upgrading: every new booking stays Pending until hotel staff confirm it, even when it is paid online. The setting is checked when a payment arrives, so a change also applies to Pending bookings that are paid later.
What automatic confirmation does
With Automatic for online payments, a Pending booking is confirmed as soon as a verified online payment is recorded through Stripe, PayPal, MoMo or a supported WooCommerce online gateway. If the booking was made with a deposit, paying the deposit is enough; otherwise the full booking total must be paid. The guest receives the usual “Booking updated” email.
These bookings still wait for staff, even in automatic mode:
- pay at hotel, and payments that staff add with Record Payment;
- WooCommerce bank transfer, cheque and cash on delivery orders;
- payments from third-party gateways;
- payments smaller than the deposit or total required;
- bookings with a zero total or with a refund already recorded;
- bookings whose room is no longer available when the payment arrives.
When a paid booking is not confirmed automatically, its Activity Timeline shows a note starting with “Automatic confirmation skipped” that explains why. The payment itself is always kept.
Review paid bookings waiting for staff
- In the Bookings list, filter by Booking status Pending and Payment status Paid or Partially paid.
- To accept a booking, confirm it as usual.
- To decline a paid booking, use Cancel Booking and enter a reason. A cancellation by the hotel refunds 100% of the amount paid through Gateway refunds.
Release rooms from unpaid online checkouts
- Go to Hotel Booking → Settings → Payments and find Unpaid online checkout hold.
- Tick Release rooms when an online payment is not completed. It is ticked by default after upgrading to 1.39.0.
- Enter the Hold time (minutes): a whole number from 15 to 1440. The default is 60.
- Click Save checkout hold.
How the checkout hold works
- Every five minutes, a scheduled task looks for bookings that chose an online payment and still have no recorded payment after the hold time.
- Only bookings created after the hold was turned on are checked. Bookings made before you upgraded, or before you last turned the option on, are never released.
- Pay at hotel bookings and payments that are still being processed, such as a WooCommerce bank transfer on hold or a Stripe payment in progress, are never released.
- Before releasing a booking, the task asks Stripe, PayPal and WooCommerce for the latest payment status. A payment whose notification arrived late is recorded instead.
- A released booking is cancelled by the hotel. Its rooms become available again, the Activity Timeline shows “Online payment was not completed within N minutes.”, and the guest and the hotel receive the usual cancellation emails.
- The related Stripe payment and pending WooCommerce order are cancelled, and a PayPal approval for a cancelled booking is never captured. MoMo payments cannot be stopped: if one arrives after the booking was released, it is recorded, the Activity Timeline notes that a refund is required, and the booking stays cancelled.
- Payment links no longer work for cancelled and no-show bookings.
- Under the setting, Last run shows when the task last ran, how many bookings it released and the last error, if any. Each run handles up to 20 bookings, oldest first.
Cash on delivery orders in WooCommerce
If your Payment policy is Keep the current payment methods and guests pay with WooCommerce cash on delivery, the booking is no longer marked as paid when WooCommerce moves the order to Processing. Collect the money at the hotel and add it with Record Payment. If you took cash on delivery orders before 1.39.0, review Pending bookings that are marked as paid. Bank transfer and cheque work as before.
Turn the settings off
- Choose Manual — staff confirm every booking. and click Save booking confirmation.
- Untick Release rooms when an online payment is not completed. and click Save checkout hold. Bookings that were already released stay cancelled. If you turn the hold on again later, it only applies to bookings created from that moment.
Troubleshooting
- The two sections do not appear: update KimoraPro Hotel Booking to 3.28.1 or later.
- The sections show only a notice: check that your license is active and includes online payments, and cancellations and refunds for the checkout hold.
- Last run says “Not run yet” or shows an old time: WordPress cron is not running. Set up a real server cron job.
- A paid booking stays Pending in automatic mode: open the booking and read the “Automatic confirmation skipped” note in its Activity Timeline.
