| 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:
- In a reservation's Cards tab, using the Authorize button.
- In the folio, by clicking +Add, selecting Payment and choosing Online Authorization as the payment type. See How to process payments through payment gateway.
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.
Useful articles:
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.
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.
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,
Please sign in to leave a comment.