The STAY part of the journey starts when Caroline has the first physical experience inside the hotel, and at that point, a couple of things have to happen:

  • Caroline needs to know which room to go to
  • She needs keys to the room
  • You need her data for registration forms and similar

To get the reservations of the guests who have checked-in, use webhooks to receive a notification when a reservation changes to checked-in.

Now, that doesn’t need to be done in the exact moment of checking in. That’s way too stressful. They can happen shortly after, or even before.

During the stay, when hanging out in the room, Caroline wants to check the total current price of her stay. Including all those rollercoaster rides and cotton candy, she booked as extras.

Check the current price - as a guest; I would love this one, someone build it, please! See the current price of your reservation. Or do it like banking apps do, and send a notification when the balance changes.

GET /booking/v1/reservations/{id}

Look for the balance field. You can also use webhooks to be informed about changes.

Add credit card payments - when the guest entered their credit card info when making a booking, you can charge it using the API. Complicated things happen in the background, but for you, it is a plain call to:

POST /finance/v1/payment-tasks

When it’s time to check out, Caroline updates the invoice address, because that’s just nicer to do in bed, and not at the check-out counter. She also directly pays it, with the credit card she entered when making the booking.

Update the invoice address. The guest’s address is not necessarily the same as the billing address, and it is stored separately in apaleo. Change it with

PATCH /finance/v1/folios/{id}

Generate an invoice. Once the address is updated and everything is paid, you can generate the invoice. This call needs the folioId as input, for more information on that check the Point of Sale Integration Guide.

POST /finance/v1/invoices


PUT /booking/v1/reservation-actions/checkout

Now that all is taken care of, Caroline just leaves the hotel.