Guía completa: cómo integrar Omniwallet con Prestashop

Requisitos previos

Antes de comenzar, asegúrate de disponer de:

• Una tienda activa en PrestaShop

• Una cuenta activa en Omniwallet

• Un API Token generado en Omniwallet

Descarga del módulo de Omniwallet

Descarga el módulo oficial de Omniwallet para PrestaShop AQUÍ.

Guarda el archivo ZIP en tu equipo, ya que lo necesitarás para la instalación.

Instalación del módulo en PrestaShop

1. Accede al backoffice de tu tienda PrestaShop.

2. Dirígete a Módulos > Gestor de módulos.

3. Haz clic en "Subir un módulo"

4. Arrastra el archivo ZIP del módulo de Omniwallet al área de carga.

5. Espera a que el módulo se instale correctamente.

Configuración del módulo

Una vez instalado:

1. Accede a la configuración del módulo Omniwallet.

2. Completa los siguientes campos:

Parámetros de configuración

• Nombre del subdominio de la tienda
  Subdominio de acceso a tu cuenta Omniwallet.
  Ejemplo: si accedes a ejemplo.omniwallet.net, el subdominio es ejemplo.

• Token de Omniwallet
  

  Token de autenticación proporcionado por Omniwallet para conectar tu tienda con la plataforma. Este token es único y confidencial. Puedes obtenerlo desde el panel de administración de Omniwallet en:

  Integraciones → API

• Canjear puntos a euros
  Define la regla de conversión de puntos a euros que se usará en el checkout. Este valor indica cuántos euros equivale 1 punto cuando el cliente canjea sus puntos.
  Ejemplo: Si introduces 0.10, significa que 1 punto = 0,10€. Así, 100 puntos = 10€ de descuento.

• Compra mínima
  Importe mínimo de compra necesario para que el cliente pueda canjear sus puntos. Si el carrito no alcanza este valor, no se permitirá el canje de puntos

• Máximo de puntos a gastar
  Límite máximo de puntos que un cliente puede canjear en una única compra. Esto permite controlar el descuento máximo aplicable por pedido.

• Puntos del programa Omniwallet CMS
  Selecciona una página CMS existente donde se explique tu programa de fidelización. Esta página se enlazará desde diferentes partes de la tienda para que los clientes puedan conocer las condiciones del programa.

• Nombre del programa de fidelización
  Personaliza el nombre de tu programa de fidelización. Este nombre aparecerá en la interfaz del cliente en lugar de "Omniwallet".
  Ejemplos: "Club Premium", "Puntos Oro", "Mi Programa de Recompensas"

• Compra mínima con envío
  Determina si el importe mínimo de compra para canjear puntos incluye o no los gastos de envío. Si está activado, los gastos de envío se suman al total para calcular si se alcanza el mínimo.

• Omniwallet activo
  Activa o desactiva el módulo.
  

• Crear clientes automáticamente en Omniwallet
  Esta opción controla si los clientes de PrestaShop se crean automáticamente en Omniwallet:
  Activado (por defecto): Los clientes se crean automáticamente en Omniwallet cuando se registran en PrestaShop o realizan su primera compra.
  Desactivado: Los clientes NO se crean automáticamente. Deben crearse manualmente desde el backoffice de Omniwallet o mediante otras integraciones (API, importación, etc.).
  
  Esta opción es útil cuando quieres gestionar manualmente qué clientes forman parte del programa de fidelización, o cuando la creación de clientes se realiza desde otro sistema.

• Activar programa de referidos
  Esta opción controla si los clientes pueden ver y compartir su enlace de referido desde el área "Mi Cuenta":
  Activado (por defecto): Los clientes verán la sección "Invita a tus amigos" con su enlace de referido personalizado para compartir con amigos y familiares.
  Desactivado: La sección de referidos NO se mostrará en el área de cliente. Útil si no tienes un programa de referidos activo o prefieres gestionarlo de otra manera.
  Nota: Esta opción solo controla la visibilidad del enlace. Para configurar las recompensas por referidos, accede al backoffice de Omniwallet.

• Estado de éxito del pedido
  Selecciona los estados de pedido que activan la asignación de puntos al cliente. Cuando un pedido alcanza alguno de estos estados, se generan los puntos correspondientes.

  Recomendación: Selecciona estados como "Pago aceptado" o "Enviado" para asegurar que solo se otorgan puntos en pedidos confirmados. del pedido que suma puntos en Omniwallet.

• Estado de revocación del pedido
  Selecciona los estados de pedido que provocan la revocación de puntos. Cuando un pedido pasa a alguno de estos estados, los puntos asignados se eliminan de la cuenta del cliente.

  Recomendación: Incluye estados como "Cancelado", "Reembolsado" o "Error de pago".

• Guarda la configuración

Funcionamiento del sistema

Una vez configurado el módulo:

• Cada compra válida:

  • Se registra en Omniwallet.

  • Genera puntos automáticamente para el cliente.

• En caso de cancelación o devolución:

  • Los puntos se revocan según el estado configurado.

• En el checkout:

  • El cliente puede canjear puntos por euros de descuento.

Resultado final

Con la integración activa:

• La fidelización forma parte natural del proceso de compra.

• Los clientes acumulan y canjean puntos sin fricción.

• El equipo no necesita gestionar procesos manuales.

• El programa de loyalty impacta directamente en ventas y recurrencia.