PayU Latam - Connection Guide

PayU Latam is one of the Payment Gateways Cloudbeds connects through the Payment Processing Feature.

Note that the credit card details are stored by the payment gateway and they do not allow customers to view credit card details.

  • For security reasons, PayU stores credit card details on their side. This is a security feature on the gateway end to prevent frauds.
  • Because of this, in case  you have a reservation that was charged by the payment gateway, A then suddenly you switch to payment gateway B, all the charges related to this reservation will be done from within the payment gateway A.
Sign up

Before connecting to PayU, you need an account. Check the registration process for each country below. If you already have an account with PayU, continue with the Connection Steps

Things to know before getting started:

  • For the following LATAM countries (Peru, Mexico, Chile, Argentina, Panama, Brazil), be aware that merchants must have a TPV (total process volume) of 100,000 USD minimum on a monthly basis to sign up.
  • For Colombia, auto-onboarding is applicable to sign up.
  • The Cloudbeds partner ID (707577) should be inserted in the Anything else you would like to share with you? box of the country form links below.

Follow the process indicated in the registration link:

Retrieve your PayU credentials
  1. Login to your PayU account and write down your Account Id from the first page.
  2. Click Configuration to find the remaining information.
  3. Write down your API key, Api login, and Merchant ID.


Connect Payu to your Cloudbeds PMS

You must have Payment Processing feature enabled on your account. If you don't have it, contact our Support Team at

  1. Click Account.
  2. Select Settings.
  1. Under the Property Configuration, select Payment Options
  2. You will be on the Credit Card tab.
  3. Under Payment Gateway section, turn on the toggle to Activate the gateway.
  4. Choose Live mode.

While in Test Mode, you can verify if the gateway is successfully connected and check that the transactions are coming through correctly. When you are ready to start processing real transactions, you can switch to Live Mode.

The Live/Test toggle will be displayed only when you are connecting the payment gateway for the first time. When the button is set to Test, it can be changed to Live, but once it's Live it cannot be changed back to Test. After refreshing the page, this button will disappear.

  1. Select PAYULATAM in the drop-down menu.
  2. Enter your PayU Merchant ID.
  3. Enter your PayU Account ID.
  4. Enter your PayU API Login.
  5. Enter your PayU API Key.
  6. Select your PayU Account Country from the drop-down list.
  7. Click Connect Gateway.
Billing Address Requirements
  1. Select the Billing Address Requirements.

These settings are only related to reservations made via the Cloudbeds PMS or Cloudbeds Booking Engine. Different OTAs may have different settings regarding billing details. Read more here.

  • Require billing address (...) using the booking engine.
  • Require billing address (...) from within the application.
  • Require billing address (...) to an existing reservation.
  • Use Guest Details as Billing Details when information is not available.
  1. Make sure the following fields setup as required based on your country (see the table below for reference).

Required fields per country

Billing Details AR BR CL CO MX PA PE
Date of Birth            
ID Number            
Tax ID            
Address 1
Address 2
Postal Code
E-mail Address
Phone Number

Supported currencies and requests per country




Argentina Credit: Mastercard, Visa, Amex, Diners
Debit: Mastercard, Visa
Brazil Credit: Amex, Diners, Mastercard, Visa, Elo and Hipercard BRL, USD
Chile Credit: Amex, Diners, Mastercard, Visa CLP      
Colombia Credit: Amex, Diners, Mastercard, Visa COP, USD      
Mexico Credit: Amex*, Mastercard, Visa
Debit: Mastercard, Visa
Panama Credit: Mastercard, Visa USD      
Peru Credit and Debit: Amex, Diners, Mastercard, Visa PEN, USD    
  • *Authorization can only be done in local currency. For example, your PayU account is setup in Peru and uses Peruvian Pesos but your Cloudbeds PMS account is set up to charge in USD — you will not be able to use the Authorize function. You can still to use the Charge function.
  • Other payment methods may be supported by PayU Latam but are currently not supported by Cloudbeds PMS.

More information about Charges, Authorizations and Refunds

  • Charge without CVV is not available for VISA branded cards and a manual process must be done from PayU to enable it for the other brands.
  • If an Authorization is not voided or captured, guest must wait up to 20 days for the amount to be released.
  • Mastercard does not support void for pre-authorizations.
  • If an Authorization is not voided or captured, guest must wait up to 20 days for the amount to be released.
  • Partial refund is not allowed for Hipercard cards.
  • If your property is set up to use USD in Cloudbeds PMS, PayU will not work. In Chile, PayU only accepts transactions in CLP.
  • Multiple partial refunds cannot be sent. If you refund partially a transaction, you will not be able to refund the remaining amount.
  • Multiple partial refunds cannot be sent. If you refund partially a transaction, you will not be able to refund the remaining amount.
  • Pre-authorizations cannot be voided in Mexico. The banks do this process automatically and the guests must wait up to 8 days for the amount to be released.
  • Pre-authorizations are not available for American Express branded cards.
  • Charge without CVV and Pre-Authorization: A manual process from PayU must be done to enable these features for Mastercard, Amex and Diners branded cards, contact PayU support for assistance.
  • Pre-Authorization: For Visa branded cards, If an Authorization is not voided or captured, guest must wait up to 22 days for the amount to be released.
  • For Mastercard, Diners or Amex, if the transaction is not voided or captured after 27 days, the transaction will be captured automatically and PayU does not send an update for the transaction.

Charging Credit Cards for OTAs Reservations

Each OTA may require more or less information from the guest in order to make a reservation. To charge their credit cards without risk of fraud, PayU requires as much information as possible.

In this section we will provide more details about it. does not require any billing details for credit cards. Also, it will only require the guest's mailing address — if you set up your policies accordingly. Review your's settings to require Address and CVC (security code) for every reservation. 

Guest's address
  1. Login to your extranet and click Property > Policies.
  2. Under Guest Information, click Edit.
  1. Under Guest Information make sure you select No for both questions below and save.
Credit card security code (CVV)

Make sure is requesting the CVV (security code) for the credit cards. To check, contact's support team.

Often, the default setting is to not send CVV codes, especially if your property is recently listed on If that's the case, and you need the codes for your business operations, contact the Connectivity team by sending a message through your Extranet Inbox.

Further information, read this Help Article

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



Please sign in to leave a comment.