Usar certificados o tarjetas de regalo en el motor de reservas

Gabriela Garcia

Actualización 24 de septiembre de 2026 21:11

Objetivo	Configurar el motor de reservas de Cloudbeds para recopilar códigos de certificados de regalo, tarjetas de regalo o cupones de los huéspedes durante las reservas en línea.
Dirigido a	Administradores, gerentes y propietarios de propiedades que configuran procesos para certificados o tarjetas de regalo.
Úsalo cuando	Quieras que los huéspedes ingresen un código de certificado de regalo, tarjeta de regalo o cupón al hacer una reserva mediante el motor de reservas Plus.
Requisitos	Tu paquete de Cloudbeds debe incluir la función Campos personalizados. El campo del código de regalo debe configurarse para las reservas y mostrarse en el motor de reservas online. Además, debes contar con tus propios códigos de certificados o cupones de regalo y activar Transferencia bancaria para el motor de reservas.
Resultado esperado	Los huéspedes pueden ingresar su código de regalo en Información adicional durante el paso Datos del huésped y utilizar la opción de pago Tarjeta de regalo / Código de cupón al completar la reserva.
Limitaciones	Cloudbeds no crea, valida ni canjea certificados o tarjetas de regalo de forma nativa. El campo personalizado recopila el código en la reserva; la validación y el canje deben gestionarse manualmente o mediante una integración compatible de terceros.

Introducción

Usa este procedimiento para recopilar un código de certificado de regalo, tarjeta de regalo o cupón de los huéspedes que reservan mediante el motor de reservas de Cloudbeds. El código que ingrese el huésped aparecerá en la reserva de Cloudbeds PMS.

La configuración combina dos elementos independientes: un campo personalizado que recopila el código de regalo durante el paso Datos del huésped y la opción de pago Transferencia bancaria, que, mediante un código JavaScript personalizado, se muestra como Tarjeta de regalo / Código de cupón al finalizar la reserva.

Si tienes preguntas sobre las opciones de tarjetas o certificados de regalo en Cloudbeds PMS, contacta a nuestro equipo de soporte.

Índice

Integraciones de certificados o tarjetas de regalo
Antes de empezar
Configurar certificados o tarjetas de regalo para las reservas del motor de reservas
Revisar el proceso de reserva con tarjeta de regalo

Integraciones de certificados o tarjetas de regalo

Cloudbeds admite procesos con tarjetas de regalo mediante integraciones de terceros, pero Cloudbeds PMS no crea cupones ni tarjetas de regalo de forma nativa. Las propiedades pueden integrarse con VoucherCart, Gift Up! o Aiva de Myma.ai, o utilizar el procedimiento con campos personalizados descrito en este artículo.

Antes de elegir un proceso de canje automático de tarjetas de regalo, ten en cuenta lo siguiente:

Si un huésped ingresa un código de tarjeta de regalo incorrecto durante la reserva, la reserva se crea de todos modos, pero el saldo del folio no cambia.
Si la tarjeta de regalo no cubre el importe total de la reserva o del depósito, no se efectuará ningún cargo a una tarjeta de crédito como parte de este proceso de reserva. La propiedad deberá contactar directamente al huésped para cobrar el importe restante.

Si este proceso no satisface las necesidades de tu propiedad, no implementes esta configuración en el motor de reservas. En su lugar, gestiona manualmente los pagos con tarjetas de regalo mediante VoucherCart, Gift Up! o Aiva.

Antes de empezar

Confirma los siguientes requisitos antes de configurar el uso de certificados o tarjetas de regalo.

Antes de continuar:

Tu paquete de Cloudbeds debe incluir la función Campos personalizados.
Debes contar con tus propios códigos de certificados o cupones de regalo para ofrecer a los huéspedes.
El campo personalizado destinado al código de regalo debe aplicarse a Reservas y mostrarse en el Motor de reservas online, para que los huéspedes puedan ingresar el código al reservar.
Si utilizas el procedimiento con campos personalizados sin una integración, tu propiedad es responsable de llevar el registro de los códigos y validarlos.

Configurar certificados o tarjetas de regalo para las reservas del motor de reservas

Completa los siguientes tres pasos en orden. Primero, crea un campo para el código del huésped. Después, activa Transferencia bancaria para el motor de reservas. Por último, agrega el código JavaScript que cambia la opción de pago que ve el huésped.

Paso 1: Crear el campo personalizado

Crea un campo personalizado en el que los huéspedes puedan ingresar el código de su certificado o cupón de regalo. Sigue las instrucciones de Cómo crear un campo personalizado.

Configura el campo para que se aplique a Reservas y se muestre en el Motor de reservas online. Así, el campo para ingresar el código de regalo aparecerá en Información adicional durante el paso Datos del huésped.

Configura el campo del código de regalo como opcional. Si es obligatorio, los huéspedes que no tengan un certificado o cupón de regalo no podrán confirmar su reserva.

No uses Tarjeta de regalo como nombre del campo personalizado. La palabra tarjeta genera un error porque el sistema interpreta que el campo intenta recopilar datos de tarjetas de crédito. Usa, por ejemplo, Código de certificado de regalo, Código de regalo o Código de cupón.

Paso 2: Activar Transferencia bancaria en Opciones de pago

Transferencia bancaria es necesaria para este procedimiento, aunque los huéspedes verán la opción personalizada Tarjeta de regalo / Código de cupón en su lugar.

En el Menú principal , haz clic en Finanzas
En la pestaña Opciones de pago, haz clic en Transferencia bancaria.
Activa Transferencia bancaria y selecciona Motor de reservas en ¿Dónde quieres permitir este tipo de pago?
Haz clic en Guardar.

La página Finanzas debe mostrar Transferencia bancaria como opción activa y Motor de reservas como lugar donde se permite este tipo de pago.

Paso 3: Agregar el código en la sección JavaScript

Después de crear el campo personalizado y activar Transferencia bancaria para el motor de reservas, agrega el siguiente código en la sección JavaScript del motor de reservas Plus.

En el Menú principal , haz clic en Motor de reservas
Haz clic en la pestaña Personalizar.
Copia y pega el siguiente código en el campo JavaScript:

<script>
  window.addEventListener('on-booking-engine-ready', (e) => {
    const { eventSystem } = e.detail;

    eventSystem.dispatchEvent("custom-payment-option-change", {
      id: "cb-bank-id",
      name: {
        "en": "Gift Card / Voucher Code",
        "pt-br": "Cartão Presente / Código de Voucher",
        "fr": "Carte Cadeau / Code Bon",
        "es": "Tarjeta de Regalo / Código de Voucher",
        "de": "Geschenkkarte / Gutscheincode"
      },
      instructions: {
        "en": "Already filled in your Gift Card or Voucher number in the previous step? Select this option to proceed.",
        "pt-br": "Já preencheu o número do seu Cartão Presente ou Voucher na etapa anterior? Selecione esta opção para continuar.",
        "fr": "Vous avez déjà saisi votre número de Carte Cadeau ou Bon à l'étape précédente ? Sélectionnez cette option pour continuer.",
        "es": "¿Ya completaste el número de tu Tarjeta de Regalo o Voucher en el paso anterior? Selecciona esta opción para continuar.",
        "de": "Haben Sie Ihre Geschenkkarten- oder Gutscheinnummer bereits im vorherigen Schritt ausgefüllt? Wählen Sie diese Option, um fortzufahren."
      }
    });
  });
</script>

Haz clic en Guardar.

Antes de guardar, confirma que el código aparezca en el campo JavaScript de la pestaña Personalizar.

Revisar el proceso de reserva con tarjeta de regalo

Después de guardar la configuración, abre el motor de reservas y prueba el proceso completo. El campo personalizado y el código JavaScript cumplen funciones distintas, y ambos son necesarios para ofrecer la experiencia descrita en este artículo.

El campo personalizado creado en Huéspedes → Campos personalizados, configurado para Reservas y visible en el Motor de reservas online, permite ingresar el código de regalo en Información adicional durante el paso Datos del huésped. Este campo recopila el código y lo guarda en la reserva.
El código JavaScript agregado en Motor de reservas → Personalizar → JavaScript cambia la opción de pago Transferencia bancaria que aparece al finalizar la reserva por Tarjeta de regalo / Código de cupón.

Estas dos configuraciones funcionan juntas, pero no están vinculadas automáticamente. El campo personalizado solo guarda el código de regalo como dato de la reserva. Cloudbeds no valida ni canjea el código mediante esta configuración. La validación y el canje deben realizarse manualmente o mediante una integración de terceros, como VoucherCart, Gift Up! o Aiva.

Durante el paso Datos del huésped, confirma que el campo del código de regalo aparezca en Información adicional antes de que el huésped pase al pago.

El siguiente ejemplo muestra cómo el huésped ingresa el código de regalo durante el paso Datos del huésped y continúa con el proceso de reserva antes de seleccionar la opción de pago personalizada Tarjeta de regalo / Código de cupón.

Si Transferencia bancaria es la única opción de pago activada en el motor de reservas, solo se muestran las instrucciones para la tarjeta de regalo. El huésped no necesita seleccionar una opción de pago.

Siguiente paso operativo

Después de comprobar el proceso en el motor de reservas, gestiona el código de regalo recibido según el procedimiento de validación manual o la integración que utilice tu propiedad. El campo personalizado recopila el código, pero su validación y canje deben realizarse manualmente o mediante la integración de terceros correspondiente.