Lightspeed: Installation & settings
Lightspeed is a cloud-based POS system that integrates with BEX PMS to process payments and manage guest transactions seamlessly, and allows for purchases to be charged to the reservation/room.
In our App Store you can read more about what Lightspeed can offer you.
How to install the app?
Go to the 'Available apps' index, and use the search bar to find the Lightspeed app. Click the 'Install app' button.
Read more: Getting started with BEX App integrations
Complete the settings
1. Authorize Lightspeed
What you'll do:
Navigate to the Lightspeed app in your organization's App Store, among the 'installations'.
Click the Commands dropdown menu and select "Authorize Lightspeed"
You will be redirected to the Lightspeed login page
Enter your Lightspeed credentials to authorize the connection
Grant permission for the app to access your Lightspeed account
Complete the OAuth authorization flow
Upon successful authorization, you will see a confirmation message
Important Information:
You must have an active Lightspeed account to authorize
Authorization must be completed before you can configure business locations
If authorization fails, verify your Lightspeed credentials and try again
You can reauthorize at any time if your credentials change
What happens after: Your Lightspeed account is now connected and authorized. You can now proceed to configure your business locations.
2. Configure business locations
Click the Commands dropdown menu and select "Business locations"
To add a new location, click "+ Business location":
Administration: Select which BEX administration this POS location belongs to
Lightspeed Business Location: Choose the specific Lightspeed register/location to connect
Basic expense: Select the cost item (specifically set up for this purpose) to use for processing payments through Lightspeed
To edit an existing location, click the edit button and update its settings
To remove a location, click the delete button (this will deactivate the POS integration for this location)
Click "Save" to confirm changes
Important Information:
Each Lightspeed POS terminal must be connected to a BEX administration
The "Basic expense" cost item determines how purchases show up on guest invoices
You can configure multiple Lightspeed terminals across different administrations
Changes to business location settings take effect immediately
All POS charges are logged and tracked
When deleting a business location, the Lightspeed integration is disabled but historical data is preserved
Payment method codes must be configured in Lightspeed console (see instructions in the business location)
What happens after:
The business location is now active and ready to process payments
Each purchase by a guest that is charged to their reservation, creates an additional item on their reservation order. It has details including the business location name, receipt ID, and payment timestamp
Payment information is synchronized between Lightspeed and your PMS in real-time
Search for reservations by booking number, guest name, or room name at the POS
Detailed logs track all payment processing activities for reconciliation and auditing
If errors occur during payment processing, internal messages are automatically generated with error details
3. Setting up payment method
What you'll do:
Click the Commands dropdown menu and select "Business locations"
Click a specific business location to view its details:
Business location name
External Lightspeed identifier
Creation and last update timestamps
Payment method setup instructions
The step-by-step instructions need to be performed in Lightspeed console
Contact Lightspeed support if you need help with payment method setup
Important Information:
Each business location has a unique API key used for secure payment processing
Payment methods must be created in the Lightspeed console (not in your PMS)
The method code "IKPMS" is required for proper payment routing to reservations
What happens after:
Guest charges from Lightspeed are now properly routed to the correct reservations
Payment data flows seamlessly from the POS to BEX PMS
All charge details including amounts, timestamps, and receipt information are captured
Cost item settings for Basic expense
This specific add-on will act as the basis for the invoice line added to the reservation, and should have the following settings:
Name: Receipt payment
Global cost type: Other
Booking settings: Back office only
Applicability: All types and channels, always
Price calculation: Per stay
Default price: β¬0.00
Ledger account: an account with 0% VAT