Connect your provider
Open Booking Engine → Connection.
Provider
Use the Provider dropdown to choose which booking integration is active.
Out of the box you will normally see Kross Booking. Additional providers can be added by developers via WordPress filters (see Adding a provider).
Credentials (Kross)
Fill in the fields from your Kross account (names may vary in their dashboard):
| Field | Purpose |
|---|---|
| Hotel ID | Identifies your property to the API. |
| API key | Secret key used together with your API user to obtain an access token. |
| API username | Username for API authentication (documentation often mentions examples such as apiv5). |
| API user password | Password for that API user. |
Tip: Password-type fields usually keep the saved value if you leave them blank when saving—only type a new secret when you intend to replace it.
Click Save connection settings when you are done.
Verify connection
Click Verify connection to run a real token exchange with the provider (without exposing your secrets on screen).
- Success — You will see an admin notice confirming the API answered.
- Failure — Check typos, IP allowlists, and that your server can reach the API over HTTPS.
Search form (front)
On the same Connection page, the plugin lets you control how guests are counted on the front-end search bar (used by [bec_search] and inside the booking summary).
How guests are collected
| Option | When to use it |
|---|---|
| Follow the active provider | Default. Matches what your provider expects (e.g. one total guest count vs adults + children). |
| Single “Guests” count only | One number for all people—simplest for small properties. |
| Adults and children (separate fields) | When you need a split headcount for pricing or policies. |
Child ages in search
| Option | Meaning |
|---|---|
| Follow the active provider | Uses the engine’s rules. |
| Ask for each child’s age | Shows one age field per child when the form is in adults + children mode. |
| Do not ask for child ages | Omits age fields (not used when you only collect a single guest total). |