Blog Detail Title

Short Content Here

by Author Name

Date Published


New payment and refund options

Andrea Stubbe January 20, 2018

With this release we extend our existing payment APIs, and also add a brand new one: now you can also refund money, in case someone paid too much.

Pay by invoice

...or "Check out on AR (Accounts Receivables)", how the pros call it. We added a new endpoint on the FolioActions API, 'checkout-on-AR', and secured it with its very own scope, 'folio.checkout-ar', as allowing customers to leave the hotel without paying needs extra protection. The function is only available when it's clear that no additional charges or payments will occur, for example after a checkout or cancellation.

Calling this endpoint will post the payment as "invoice", close the folio, and do all the required accounting transactions. When you generate an invoice that has an invoice-payment, the payment terms you specified when creating or updating the property (in the inventory API) will be added to it.


Even though the apaeo APIs prevent overpaying a reservation, it can still happen that a guest ended up paying too much: the cancellation fee is lower than the total prepaid amount, the guest gets a discount on a room that wasn't as quiet as advertised, the no-show fee is waived, etc.

Now you can fix this by calling 'refund' on the FolioActions. Like checking out on AR, this has its own scope ('refunds.create'), as not everyone is allowed to give away money.
Note that posting a refund on apaleo does not (yet) automatically trigger a refund with the integrated payment provider.

More fine-grained payment types

We thought our accounting module is small, but great! That thought didn't survive for 5 seconds after we showed it to customers. "What kind of payment is 'CreditCard'? How should I be able to follow up with the credit card companies, and check that what they paid me is what I have in my books?" Valid point. We quick-fixed that, and when creating payments, customers can now select from the world's most common credit and debit cards. If you don't care about those details (and for backwards compatibility) we left the 'CreditCard' payment type.

Andrea Stubbe

Posted by

Andrea Stubbe
Andrea started coding as a kid, paused that for some years trying to find more interesting things, but then ended up doing that for a living. After working as a freelancer, researcher, teacher, and a normal employee in small and giant corporations, she fulfilled her childhood dream and co-founded a company a year ago. Being a fan of microservices since before she knew that term, she’s still contemplating how and if to use them in micro-sized companies.


by Benjamin Schmid


IBE Integration Guide

Let's talk Internet Booking Engines (IBEs). They work best when directly connected to the PMS, without any intermediaries that might get in the way with delays ...

by Andrea Stubbe


Digital guest journey with apaleo

apaleo is building software for hotels, and our users are people that work at hotels. To create amazing guest experiences we need you, creators of guest facing ...

by Andrea Stubbe


Push it! Webhooks in apaleo

The notification service allows you to build or set up apps which subscribe to certain events on apaleo (webhooks). When an event is triggered, we send an HTTP ...


Subscribe to our a-list for all the fun:

  • Keep up to date with hotel trends
  • Understand what matters most to hotel clients
  • Sweet gifs and special offers

Get it in your inbox every Monday ;)

By entering your email you expressly consent to receive our newsletter every week and other material related to...