Las tarjetas de regalo suelen tener un valor almacenado que puede gastarse en múltiples transacciones hasta que se agote el saldo, por ejemplo, para una experiencia y/o un artículo de la tienda. A menudo se usan como regalos para amigos, familiares o colegas, permitiendo a los destinatarios la flexibilidad de elegir sus propios artículos o experiencias.

Ventrata ofrece a los clientes la oportunidad de comprar vales por cualquier cantidad deseada. Estos vales pueden usarse posteriormente para comprar cualquier producto de su oferta.

Las tarjetas de regalo pueden venderse y canjearse a través de:

📱 Puntos de Venta
💻 Backoffice
🌍 Web Checkout (siga este artículo)

Configuración de vales de regalo

Para habilitar el flujo de tarjetas de regalo en su sitio, los vales de regalo deben estar permitidos primero en la configuración del web checkout. Siga los pasos a continuación para configurar esta función globalmente y especificar su disponibilidad para páginas o botones específicos.

Permitir vales de regalo globalmente

En el panel de Ventrata, vaya a Web Checkouts > Checkouts .

Checkouts
Seleccione un checkout existente.
Presiona el EDIT DETAILS (EDITAR DETALLES) botón para editar el checkout.

Edit Details (Editar detalles)
Desplázate por el formulario de pago o simplemente busca 'Allow Gift Voucher (Permitir vales de regalo)' y marca la casilla para permitir la compra de vales de regalo a través del checkout widget.

Allow Gift Voucher (Permitir vale de regalo)
Presiona Update Checkout (Actualizar checkout) botón para guardar tus cambios.

Update Checkout (Actualizar checkout)

Habilitar vales regalo para páginas o botones específicos

Una vez que los vales regalo están permitidos globalmente, puedes personalizar en qué páginas o botones se ofrece la función.

1. Desactivar la función globalmente

Desactiva temporalmente la función en todo el sitio. Este paso reduce el trabajo manual al habilitarla para páginas o botones específicos más adelante.

Inserta el siguiente código en el data-config de tu <script> etiqueta para desactivar la función en todo el sitio.

"features": {
  "gifts": {
     "allowed": false
   }
}

2. Habilitar la función para páginas o botones específicos

Agrega el siguiente código en el data-config de cualquier página o botón donde quieras permitir la compra de vales regalo.

"features": {
  "gifts": {
    "allowed": true
  }
}

📒 NOTA

Los vales de regalo deben estar habilitados primero en la configuración del web checkout para que el flujo de la tarjeta de regalo funcione. Si no se permite esta función globalmente, el flujo de la tarjeta de regalo no estará disponible en su sitio.

Parámetros de la tarjeta de regalo

Tiene la opción de especificar ciertos parámetros de la tarjeta de regalo, como el valor mínimo y el período de vencimiento.

En el panel de Ventrata, vaya a Supplier Settings (Configuración del proveedor) > Supplier Settings (Configuración del proveedor) .

Supplier Settings (Configuración del proveedor)
Presiona el botón EDIT DETAILS (EDITAR DETALLES).

Edit Details (Editar Detalles)
Desplácese por el formulario de detalles del proveedor o busque 'Gift Card Min Amount (Cantidad mínima de la tarjeta de regalo)'.
Ingrese el valor mínimo y/o máximo de una tarjeta de regalo.

Gift Card Min/Max Amount (Cantidad mínima / máxima de la tarjeta de regalo)

📒 NOTA
La misma cantidad se mostrará en todas las monedas. Este valor no se convierte.
Ingrese el período de vencimiento de la tarjeta de regalo en días, meses o años.

Gift Expiry (Período de vencimiento de la tarjeta de regalo)
Presiona el botón Update Supplier (Actualizar proveedor).

Update Supplier (Actualizar proveedor)

Lista de características de las tarjetas de regalo

La función Tarjetas de regalo admite varias subfunciones que se pueden agregar a su solución de checkout de Ventrata haciendo una de dos cosas:

Actualizar atributo Data-Config - agregando el siguiente código, reemplazando el subfeatureName con el nombre de una de las funciones compatibles y especificando su value, consulte la tabla de subfunciones a continuación.

📗 CONSEJO
Si desea incluir múltiples subfunciones, inclúyalas todas en el mismo objeto gifts. Recuerde que el objeto gifts ya está incluido en el objeto features.
```
"features": {
  "gifts": {
     "subfeatureName": value,
     "subfeatureName1": value
  }
}
```
Agregar subfunción al script o botón - agregue la subfunción a su data-config para script o botón en el siguiente formato:

📗 CONSEJO
Si desea incluir múltiples subfunciones, inclúyalas todas en el mismo objeto gifts , cada subfunción separada por una coma. Recuerde que el gifts el propio objeto está incluido en el objeto features.
```
<script 
src="https://cdn.checkout.ventrata.com/v3/production/ventrata-checkout.min.js" type="module" data-config='{"apiKey":"<YOUR_API_TOKEN>", "features":{"gifts": {"featureName": value, "featureName1": value }}}'>
</script>
```

La función de Tarjetas de Regalo de Ventrata admite las siguientes subfunciones:

Subfunción	Predeterminado	Valores disponibles	Descripción
`allowed`	`true`	`true` / `false`	cuando está habilitada desde el panel, esta función puede aparecer en el script
`modo`	no establecido por defecto	`simple`	modo predeterminado es el modo estándar donde el proceso comienza con la selección de un producto antes de proceder al flujo de la tarjeta de regalo, como es el modo predeterminado, no es necesario definirlo en el script; modo simple permite la compra de una tarjeta de regalo independiente sin seleccionar un producto específico usando un botón dedicado
`openByDefault`	`false`	`true` / `false`	permite la compra de tarjetas de regalo a través del checkout web; usado solo en modo `default`
`disableAmountInput`	`false`	`true` / `false`	desactiva la capacidad de ajustar el precio por unidad de la tarjeta de regalo; usado solo en modov`default`

Flujo de tarjetas de regalo

Modo predeterminado

El cliente selecciona un producto donde se permiten tarjetas de regalo. En la página Tickets, aparece un enlace Comprar como tarjeta de regalo debajo del selector de unidades.

Cuando el cliente presiona el enlace, el lado derecho del widget se llena con una breve descripción de la función, un campo para ingresar el monto de la tarjeta de regalo, seguido de instrucciones sobre el monto mínimo y los términos de compra.

📗 CONSEJO

Una vez que el cliente entra en el flujo de la tarjeta de regalo, un enlace Volver a la compra de entradas reemplaza el enlace Comprar como tarjeta de regalo, lo que permite al cliente salir del flujo de la tarjeta de regalo y continuar con la compra normal de entradas.

El cliente tiene la opción de:

establecer un monto total sin seleccionar una unidad, o
establecer un monto por unidad, luego seleccionar el número de unidades deseadas; un desglose de la compra se muestra encima del campo 'Valor de la tarjeta de regalo'.

El botón Continuar lleva al cliente al Checkout donde,

En el lado izquierdo de la página, el cliente puede ingresar sus datos de contacto

📒 NOTA
La dirección de correo electrónico es el único campo obligatorio.
En el lado derecho, se muestra un fondo degradado y un ícono de tarjeta de regalo con su valor

📒 NOTA
Los colores del degradado se extraen de la configuración de la marca en el panel de Ventrata.

una nota que indica el período de validez de la tarjeta de regalo según lo configurado en la página Supplier Settings (Configuración del proveedor).
el monto total adeudado.

📒 NOTA
Si la función promoAndGiftCardInput está configurada como true, puede permitir que el cliente canjee códigos de promoción u otras tarjetas de regalo. Si la función promoAndGiftCardInput está configurada como false, no se muestra el campo de entrada de promoción y no se pueden aplicar descuentos. Para más información, consulte la Lista de funciones del checkout.

Modo simple

El modo simple permite a los clientes comprar una tarjeta de regalo sin tener que seleccionar un producto primero.

Prueba el modo simple tú mismo

📒 NOTA

El modo simple es un flujo sin producto. Por lo tanto, NO incluya un productID en el data-config.

Configuraciones

Agrega el objeto gifts y la subfunción de modo simple a tu data-config para script o botón en el siguiente formato:

📒 NOTA

Tenga en cuenta que openByDefault y disableAmountInput no son compatibles en el modo simple.

"features": {
  "gifts": {
    "mode": "simple"
  }
}

Moneda predeterminada

Dado que el modo simple no está vinculado a ningún destino o producto específico, la lista de monedas compatibles se extrae de la configuración de Web Checkout (Web Checkout > [checkout seleccionado] > Edit Details (Editar detalles) > Available Currencies (Monedas disponibles)). Para hacer que una moneda específica sea la moneda predeterminada, asegúrate de que aparezca primero en la lista de monedas disponibles en la configuración de tu web checkout. Para cambiar entre monedas en modo simple, usa el icono del globo como de costumbre.

Default Currency (Moneda predeterminada)

Flujo

Al presionar el botón de la tarjeta de regalo, el cliente es redirigido a la vista simple de tarjeta de regalo.

Buy a gift card (Compra una tarjeta de regalo)

El cliente ingresa el valor de la tarjeta de regalo en el campo dedicado y presiona el botón Continuar.

Luego, el cliente es llevado al Checkout donde

En el lado izquierdo de la página, el cliente puede ingresar sus datos de contacto

📒 NOTA
La dirección de correo electrónico es el único campo obligatorio.
En el lado derecho, se muestra un fondo degradado y un ícono de tarjeta de regalo con su valor

📒 NOTA
Los colores del degradado se extraen de la configuración de la marca en el panel de Ventrata.
una nota que indica el período de validez de la tarjeta de regalo según lo configurado en la página Supplier Settings (Configuración del proveedor).
el monto total adeudado

📒 NOTA
Si la función promoAndGiftCardInput está configurada como true, puede permitir que el cliente canjee códigos de promoción u otras tarjetas de regalo. Si la función promoAndGiftCardInput está configurada como false, no se muestra el campo de entrada de promoción y no se pueden aplicar descuentos. Para más información, consulte la Lista de funciones del checkout.

Checkout

Opciones de entrega de la tarjeta de regalo

Entregar al comprador - el cliente ingresa su dirección de correo electrónico en la página de checkout y la tarjeta de regalo se entrega a esa dirección. De esta manera, la entrega de la tarjeta de regalo al destinatario final es manejada por el comprador.
Entregar a un amigo - el cliente también tiene la opción de enviar la tarjeta de regalo como un vale directamente a un amigo (el destinatario de la tarjeta de regalo). En la página de confirmación después del pago, hay otro formulario de contacto disponible para ingresar el nombre completo, correo electrónico y un mensaje personalizado.

Delivered To The Buyer (left) & To Friend (right)

Gift card delivery options (Opciones de entrega de la tarjeta de regalo)

Configuración personalizada de tarjetas de regalo

Actualizar data-config

Agregue una o ambas funciones de tarjeta de regalo a su data-config para script o botón para personalizar el comportamiento del widget, consulte la Guía de implementación para más información.

openByDefault

Cuando esta función está habilitada (establecida en true), el cliente es dirigido automáticamente al flujo de la tarjeta de regalo para el producto sin necesidad de hacer clic en un enlace. Sin embargo, el flujo de la tarjeta de regalo permanece idéntico. Esto es especialmente beneficioso en casos donde el producto funciona esencialmente como una tarjeta de regalo.

Prueba la función de tarjetas de regalo tú mismo

"features": {
 "gifts" : {
   "openByDefault": true // by default: false
 }
}

disabledAmountInput

Esta función restringe la capacidad del cliente para ajustar el precio por unidad de la tarjeta de regalo; solo puede elegir el número de entradas.

"features": {
 "gifts" : {
   "disableAmountInput": true // by default false
 }
}

openByDefault + disableAmountInput

La combinación de las dos funciones le permite mantener cierto control sobre el proceso de compra de tarjetas de regalo. De esta manera, los clientes son dirigidos sin problemas al flujo de regalo, mientras que el precio por unidad de la tarjeta de regalo está fijado.

"features": {
 "gifts" : {
   "openByDefault": true, // by default: false
   "disableAmountInput": true // by default false
 }  
}

Cómo usar tarjetas de regalo en el web checkout

Configuración de vales de regalo

Permitir vales de regalo globalmente

Habilitar vales regalo para páginas o botones específicos

1. Desactivar la función globalmente

2. Habilitar la función para páginas o botones específicos

Parámetros de la tarjeta de regalo

Lista de características de las tarjetas de regalo

Flujo de tarjetas de regalo

Modo predeterminado

Modo simple

Configuraciones

Moneda predeterminada

Flujo

Opciones de entrega de la tarjeta de regalo

Configuración personalizada de tarjetas de regalo

Actualizar data-config