Bank credentials for Hotelmente PAY

They are the codes that identify your hotel as a merchant at your bank and let Hotelmente PAY create payment links and receive payment confirmations on your behalf. The money goes from the guest’s card to your own merchant account at BAC, and Hotelmente records the payment on the reservation in Cloudbeds.

• To be a BAC affiliated merchant (comercio afiliado), with your affiliate number. If you are not, BAC asks for your business documents to affiliate you.
• Online (e-commerce) card payments enabled on that affiliation. BAC calls its online products E-Commerce and Compra-Click (payment links).

BAC’s merchant pages: www.baccredomatic.com/es-cr/comercios-afiliados/herramientas-aceptar-pagos (Costa Rica) and www.baccredomatic.com/es-gt/empresas/comercios-afiliados (Guatemala). Each country has its own contact numbers.

Ask BAC’s merchant or e-commerce team for the credentials to accept online card payments through a partner platform (Hotelmente), in test (sandbox) and in production:
- Your merchant (affiliate) number for online payments.
- If you charge in dollars and local currency: whether there is a separate USD merchant number.
- The terminal ID, if your online payments use one.
- The API key (key ID).
- The API secret.
- The webhook signing secret, used to sign payment notifications.

Names vary by country; ask BAC to confirm each one in writing.

In Costa Rica, Guatemala, Honduras and Nicaragua, where hotels often charge in dollars and in local currency, Hotelmente shows an extra optional field: USD merchant (affiliate) number, if different. Fill it in only if BAC gave you a different number for dollar payments. In Panama and El Salvador the field does not appear.

• Step 1: Open Hotelmente PAY → PAY settings.
• Step 2: Scroll to Bank credentials.
• Step 3: Fill in Merchant (affiliate) number, Terminal ID (optional), API key (key ID), API secret, Webhook signing secret and Environment. In some countries also USD merchant (affiliate) number, if different.
• Step 4: Click Save credentials, then Test connection.

Only an owner of the hotel sees this panel. Others see: Only an owner of this hotel can see or change the bank credentials.

• Sandbox: BAC’s test environment. No real money moves. Start here with BAC’s test credentials and make test payments.
• Production: real payments to your merchant account. Switch only after test payments work, with BAC’s production credentials.

Test and production credentials are different. When you switch, replace all the values, not only the Environment field.

No. Guests type their card on BAC’s own payment page. Card data never passes through Hotelmente and is never stored by Hotelmente.
- BAC keeps: the card data and the money.
- Hotelmente keeps: your credentials (encrypted), the payment reference, amount, status and the last digits BAC reports.
- Cloudbeds receives: the payment on the reservation.

They are encrypted and stored for your hotel only. Secrets are never shown again: the screen shows only Saved and the last 4 characters. Leaving a secret field empty keeps the saved value. Only owners can see, save, test or remove them, and each change is recorded in your account’s activity.

• Bank API: Ready, or Waiting for BAC while BAC has not switched on the connection for Hotelmente.
• Credentials: Saved or Not saved, with Missing: and the fields still empty.
• Last test: Passed or Failed, with the date.
• Automation: whether payment links and reminders go out automatically.

While the bank API is waiting, Test connection answers: Waiting for the BAC API: payments through BAC are not switched on yet. Your credentials stay saved.

So that each payment is recorded on the reservation, create a payment method in Cloudbeds called, for example, Hotelmente PAY, and enter its code in PAY settings → Automation and Cloudbeds. Your Cloudbeds administrator can create it in the payment settings.

Yes. Fill in PAY settings, including your bank credentials, in advance: everything you enter is ready the day PAY is switched on for your country. Ask BAC early; affiliation and e-commerce paperwork usually takes the longest.

• Change: type the new values and click Save credentials. Empty secret fields keep the saved ones.
• Remove: click Remove and confirm. Payment links stop until new credentials are saved.

If you think a secret was exposed, ask BAC to cancel it and issue a new one, then save the new one here.

• Secrets cannot contain spaces. Paste them exactly as the bank gave them.: paste again without spaces or line breaks.
• Add your bank credentials in PAY settings first.: fill in Bank credentials in PAY settings.
• Choose your country for Hotelmente PAY first.: an owner chooses the connection and country next to Hotelmente PAY in My products, on the Hotelmente home.
• Waiting for the BAC API: BAC has not switched on the connection yet; nothing to fix.

Hotelmente PAY starts with BAC. If your hotel uses another bank, tell us which one through the contact page and choose Custom solution: it helps us decide which bank to connect next.