Authorizations overview

Purpose Explains how card authorizations work in Cloudbeds PMS: how to hold funds on a card, capture or void the hold, and how long a hold lasts.
Best for Users who secure guest payments, security deposits or incidental holds.
Use this when You want to hold funds on a guest's card before charging it, or you need to know when a hold expires.
Requirements Payment Processing must be enabled and correctly connected.
Expected result You can hold, capture and void authorizations, and plan around the expiration window for your region.
Limitations Incremental authorizations are not supported. An authorization cannot be captured after it expires.

Introduction

Use card authorizations to secure guest payments. This article gives an overview of how authorizations work in Cloudbeds PMS. By understanding the process, you can manage guest payments effectively and reduce the risk of failed transactions.

Wording update: We are renaming some labels in the folio and payments portal. Credit card is now Card, processing a payment is now Online, and recording a payment is now Offline. While this update rolls out, you may still see the previous labels in your account. The steps are the same.

How authorizations work

Where to find the authorization option

You can authorize a card in two places:

An authorization is an online action: it goes through the payment gateway to hold funds on the guest's card.

Authorize a card

  • When a new card is added to a reservation, you can authorize it to hold funds for the reservation amount.
  • The authorization verifies that the card is valid and reserves the funds, so the payment can be captured later.

Capture an authorization

  • Once the guest's stay is complete, or you are ready to collect payment, you can capture the authorized amount.
  • This transfers the held funds from the guest's card to your account.

Void an authorization

  • You can void the authorization if a reservation is canceled or you need to release the funds you have held.
  • This returns the reserved amount to the guest's card.

Authorization expiration periods

When you authorize a card to hold funds (for example, for a security deposit or an incidental hold), how long the hold stays active depends on your region and the payment method used. Once an authorization expires, you can no longer capture those funds, and the hold is released back to the guest.

The table below shows the expiration windows for Cloudbeds Payments:

Region / Method Authorization Hold Duration
Cloudbeds Payments - Thailand 5 days
Cloudbeds Payments - Stripe Mexico 7 days
Cloudbeds Payments - Stripe (all other countries) 30 days

Best practice: If your guest is staying longer than the expiration period for your region, re-authorize the card before the current hold expires. This keeps the funds secured for the whole stay.

Important considerations

  • Incremental authorizations: Cloudbeds PMS does not currently support incremental authorizations, so you cannot add an amount to an existing authorization.
  • Void and reauthorize: If you need to change the authorized amount, void the existing authorization and create a new one for the updated total.
  • Risk management: When you void and reauthorize, the card may no longer have enough funds to cover the new amount. This could result in a failed authorization and the loss of the funds you previously held.

Next Operational Step

To place a hold on a guest's card, follow How to authorize a card with the payment gateway feature. When you are ready to collect the payment, capture the authorized amount, or void the authorization to release the funds.

Was this article helpful?
0 out of 2 found this helpful

Comments

2 comments
  • Add the ability to authorize cards for a set amount for incidentals at check in for every guest depending on policy. Auto release the deposit after 24 hours.

    2
  • Hello, Bhavik Patel, 

    Thank you for your feedback. Based on your comments, we have created a new idea on your behalf in the Cloudbeds Community. It is already open for other users to vote for and add comments.

    Regards,

    0

Please sign in to leave a comment.