Collect Payments with Apaleo Pay

If your hotel uses Apaleo Pay, you can connect it to Brixa so guests pay or leave a card on a Brixa payment page. The money goes to your property's own Apaleo Pay account.

Stripe, Apaleo Pay or both

You can connect Stripe, Apaleo Pay, or both, but only one is selected at a time. Use the Payment gateway selector at the top of Payments to choose which one guests use. Payment links already sent keep the option they were created with.

What you need

Your Apaleo Pay setup details, which you enter in Brixa:

• Merchant account
• Sub-merchant ID
• API key
• Client key
• Environment: test or live
• Live URL prefix (live environment only)
• Apaleo account code
• Property ID

Where to find them

• Merchant account, Sub-merchant ID, API key, Client key and Live URL prefix come from Apaleo. Write to support@apaleo.com and ask for your property's Apaleo Pay credentials for Brixa. Apaleo issues them per property.
• Apaleo account code is the short code of your Apaleo account. It is not the property code.
• Property ID is your property's code in Apaleo. Brixa fills it in for you once the hotel is connected to Apaleo.

In Brixa, choose the Environment first: the card then tells you where the credentials for that environment come from. The API key is secret: once you connect, Brixa does not show it again.

Apaleo Pay works together with an Apaleo PMS connection for the same property; see Connect Apaleo.

Connect Apaleo Pay

1. In Brixa, open Hotel Settings in the menu and select Payments. The page is headed Payments Settings.
2. On the Apaleo Pay card, enter the details listed above, then select Connect Apaleo Pay.
3. The card then shows the connection with your merchant account name. A Test mode badge appears when you connected the test environment.
4. Make sure Apaleo Pay is the selected option under Payment gateway.

Setup needs attention

Apaleo Pay collects through the booking Brixa creates in Apaleo, so the hotel must be connected to Apaleo with Manage reservations switched on in its PMS Integration section. If Apaleo Pay is selected while either is missing, Brixa shows a Setup needs attention banner at the top of every page, with a link to the section to fix. Once fixed, select Report fixed and the banner goes away.

What guests see

With Apaleo Pay selected, the guest's payment link opens a Brixa card page, not Stripe. There the guest pays or leaves their card. The booking Brixa creates in Apaleo carries the payment or the card, so Apaleo can charge cancellation or no-show fees according to the rate plan's terms.

When a payment link is sent depends on the cancellation policy; see Ask Guests to Pay or Leave a Card at Booking.

If the amounts differ

If the booked total ever differs from what the guest paid, you see a review item on the conversation, and the confirmation message to the guest is left as a draft for you to send. Review the booking and the payment, then send the message yourself when it is right.

Replace credentials or disconnect

On the Apaleo Pay card, select Replace credentials to enter new details, or Disconnect to remove the connection.