Flexatech Stay Suite

Description

Flexatech Stay Suite is a professional room-reservation system for WordPress. It manages hotel rooms, rate plans with date-specific price and availability overrides, realtime availability computed straight from bookings (no stale caches), time-limited holds that prevent overbooking, coupons, and modern payment gateways with signature-verified, idempotent webhooks.

Every amount is stored and computed as integer cents, and the total charged is always re-computed on the server at checkout, so a tampered client payload can never lower the price.

📚 Documentation and live demo: read the setup guide, then book a room on the demo site before you install anything.

Highlights

  • Rooms as a custom post type with per-room inventory, capacity, deposit, and extras.
  • Rate plans with priority, min/max stay, and per-date-range / day-of-week price rules.
  • Realtime availability using half-open night semantics [check_in, check_out), so same-day turnover (a guest checks out and another checks in the same day) works correctly.
  • Overbooking-safe holds: a time-limited hold reserves inventory during checkout and is swept automatically when it expires (WP-Cron).
  • Coupons (percentage or fixed amount) with usage limits and expiry.
  • Payment gateways: Offline / bank transfer (built in), plus Stripe and PayPal with sandbox/live modes and webhook verification. The charged amount always equals the server-computed total.
  • Transactional emails for booking received (customer + admin), processing, completed, cancelled, and payment receipts, each toggleable with a custom subject.
  • A modern React admin app for the dashboard, calendar, bookings, rate plans, coupons, and settings, backed by a versioned REST API (flexatech-stay-suite/v1).
  • WP-CLI commands and full privacy exporter/eraser integration.

Ready for more? Two add-ons pick up where the free plugin stops

The free plugin is enough to run a real property. The add-ons are for the money you are currently leaving on the table: the fifth guest who pays the same as the second, the Friday night that costs the same as a Tuesday, the double booking that came in from Airbnb while you were asleep.

Both are separate plugins that extend Stay Suite through its documented hooks. They never patch its code, never touch its tables, and every figure they add is computed on the server, so a guest cannot edit a fee out of the request. Install one the day you need it; nothing in your existing setup has to be redone.

Stay Suite Occupancy: charge for who stays, not just which room

👉 Get Stay Suite Occupancy

A family of five in a room priced for two is a discount you never agreed to give. Occupancy puts the guest count back into the price:

  • Extra-guest fee beyond a base occupancy you set per room, charged per guest, per night, exactly how Airbnb does it.
  • Pet fee, either once per stay or per night, your choice per room.
  • Per-type guest caps for adults, children, infants and pets, enforced both when the price is quoted and again at checkout, so an over-capacity stay can never slip through.
  • Infants never count toward the paid headcount, and a room you have not configured keeps behaving exactly as it does on the free plugin.

Requires Flexatech Stay Suite 1.6.0 or newer.

Stay Suite Pro: the revenue, policy and channel layer

👉 Get Stay Suite Pro

Everything a property needs once bookings stop being occasional:

  • Dynamic pricing. Weekend uplift on the weekdays you pick, seasonal percentage ranges, and an optional nightly floor and ceiling so a stacked rule can never price a room absurdly.
  • Booking rules. Minimum and maximum nights, closed-to-arrival and closed-to-departure weekdays, and a booking window, set globally and overridable per room. Rejected stays are refused at quote time with a clear message, not after the guest has paid.
  • Cancellation policies. Tiered “within N days of check-in, retain X” rules per room; the tightest matching tier wins and the free plugin issues the matching refund.
  • Deposits and payment schedules. Take a deposit now and split the balance across dated instalments. The schedule always sums back to the exact order total, and [flssp_payment_schedule order="CODE"] shows it to the guest.
  • Calendar sync, both directions. Every room gets a tokenised, revocable iCal export URL, and external feeds (Airbnb, Booking.com, Google Calendar, anything that speaks iCal) are polled hourly, with imported busy dates blocked from being booked again.
  • Integration API and webhooks. An API-key-authenticated REST namespace to list availability, quote, create, read and cancel bookings, plus signed booking.created / booking.confirmed / booking.cancelled webhooks with a delivery log and exponential-backoff retries. Booking creation runs the free plugin’s own checkout service, so pricing is reused rather than reimplemented.

Requires Flexatech Stay Suite 1.5.0 or newer.

📚 Documentation for both add-ons, plus the live demo, is at https://hotel.flexacommerce.com/

Storefront pages

Room browsing works with no setup: single room pages at /rooms/{slug}/, the room archive at /rooms/, and room-type and amenity archives all render inside your active theme automatically. Your theme’s own room templates take priority, and every plugin template can be overridden from a flexatech-stay-suite/ folder in your theme. Return false from the flexatech_stay_suite/frontend/use_default_templates filter to turn the automatic routing off.

For the cart and checkout steps, create a few pages under Pages Add New and paste one shortcode into each, then Publish:

  • Cart (required): [flexatech_hotel_cart]
  • Checkout (required): [flexatech_hotel_checkout]
  • Booking Confirmation (required): [flexatech_hotel_thankyou]
  • My Bookings (recommended): [flexatech_hotel_account]
  • Book a Room (optional landing page): [flexatech_hotel_search] and [flexatech_hotel_rooms]

The plugin finds these pages by scanning your published pages for each shortcode, so the titles and slugs are up to you. Put each flow shortcode on its own published page; if the same shortcode appears on more than one page, the first match is used. The Cart, Checkout, and Booking Confirmation pages are required because the flow redirects between them.

The three browsing shortcodes are also available as editor blocks: Room Search, Room List, and Single Room Booking.

Shortcode reference:

  • [flexatech_hotel_search]: date and guests search form. Optional redirect="URL" sends results to another page.
  • [flexatech_hotel_rooms]: grid of bookable rooms. Optional per_page, columns, and room_type.
  • [flexatech_hotel_room id="123"]: one room’s booking widget; id defaults to the current room on a room page.
  • [flexatech_hotel_cart], [flexatech_hotel_checkout], [flexatech_hotel_thankyou], [flexatech_hotel_account]: the cart, checkout, confirmation, and account screens.

The “Storefront pages” steps above are the full setup walkthrough; the FAQ below covers the common questions.

External services

This plugin can connect to Stripe and PayPal to take online payments for bookings. Both integrations are optional: the plugin only contacts them if the site owner enables that gateway in Settings Payments with their own API keys and a guest actually selects it at checkout. The built-in Offline / bank-transfer gateway makes no external calls.

Card numbers are never sent to or stored on your server. Stripe collects card details in the browser (via Stripe.js) and your site only handles the resulting PaymentIntent id and client secret.

Stripe

Stripe processes credit-card payments when the Stripe gateway is enabled and a guest chooses to pay by card. Your site sends requests to the Stripe API (https://api.stripe.com) in these cases:

  • When a guest starts a card payment at checkout, the plugin creates a PaymentIntent. It sends the charge amount (in the smallest currency unit), the currency, and the booking order id and order code as metadata.
  • When you issue a refund, the plugin sends the PaymentIntent reference and the refund amount.
  • Stripe also sends webhook notifications back to your site to confirm payment; the plugin only verifies the request signature against your webhook secret and does not send data to Stripe in response.

Your Stripe secret key is sent in the request authorization header so Stripe can authenticate the call.

Stripe’s terms and privacy policy: https://stripe.com/legal/ssa and https://stripe.com/privacy

PayPal

PayPal processes payments when the PayPal gateway is enabled and a guest chooses to pay with PayPal. Depending on sandbox or live mode, your site sends requests to https://api-m.sandbox.paypal.com or https://api-m.paypal.com in these cases:

  • To authenticate, the plugin exchanges your PayPal client id and client secret for an OAuth access token.
  • When a guest starts a PayPal payment at checkout, the plugin creates a PayPal order, sending the amount, currency, and the booking order id and order code as the order reference.
  • When you issue a refund, the plugin sends the capture reference and the refund amount and currency.
  • PayPal also sends webhook notifications back to your site to confirm payment; the plugin verifies each notification by calling PayPal’s verify-webhook-signature endpoint with your webhook id before acting on it.

PayPal’s user agreement and privacy policy: https://www.paypal.com/us/legalhub/useragreement-full and https://www.paypal.com/us/legalhub/privacy-full

Deactivation feedback

When you deactivate the plugin from the Plugins screen, a short optional feedback form asks why you are leaving. Whether you submit a reason or skip it, the plugin sends the result to the FlexaTech product-intelligence service at https://product-intelligence.flexacommerce.com so we can improve the plugin. This runs only in wp-admin, only around deactivation (and the following reactivation), and never blocks deactivation: if the service is unreachable, the plugin still deactivates normally.

What is sent: an anonymous per-site identifier (a random UUID generated on your site), the plugin slug, tier and version, the deactivation reason and any comment you choose to provide, and basic environment information (WordPress version, PHP version, and site locale). No email address, domain name, or raw IP address is sent.

FlexaTech service and privacy information: https://flexacommerce.com

Blocks

This plugin provides 3 blocks.

  • Room Search
  • Room List
  • Single Room Booking

Installation

  1. Upload the flexatech-stay-suite folder to /wp-content/plugins/, or install the zip via Plugins Add New Upload Plugin.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. On first activation you land on the Setup screen. It shows a live completion checklist, guides you through each step, and creates the cart, checkout, and confirmation pages in one click.
  4. Open the “Flexatech Stay Suite” admin menu to configure currency, booking rules, taxes, payment gateways, and emails.
  5. Create a property, add rooms with inventory and capacity, and add rate plans with pricing rules. The Setup screen tracks each of these until you are ready to accept bookings.

Full documentation and a step-by-step user guide are online at https://hotel.flexacommerce.com/

The full source code, including the admin app and its build tooling, is public on GitHub: https://github.com/flexatech/flexatech-stay-suite

To build from source:

  1. Clone the repository: git clone https://github.com/flexatech/flexatech-stay-suite.git
  2. Build the admin dashboard bundle: cd apps/admin && pnpm install && pnpm build (writes the compiled assets to assets/dist).
  3. Copy the plugin folder into /wp-content/plugins/, or run ./release.sh to produce a distributable zip in build/.

FAQ

How do I set up the booking pages on the front end?

Room browsing (single rooms and archives) is generated automatically inside your theme, so those need no setup. For the cart and checkout steps, create a Cart, Checkout, and Booking Confirmation page and paste [flexatech_hotel_cart], [flexatech_hotel_checkout], and [flexatech_hotel_thankyou] into them respectively, then publish. A “My Bookings” page with [flexatech_hotel_account] is recommended. The plugin discovers these pages by their shortcode, so you can name them anything. See the “Storefront pages” section above for the full walkthrough.

Can a customer manipulate the price at checkout?

No. The client never sends amounts. The server re-quotes the entire cart from the room’s rate plans and inventory at checkout, so the charged total is always the authoritative server figure.

Does it prevent overbooking?

Yes. Availability is computed directly from bookings and time-limited holds, with commit-time re-checks, so two guests cannot book the last room at the same time.

Which payment gateways are supported?

Offline / bank transfer is built in and enabled by default. Stripe and PayPal are included with sandbox and live modes; enter your keys in Settings Payments to enable them.

Is there a demo I can try before installing?

Yes. You can search dates, hold a room and walk through checkout on the live demo, which sits alongside the full user guide and developer reference at https://hotel.flexacommerce.com/

What do the paid add-ons add, and do I need them?

You do not need them to take bookings; the free plugin is complete on its own. Stay Suite Occupancy adds per-guest and pet pricing with per-type occupancy caps. Stay Suite Pro adds dynamic and seasonal pricing, length-of-stay and arrival rules, cancellation policies, deposits with instalments, two-way iCal calendar sync, and an API-key REST API with signed webhooks. Both install as separate plugins alongside the free one and hook into it rather than replacing anything, so you can add either later without touching your rooms, rates or past bookings. See the “Ready for more?” section above for the detail.

Where is the source for the admin app?

The admin dashboard is a React and TypeScript app. Its readable source ships in apps/admin/src, along with its build manifest (apps/admin/package.json, apps/admin/vite.config.ts, apps/admin/tsconfig.json). To rebuild the compiled bundle in assets/dist, run pnpm install then pnpm build inside apps/admin. The complete source and build tooling is public on GitHub: https://github.com/flexatech/flexatech-stay-suite

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Flexatech Stay Suite” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Flexatech Stay Suite” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.6.0

  • New: Airbnb-style guest picker on the room booking form. Adults, children, infants, and pets each get their own stepper inside a dropdown, and the widget shows “Add dates for prices” until you pick a stay. Infants and pets are sent with the booking and stored on the order.
  • Improvement: The room editor’s Rooms & Pricing box now explains that nightly prices live on the Rates page and links straight there; the Rates & Inventory screen shows the selected room’s property, capacity, and a shortcut to edit the room. Easier to find where each setting belongs.
  • Developer: New extension points for add-ons. flexatech_stay_suite/checkout/line lets an add-on add fees to a priced line, and flexatech_stay_suite/booking/guest_caps supplies per-room guest limits to the storefront. Used by the separate Occupancy add-on for per-guest pricing and caps; the free plugin adds no limits or fees on its own.

1.5.0

  • Developer: Added extension points for add-ons. New filters flexatech_stay_suite/booking/balance_due_cents (outstanding balance, for deposit/instalment flows), flexatech_stay_suite/cancellation/fee_cents (fee retained on a self-cancel), and flexatech_stay_suite/booking/validate (return a WP_Error to reject a stay, e.g. minimum-nights or closed-to-arrival rules; enforced at checkout and surfaced during quote). New repository method occupying_in_range() lists booked rooms across a date window for calendar/iCal export. No change to how the plugin behaves on its own.

1.4.1

  • Improvement: On a flexible-dates search, each room card now shows the total price for the matched stay (its dates are fixed) instead of a nightly “from” figure, so the number matches what the search ranked on.

1.4.0

  • New: “My bookings” now links each booking to your account, not just your email address. Bookings you made while logged in stay in your history even if you later change your account email, and a guest booking is attached to your account the next time you log in with the same email. Existing bookings are matched to their owner automatically on update.

1.3.1

  • New: The booking progress timeline now shows a real date and time for each step (placed, confirmed, cancelled, refunded), recorded whenever a booking changes status. Bookings made before this update show no time on a step rather than a made-up one.
  • Performance: “My bookings” now looks up a guest’s bookings through an indexed email column instead of scanning the whole orders table, so the account page stays fast as bookings grow. Existing bookings are backfilled automatically on update.

1.3.0

  • New: Airbnb-style date range picker on the search and booking forms. A two-month calendar with range selection replaces the plain date fields, while the native inputs stay the source of truth so existing behaviour is unchanged.
  • New: Flexible dates on room search. Pick a “± days” range (1, 2, 3, 7, or 14) and the search widens to nearby check-in dates; each room shows the cheapest bookable window and the exact dates it matched. The price is always computed on the server.

1.2.0

  • New: First-run Setup dashboard. A guided screen with a real, weighted completion score computed from your actual data (properties, rooms, pricing, inventory, storefront pages, and payment methods), a “ready to accept bookings” indicator, and one-click creation of the cart, checkout, and confirmation pages.
  • New: The first activation opens the Setup screen once (no redirect loops, admins only, skippable), and an incomplete-setup reminder shows on the Dashboard and Plugins screens until setup is ready or you dismiss it.
  • New: Online documentation with a user guide and developer reference at https://hotel.flexacommerce.com/, plus a hooks reference (docs/HOOKS.md) covering every action and filter.
  • New: Optional deactivation feedback form. When you deactivate the plugin, a short form asks why; the anonymous result helps us improve the plugin. It never blocks deactivation. See “External services” for exactly what is sent.
  • Recommend Flexa MailBridge on the Emails settings screen for reliable SMTP delivery of booking emails.

1.1.1

  • Security: The admin dashboard and its read-only data routes (statistics, coupons, rate plans, and room meta) now require the administrator capability. They were previously reachable by lower roles such as Authors. A filter is provided to re-map the capability.
  • Moved the top-level admin menu below the core WordPress menus so it no longer sits among the built-in items.
  • Passed the WordPress Plugin Check with no errors or warnings: escaped exception messages, hardened the direct database queries, and regenerated the translation template.

1.1.0

  • New: Per-room deposit: set a fixed “amount due now” per room at checkout, with an automatic fallback to the global advance-payment percentage for rooms that have no deposit set.
  • New: Filter rooms by room type and amenity on the room archive and taxonomy pages.
  • New: Zero-config front-end templates: single room, room archive, and room-type/amenity archive pages now render automatically inside your active theme, with full theme-template override support and a filter to turn them off.
  • New: Unpaid online payments left past their hold window are now cancelled automatically, freeing the room, handled separately from offline holds.
  • New: Your configured currency symbol position (before/after the amount, with or without a space) is now applied everywhere on the server, including emails.
  • New: Coupons can be individually enabled or disabled; a disabled coupon is never applied when quoting or at checkout.
  • Security: Editing rate plans and coupons now requires the administrator capability; viewing remains available to lower roles. A filter is provided to re-map the capability.
  • Security: Viewing customer bookings and changing a booking’s status now require the administrator capability to protect guest personal data; refunds remain admin-only. A filter is provided to re-map these for staff roles.
  • Fix: The booking confirmation (“thank you”) page no longer returns a 404 and now shows the correct booking summary.
  • Fix: Booking line items now record the correct per-night price and subtotal, which could previously be zero.
  • Fix: Room permalinks (such as /rooms/) no longer 404 on a fresh install; rewrite rules are flushed on activation.
  • Disclosed Stripe and PayPal as external services in the readme and completed a code-quality (phpcs) pass.

1.0.0

  • Initial release: rooms, rate plans, realtime availability, overbooking-safe holds, coupons, offline/Stripe/PayPal gateways, transactional emails, REST API, React admin app, WP-CLI, and privacy tools.