Operator guide
Managing operator settings
Use this page to update operator contact details, ABN, bank payout information, Xero integration, password settings, and support information.
Profile
ABN lookup
Bank details
Xero sync
Settings page · /operator/settings
Settings title — shows the operator settings page heading.
Main column — contains editable forms: profile, bank details, Xero integration, and password component.
Side column — shows fee and help information cards with the BookMyWave support email.
Save buttons — Profile and Bank sections both save to the same operator settings endpoint.
Success and error banners — show save confirmation or global save errors at the top.
Best use: Keep contact, ABN, bank, and Xero details current so bookings, payouts, invoices, and operator communication stay accurate.
What you see
Settings
✓ Settings saved successfully.
Bank Details
Used for operator payout records.
Fees
Information about operator fees and payout support.
Help
Need help? Email hello@bookmywave.com.
Settings page · Profile section
Contact name * — required. Used in operator navigation and operator account contact details.
Email — shown as a disabled input. Operators cannot edit the email from this page.
Email hint — explains why the email field is locked or how it is used.
Phone — optional contact number for the operator account.
ABN — optional business ABN field with lookup validation when the input loses focus.
Save profile — saves contact name, phone, ABN, and bank fields to operator settings.
Settings page · ABN lookup
When it runs — ABN lookup runs when the ABN input loses focus and the cleaned ABN has 11 digits.
Spaces ignored — spaces are removed before checking the ABN.
Checking state — shows “Checking ABN…” while the lookup request is running.
Valid state — shows the business/entity name, ABN status, and GST registered label if applicable.
Invalid state — shows the API message or “ABN not found”.
Error state — shows lookup failure if the API call fails.
Important: ABN lookup confirms registration details, but an operator may still use a trading name different from the legal entity name.
Settings page · Save and validation
Required contact name — Contact name must not be blank.
Email validation — email must exist and match email format, although the input is disabled on this page.
Field errors — shown under individual fields and red input border can appear for invalid fields.
Global error — shown above the layout when the server returns a save error.
Success state — shows a green success message and browser alert after save.
Saving state — save buttons show “Saving…” and become disabled while the request is running.
Validation and feedback
Failed to save settings.
✓ Settings saved successfully.
Settings page · Bank details
Account name — name on the operator bank account.
BSB — Australian bank branch identifier.
Account number — operator payout account number.
Update bank — saves the bank details through the same settings save handler.
Accuracy warning: Operators should double-check BSB and account number before saving to avoid payout issues.
Bank details section
Bank Details
Used for payout records and operator payment administration.
Update bank
Settings page · Xero Integration
Purpose — connect Xero so confirmed booking income can be synced into Xero automatically.
Disconnected state — shows a warning and Connect Xero button.
Connect Xero — link opens the Xero OAuth connection route.
Connected state — green panel confirms Xero is connected and invoices will be created automatically.
Disconnect — prompts confirmation, then disconnects Xero. Existing Xero invoices are not affected.
Accounting tip: Connect Xero only to the correct Xero organisation for the operator business.
Disconnected state
Xero Integration
Connect your Xero account to automatically create invoices for confirmed bookings.
Not connected. Connect Xero to sync booking income automatically.
Connect Xero
Connected state
✓
Xero Connected
Invoices will be created automatically
Settings page · Xero redirect and disconnect states
Connected query — if the URL has xero=connected, the browser shows “Xero connected successfully!”.
Error query — if the URL has xero=error, the browser shows “Xero connection failed. Please try again.”
Disconnect confirmation — clicking Disconnect asks for confirmation before disconnecting.
Disconnecting state — button changes to “Disconnecting…” while the request is processing.
Last error fields — the page loads last Xero error and reference from settings, ready for display or diagnostics.
Note: Disconnecting Xero does not remove invoices that already exist inside Xero.
Xero alert and disconnect states
✓ Xero connected successfully!
Xero connection failed. Please try again.
✓
Xero Connected
Invoices will be created automatically
Settings page · Side information cards
Fees card — explains platform fee or payout support information.
Help card — directs the operator to contact BookMyWave support.
Email link — support email is shown as hello@bookmywave.com.
Sticky desktop — on wide screens, the side column stays visible while scrolling.
Mobile — side cards stack below the main settings forms.
Side cards
Fees
Information about BookMyWave fees and how payout settings are used. Contact hello@bookmywave.com for support.
Help
Need help with settings, bank details or integrations? Email hello@bookmywave.com.
Settings page · SetPassword component
SetPassword component — rendered after the main layout.
Use case — allows operators to set or update their login password, depending on component behaviour.
Separate save flow — password update is handled by the password component, not by the profile/bank save button.
Tip: Operators should use a secure password and avoid sharing operator login credentials with crew.
Password component preview
Settings page · Loading and error states
Loading screen — spinner and translated loading text appear while settings are fetched.
Unauthorised — if the API returns 401, the user is redirected to operator login.
Load failure — if settings cannot load, the error is shown in red centred loading layout.
Network save error — save failure displays a global error at the top of the settings page.
Loading and error UI
Loading…
Failed to load settings.
Settings page · Responsive layout
Desktop — two-column layout: settings forms on the left, help cards on the right.
Mobile — layout becomes one column.
Input rows — two-column rows become single-column rows.
Side cards — no longer sticky; they appear below the form sections.
Xero connected box — wraps so the Disconnect button does not overflow.
Mobile stacked settings
Settings
✓
Xero Connected
Invoices will be created automatically
Help
Email hello@bookmywave.com.