Guía de integración con Prestashop

Requisitos previos

Antes de empezar, asegúrate de tener:

• Acceso al Backoffice de PrestaShop con permisos de administrador.

• Acceso a tu cuenta de Omniwallet (y saber tu subdominio).

• El módulo de Omniwallet para PrestaShop descargado en formato .zip.

1) Descarga el módulo de Omniwallet

1. Entra en la guía/área de descargas de Omniwallet.

2. Descarga el módulo de Omniwallet para PrestaShop (archivo .zip) y guárdalo en tu ordenador.

2) Instala el módulo en PrestaShop

1. Entra en el Backoffice de PrestaShop.

2. Ve a Módulos (en algunas versiones aparece como “Módulos y Servicios” o “Module Manager”).

3. Pulsa Subir un módulo (o “Añadir nuevo módulo”).

4. Arrastra el archivo .zip del módulo de Omniwallet o selecciónalo desde tu ordenador.

5. Espera a que termine la instalación y confirma que el módulo aparece como instalado.

Si al subir el ZIP falla, normalmente es por límite de tamaño o permisos. En ese caso, toca subirlo por FTP al directorio de módulos y luego instalarlo desde el backoffice.

3) Accede a la configuración del módulo

1. Dentro de Módulos, busca Omniwallet.

2. Pulsa Configurar.

Ahí verás los campos de configuración que conectan PrestaShop con tu cuenta Omniwallet.

4) Obtén tu Subdominio de Omniwallet

Tu subdominio es el identificador de tu cuenta.

• Si tu URL es: https://ejemplo.omniwallet.net o https://ejemplo.omniwallet.tools

• Tu subdominio es: ejemplo

Dónde ponerlo: en el campo “Nombre del subdominio de la tienda”.

5) Crea un API Token en Omniwallet

1. Entra en Omniwallet.

2. Ve a Integraciones → API (o sección equivalente).

3. Crea un API Token nuevo.

4. Copia el token.

Dónde ponerlo: en el campo “Token de Omniwallet” dentro del módulo en PrestaShop.

Consejo: guarda ese token en un lugar seguro. Es la “llave” de conexión.

6) Configura la regla de canje (Puntos → €)

En la configuración del módulo, localiza el campo:

“Canjear puntos a euros”

Aquí defines la conversión que verá el usuario al canjear:

• Ejemplo: 100 puntos = 1€

• O: 1 punto = 0,01€

Esto determina cuántos puntos se descuentan cuando el cliente usa puntos en el carrito/checkout.

7) Define límites y condiciones (mínimos)

Configura estos campos según tu política de fidelización:

“Compra mínima”

Importe mínimo para permitir el canje de puntos.

• Ejemplo: el cliente solo puede canjear si la compra es ≥ 20€.

“Compra mínima con envío”

Activa esto si quieres que el mínimo incluya o no incluya los gastos de envío.

• Si está activado: el envío cuenta para llegar al mínimo.

• Si está desactivado: solo cuenta el subtotal de productos.

8) Enlaza términos y condiciones del programa

“Puntos del programa Omniwallet CMS”

Selecciona la página (en tu CMS) donde están los términos del programa.

Esto es útil para:

• informar al cliente

• tener el programa bien documentado

• reforzar transparencia y cumplimiento

9) Define el nombre del programa

“Nombre del programa de fidelización”

Es el nombre comercial del programa que verá el cliente (según cómo lo muestre tu configuración).

Ejemplo:

• “Club Puntos”

• “Rewards”

• “VIP Club”

10) Activa el módulo

“Omniwallet activo”

• Actívalo para poner la integración en marcha.

• Si lo desactivas, PrestaShop deja de enviar datos y el canje no aparece.

11) Configura los estados de pedido (muy importante)

Esto determina cuándo se suman puntos y cuándo se revocan.

“Estado de éxito del pedido”

Selecciona el estado en el que quieres que los puntos se confirmen.

• Recomendación típica: Entregado / Enviado / Pagado / Completado (depende de tu operativa)

“Estado de revocación del pedido”

Selecciona el estado que debe anular los puntos.

• Normalmente: Cancelado / Reembolsado

Esto evita que alguien acumule puntos por un pedido que luego se cancela.

12) Guarda la configuración

Pulsa Guardar.

13) Prueba la integración (checklist rápido)

Haz una prueba real con un cliente de test:

Prueba A — Compra que suma puntos

1. Haz un pedido de prueba en la tienda.

2. Cambia el pedido al estado de éxito (el que configuraste).

3. Entra en Omniwallet y comprueba que:

   • aparece la transacción

   • se han sumado los puntos al cliente

Prueba B — Cancelación que revoca puntos

1. Crea otro pedido.

2. Pásalo al estado de éxito (para que sume puntos).

3. Luego cámbialo a Cancelado/Reembolsado (según tu configuración).

4. Comprueba que Omniwallet revoca esos puntos.

Prueba C — Canje en checkout

1. Usa un cliente con puntos disponibles.

2. Añade productos al carrito.

3. Comprueba que aparece la opción de canjear puntos por €.

4. Finaliza compra y revisa que:

   • los puntos se descuentan correctamente

   • el descuento se aplica en el pedido

14) Recomendaciones de puesta en marcha

• Empieza con una conversión simple (ej. 100 pts = 1€) y ajusta tras 2–3 semanas.

• Define estados de pedido que encajen con tu realidad (no con “lo típico”).

• Asegúrate de tener clara la política de devoluciones: revocación automática.

Problemas típicos y solución rápida

No se suman puntos

• Revisa el Token y el Subdominio

• Revisa que el pedido llegue al estado de éxito configurado

No aparece el canje en el checkout

• Revisa “Compra mínima”

• Revisa conversión “Canjear puntos a euros”

• Verifica que el cliente realmente tenga puntos en Omniwallet

Se suman puntos pero no se revocan

• Revisa el Estado de revocación

• Comprueba que el pedido llega realmente a ese estado