Payment Processing Setup


This article will walk you through how payment processing works and how to set it up.

What is payment processing and how do I use it?
  • Payment processing automates payment transactions between you and the guest. It allows you to process, verify, and accept or decline credit card transactions on behalf of the merchant through secure Internet connections. There are many existing payment processors (also known as payment gateways) that connect directly to your bank account and transfer funds directly into it.

    In order to verify the legitimacy of your guests' credit cards and collect the payments immediately through Cloudbeds, you must be signed up with one of the payment processing companies we are currently integrated with. Click here for our full list.
  • Payment Processing is a paid feature, contact our Support Team or your Sales Representative to try out payment processing
Enabling Payment Processing and Automatic/Scheduled Actions
Step 1. Activate payment processing

To use payment processing, first navigate to your Payment Options page by clicking on the settings icon. Under the Credit Card tab, you should see a section to activate or deactivate payment processing.

If you do not see this section, please contact our support team at to enable it

Click on the switcher under 'Connect Payment Gateway' section to activate payment processing and set the mode to LIVE

Step 2. Connect your gateway

You will see a dropdown with a list of payment gateways underneath, along with authentication fields to the right of it. Select the payment gateway that you want to use.

The required authentication fields are different for each payment gateway. This information can be found within the account setting of your gateway and by contacting your payment gateway's support team.

For example, Stripe requires only Stripe Secret API Key:

while Maxipago requires Merchant ID, Merchant Key and Processor:

Step 3. Select default actions (automatic and scheduled processing)

After you enter the required information and the account is verified, you will see a list of radio buttons to select the default option for direct reservations (mybooking reservations). If you are using myallocator to connect to either, CTrip, Agoda or Expedia, you will likewise see an option to select a default option for those channels as well.

The following choices are available for each:

1. Do nothing. I will process payments at a later time

  • Selecting this option captures the credit card information for you to access later. It does not do anything to the credit card besides capture the information and store it.

2. Authorize credit card for amount of deposit, but do not collect the payment

  • When this is selected, Cloudbeds sends the transaction to your processor for authorization. If approved, the transaction is placed in your Unsettled Transactions with a status of Authorized/Pending Capture.
  • The authorization places the funds on hold with the guest's bank. When the transaction is captured, the funds transfer process will occur.
  • This can be useful in situations where the reservation is booked for a later date. You can authorize the transaction to ensure the funds are available, then capture the transaction to obtain the funds upon arrival.

Please note: in myfrontdesk maximum period of authorization is 7 days. Authorizations which are more than 7 days old are considered as a auto-voided and are not shown in details.

3. Process the payment for amount of deposit

  • With this transaction type, the process is completely automatic. The transaction is submitted to your processor for authorization and, if approved, is placed in your Unsettled Transactions with the status Captured Pending Settlement. The transaction will settle at your next batch.

Would you like this action to be performed immediately after receiving the reservation, or postpone it until closer to the arrival date?

  • You may select whether to perform this action immediately or postpone it until closer to arrival date

Please note, virtual credit cards provided from third party channels may have specific processing requirements. Please confirm the channel’s virtual credit card policy before setting your payment processing method. [For example: Some virtual cards can only be charged on the day of check out and on the exact amount sent by the channel.]

Manual actions with credit cards
1. When creating new reservation

When creating a reservation, you can select what you would like to do for each reservation. You will be given all three options when creating a reservation directly.

  1. Create Reservation (does nothing with credit card)
  2. Create and Process Payment (charges the credit card)
  3. Save and Authorize Card (authorizes the amount on credit card but does not charge it)
2. Authorize an unauthorized credit card

To authorize a credit card that has not yet been authorized:

  1. On reservation details page, click on "Credit Cards" tab.
  2. Click Add Card on the left side if card details were not previously imported
  3. Enter all the card payment details.
  4. Authorize the credit card and enter the amount to authorize it for.

Please note: in myfrontdesk maximum period of authorization is 7 days. Authorizations which are more than 7 days old are considered as a auto-voided and are not shown in details.

3. Actions for authorized credit cards

If the credit card has already been authorized, you will see three buttons next to it:

1. Authorize

  • Authorizing a credit card that already has an authorization will void the previous authorization, and create a new one for the new amount.

2. Capture

  • Will capture the funds of the existing authorization. A field will appear to enter the amount, which can be less than or equal to the authorization amount.
  • If a smaller amount is entered, the remainder of the amount will be voided. If a larger amount is entered, the transaction will fail.

3. Void

  • Will void the existing authorization and release the hold.
4. Add Payment (charge card)

You may charge the guest's card directly from reservation. Follow the guide in this knowledge base: Processing Payment Through Payment Gateway

5. Add Refund (refund processed amount)

You may refund the sum processed through gateway in myfrontdesk directly from the reservation. Follow the guide in this knowledge base article: Processing Refund Through Payment Gateway

Have more questions? Contact Support


Powered by Zendesk