Apaleo icon

Apaleo

Interact with Apaleo API

Actions66

Folio Action → POST add no-show fee

AI-generated

Overview

This node interacts with the Apaleo API to add a no-show fee to a guest's folio. It is particularly useful for properties that need to charge guests for missed reservations, ensuring that the fee is applied directly to the guest's billing account.

Use Case Examples

  1. A hotel charges a guest a no-show fee after they fail to arrive for a reservation.
  2. A property management system automatically applies a no-show fee to a guest's folio when a reservation is marked as a no-show.

Properties

Name Meaning
folioId The unique identifier of the folio (billing account) associated with the guest's reservation. This is required to specify which folio the no-show fee should be added to.
amount The amount of the no-show fee to be charged. This is required to define the fee's value.
currency The currency in which the no-show fee is denominated. This is required to specify the currency of the fee.
idempotencyKey A unique key used to safely retry requests without creating duplicate charges. This is optional and can be used to ensure that repeated requests do not result in multiple charges.

Output

JSON

  • status - Indicates the success or failure of the operation. A successful response typically includes a status code indicating the operation was completed successfully.
  • message - Provides additional information about the operation's outcome, such as error messages or confirmation of success.

Dependencies

  • Apaleo API access token

Troubleshooting

  • Ensure that the folioId corresponds to an existing guest folio; if not, create a new folio using the Apaleo API.
  • Verify that the amount and currency are correctly specified and match the expected formats.
  • If the idempotencyKey is used, ensure it is unique for each operation to prevent duplicate charges.

Links

Discussion