Kross Booking
This page covers Kross-specific setup: API credentials on Connection, and Checkout & fallback settings that control where guests land after clicking Continue / Book.
API credentials (Connection)
Open Booking Engine → Connection, choose Kross Booking, and complete:
| Field | Plain-language meaning |
|---|---|
| Hotel ID | Which hotel/property in Kross this WordPress site represents. |
| API key | Secret issued by Kross for API access. |
| API username | Identity used together with the password to obtain a Bearer token. |
| API user password | Password for that API user. |
Use Verify connection after saving (or even before saving, depending on form behaviour) to confirm WordPress can exchange a token—your quickest sanity check.
Booking engine URL (Checkout & fallback)
Separate from API credentials: guests never paste API keys. They need the public booking website URL where reservations are completed.
Open Booking Engine → Checkout & fallback.
Booking engine base URL
Paste the full URL Kross gave you for the guest-facing booking engine (often looks like your branded booking subdomain).
- If this field is empty, checkout buttons may stay hidden until you configure it.
How to open the booking engine
| Mode | Visitor experience |
|---|---|
| GET | The browser navigates to a long URL that includes stay parameters as query arguments. |
| POST | The plugin outputs a form that submits hidden fields to the booking engine when the guest clicks the button—some middleware requires POST. |
Note for POST: Kross checkout may require a rate ID in the outgoing data. If no rate is selected in the URL/context, POST checkout might not be available until a rate can be resolved (e.g. from the quote).
Support and API details
Technical HTTP path and endpoint table for developers: Kross API reference.