BigCommerce Integration Guide with Omniwallet

¿Qué permite esta integración?

La app de Omniwallet para BigCommerce permite:

• Capturar los importes de compra para que Omniwallet asigne automáticamente los puntos al cliente.

• Dar de alta nuevos clientes en el programa de fidelización.

• Permitir que los clientes canjeen sus puntos acumulados por descuentos en el carrito o en el checkout.

Instalación de la app de Omniwallet

1. Instalar la app

1. Accede al Marketplace de aplicaciones de BigCommerce.

2. Busca e instala la app de Omniwallet.

3. Asegúrate de disponer de una suscripción activa a Omniwallet.

   Si no la tienes, puedes obtenerla desde la web de Omniwallet.

2. Configuración inicial de la app

Una vez instalada la app:

1. Accede a la configuración de la aplicación.

2. Introduce los siguientes datos:

   • Subdominio de Omniwallet

   • Token de Omniwallet

Obtener el subdominio

El subdominio corresponde a tu cuenta de Omniwallet.

Obtener el token

Puedes generar el token desde tu panel de Omniwallet:

Conexiones → API → Crear token

3. Configurar reglas de puntos

En la configuración de la app podrás definir:

• Reglas de conversión:

  • Moneda → puntos

  • Puntos → crédito de tienda

• Estados del pedido:

  • Estado que otorga puntos

  • Estado que retira puntos en caso de cancelación o reembolso

Guarda la configuración una vez finalizada.

Configuración de widgets de Omniwallet

Tras completar la configuración general, accede a la sección de widgets de la app.

Puedes dejar los valores predeterminados y continuar con la instalación de los widgets en tu tienda.

Cómo añadir los widgets de Omniwallet a tu tienda

⚠️ Importante
Los widgets deben añadirse a páginas accesibles solo para clientes registrados.

Widget: Resumen de usuario

Este widget muestra:

• Puntos disponibles del cliente

• Código QR de su tarjeta Omniwallet

• Enlaces de descarga de la tarjeta virtual (Android e iOS)

Instalación

• Se añade desde el Page Builder de BigCommerce.

Widget: Historial de transacciones

Este widget muestra:

• Historial de puntos ganados y perdidos

• Canjes de puntos por crédito de tienda

• Pedidos relacionados con el programa de fidelización

Instalación

• Se añade desde el Page Builder de BigCommerce.

Widget: Conversión de puntos

Este widget permite:

• Convertir puntos Omniwallet en crédito de tienda

• Usar ese crédito como descuento en productos

Instalación

• Se añade desde el Page Builder de BigCommerce.

Widget: Puntos por producto

Este widget muestra cuántos puntos puede ganar el cliente al comprar un producto.

⚠️ Este widget no se añade desde el Page Builder.
Debe insertarse manualmente en el tema de la tienda.

Inserción manual del widget de puntos por producto

1. Acceder a los archivos del tema

1. Ve a Tienda → Temas.

2. Selecciona el tema activo.

3. Haz clic en Avanzado → Editar archivos de tema.

2. Mostrar puntos en la ficha de producto

1. Abre el archivo:

templates/components/products/product-view.html

2. Busca el siguiente div:

<div class="productView-price">

3. Justo debajo del precio del producto, añade este código:

<span id="ow_earned_points"
      class="ow-earned-points-product-view"
      data-price="{{#if product.price.with_tax}}{{product.price.with_tax.value}}{{/if}}{{#if product.price.without_tax}}{{product.price.without_tax.value}}{{/if}}"
      data-range="{{#and product.price.price_range (if theme_settings.price_ranges '==' true)}}true{{else}}false{{/and}}">
</span>

3. Mostrar puntos en la tarjeta de producto

1. Abre el archivo:

templates/components/products/card.html

2. Añade el siguiente código en la posición donde quieras mostrar los puntos (por ejemplo, al final de la tarjeta):

<span id="ow_earned_points"
      class="ow-earned-points-product-card"
      data-price="{{#if price.with_tax}}{{price.with_tax.value}}{{/if}}{{#if price.without_tax}}{{price.without_tax.value}}{{/if}}"
      data-range="{{#and price.price_range (if theme_settings.price_ranges '==' true)}}true{{else}}false{{/and}}">
</span>

3. Guarda ambos archivos tras realizar los cambios.

Cómo utilizar la aplicación de Omniwallet

Alta de clientes y visualización de widgets

• Los clientes existentes no se añadirán automáticamente a Omniwallet.

• Por motivos legales, un cliente se añade al sistema cuando realiza y completa un pedido.

• Los nuevos clientes que creen una cuenta con la app instalada se añadirán automáticamente, incluso sin realizar una compra.

Ver los widgets en funcionamiento

Para comprobar la integración:

• Crea una nueva cuenta de cliente
  
  o

• Realiza y completa un pedido con una cuenta existente

Después de esto, podrás acceder a la zona privada y ver todos los widgets de Omniwallet.

Experiencia del cliente

Una vez activa la integración:

• Los clientes pueden ver:

  • Sus puntos acumulados

  • Su historial de transacciones

  • Los puntos que ganarán al comprar cada producto

• Los puntos pueden canjearse directamente por descuentos en la tienda.