Cloudbeds Payments - How to Process a Transaction through the Terminal


Cloudbeds Payments is an add-on that is quickly growing to be one of our leading global services. Please click here to see if it is available in your country.

Processing a transaction through Cloudbeds Payments is a very user friendly and seamless experience. You can process a transaction manually or through the Cloudbeds Payments Terminal (card reader).

If you want to use this feature or order the Cloudbeds Payments card reader, reach out to our support team.


  • You can use the Cloudbeds Payments in different sections of Cloudbeds.
  • At the moment, the system does not allow you to activate your terminal when creating a new reservation, but you can still process transactions in which the card is not present.
  • The terminal only works for charges linked to your Cloudbeds PMS. For any charges outside of Cloudbeds PMS, for example Poster, it's not possible to use the terminal.
  • You would need to confirm the reservation and go back into the Guest Folio to process the transaction using your terminal.
  • All payments will be processed in your property's currency.

Guest Folio - Process a Transaction using the Terminal

Access the desired reservation:

  1. Click Folio.
  2. Click Add/Refund Payment.
  3. Select Add Payment.
[Demo] Tessa Swier Hotel - Reservations - Google Chrome
  1. Assign the guest (if applicable).
  2. Select the folio (if applicable).
  3. Amount: By default, the system will add the balance due, but you can edit the amount if needed.
  4. Choose the desired Payment Type, select Terminal.
    • Stored Credit Carduse previously added credit card details to process the transaction.
    • Terminal — card-present transaction (this option activates your card reader).
    • Add new credit card — add new credit card details to process transactions.
  5. Click to Process the Payment.

Due to security reasons, it's not possible to see the credit card details — check the following article for more information: Cloudbeds Payments - Why can't I view full credit card details?

[Demo] Tessa Swier Hotel - Reservations - Google Chrome

If you chose the option terminal, you will see this prompt on your screen. On this step you can:

  • Use the current terminal connected — the terminal name will be described on the following screen, go ahead and proceed with the next steps below.
  • Choose another terminal — if you have more than one terminal, click Choose Another.
  • Cancel the transaction.
4hOAtUvMhniF8WHy4yIcI9T246XDwprp3yynzSkPiMzFvpLfFBTC35Taq9bqgRoGl-9n6ea_0CBncmH1W5KbTfJ8vuF4QYUq77y6NXqPvR0He-fac2Ei4Xu88_6dzB1Fw2zFdArS (904×706) - Google Chrome

On your terminal you will see a new screen with the amount intended for charge as shown below:

  1. At this time, swipe, insert, or have your guest tap their mobile device on top of the terminal to process the payment.

The system cannot store credit card details if contactless method (Apple Pay, Google Pay, Samsung Pay) was used.

  1. The transaction will complete and Cloudbeds page will refresh.
  • All payments that are processed by the terminal always appear under the Property Owner's username on the Reservation Activity.
  • If the transaction declines, check the following article: Cloudbeds Payments Decline Codes
  • You can also run a transaction through a House Account using Cloudbeds Payments with the same steps detailed above. For more information, check: Adding Payment/Refund to House Account


Error Message - "Internal Server Error"

If you are processing a transaction or recording a previous payment, the Internal Server Error may be triggered by different reasons. Check the following topics:

  1. Ensure the email address under Guest Details is a valid email. "" or other place holder emails can cause this error.
  2. Double-check that OTA-generated emails are valid.
  3. If the card is a US-issued card, check if the country selected under Guest Details is United States.
  1. Under Credit Cards tab, verify if the CVV and expiration date of the card are valid.
  1. If you've just connected Cloudbeds Payments, check if your Onboarding process has been completed.

Remember when setting up your account, if all of the information is successfully verified, the process might take 1-2 days to be completed.

Slack | cb_payments_support | Cloudbeds | 29 new items
Powered by Zendesk