Monedero de Cliente y Saldo a Favor para PrestaShop 8 y 9

Presentación

DataFirefly Monedero de cliente añade a PrestaShop 8 y 9 un saldo por cliente. En él abonas reembolsos, facturas por abono y gestos comerciales; el cliente lo gasta en el paso de pago de sus siguientes pedidos y puede recargarlo. El saldo se trata como un medio de pago: un pedido pagado en parte con el monedero conserva su total, su factura y su base de IVA, y la parte del monedero aparece como una línea de pago.

Instalación

1. En Módulos > Gestor de módulos, haz clic en Subir un módulo y suelta dfwallet-1.1.1.zip.
2. Al instalarse, el módulo crea sus tablas, una pestaña Clientes > Monederos, un producto virtual oculto DFWALLET-TOPUP usado para las recargas, y se coloca en primer lugar entre los medios de pago.
3. En Pago > Preferencias, comprueba que el módulo está permitido para tus monedas, países y grupos de clientes.

Para actualizar, sube el nuevo ZIP: los saldos, el historial y los ajustes se conservan, y los scripts de actualización añaden las nuevas columnas.

Configuración

Pago

• Permitir el uso parcial en el pago: si el saldo no cubre todo el pedido, el cliente puede aplicarlo y pagar el resto con otro medio de pago.
• Estado del pedido cuando el monedero paga todo el pedido: Pago aceptado por defecto.

Recarga por el cliente

• Importes sugeridos: separados por comas, en la moneda por defecto. Ejemplo: 20,50,100.
• Importe libre, con recarga mínima y máxima.
• Bono de recarga: tramos con el formato importe:bono. Con 50:5,100:15, una recarga de 100 € abona 115 €. El bono se abona al pagar la recarga y se retira si el pedido se cancela o se reembolsa.

La recarga se vende sin IVA, porque es un prepago. El saldo solo se abona cuando el pedido de recarga pasa a un estado pagado.

Reembolsos y cancelaciones

• Devolver la parte del monedero cuando se cancela un pedido y cuando pasa a Reembolsado.
• Abonar automáticamente cada nueva factura por abono en el monedero: desactivado por defecto. Déjalo desactivado si también reembolsas por transferencia o con vales nativos; las facturas por abono se abonan entonces una a una desde la página del pedido.

Los abonos ligados a un pedido (devoluciones y reembolsos) tienen como tope su importe: activar la devolución automática y abonar la factura por abono del mismo pedido nunca abona dos veces.

Caducidad de los gestos comerciales

• Validez en meses, 0 para que no caduquen. Se aplica a los gestos comerciales, los ajustes a favor y los bonos de recarga. Los reembolsos, los pagos devueltos y las recargas no caducan nunca.
• Email de recordatorio antes de la caducidad: días antes de la fecha, 0 para no enviarlo.

Un pago siempre gasta primero los importes que caducan antes.

Tarea cron

La URL que aparece en la parte superior de la configuración, protegida por un token, caduca los abonos vencidos y envía los recordatorios. Llámala una vez al día:

0 6 * * * curl -s "https://tu-tienda.es/module/dfwallet/cron?token=TU_TOKEN" > /dev/null

Sin cron, el mismo proceso se ejecuta como máximo una vez por hora al abrir la lista de monederos, y los abonos caducados de un cliente se procesan en cuanto se muestra su monedero.

Abonar un monedero

Desde la página del pedido

El panel Monedero del cliente muestra el saldo, los movimientos ligados al pedido, un botón Abonar en el monedero para cada factura por abono y un formulario de abono (gesto comercial, reembolso, ajuste). Si el pedido se pagó en parte con el monedero, un botón permite devolver ese pago.

Desde la ficha del cliente y la lista

La ficha del cliente muestra el saldo y un formulario de abono o cargo. Clientes > Monederos lista todos los monederos, con un abono rápido por email y una ficha detallada por cliente.

Para cada movimiento puedes indicar un mensaje mostrado al cliente, una nota interna, una fecha de validez para los gestos comerciales, y elegir avisar al cliente por email.

Abonos masivos por CSV

El bloque Gestos comerciales masivos acepta un archivo CSV, un cliente por línea:

email;amount;message;valid_until
jane@example.com;10;Perdona el retraso en la entrega;2027-06-30

El mensaje y la fecha son opcionales; las fechas pueden ser AAAA-MM-DD o DD/MM/AAAA, y los importes admiten coma o punto. Un mensaje y una validez por defecto se aplican a las líneas que no los tienen. Cada línea tiene su clave antiduplicados: enviar dos veces el mismo archivo no abona dos veces a nadie. Un informe indica las líneas abonadas, ya importadas y con error.

Lado del cliente

• Mi cuenta > Mi monedero: saldo, importes que caducan pronto, recarga e historial paginado con enlace a los pedidos.
• Página del carrito: recordatorio del saldo disponible.
• Paso de pago: si el saldo cubre el pedido, se ofrece primero Pagar con mi monedero. Si no, el botón Usar mi saldo muestra el importe descontado y lo que queda por pagar, y el cliente elige otro medio de pago.
• Confirmación del pedido: recordatorio de la parte pagada con el monedero y del importe pendiente.

El saldo aplicado al carrito aparece en el resumen como una línea Monedero. Si el cliente la elimina con el icono de papelera, el saldo deja de usarse en ese carrito.

Contabilidad

Al validar, el saldo usado se registra como un pago del pedido. El total de productos, el IVA y la factura no cambian. Para pagos por transferencia o cheque, las instrucciones enviadas al cliente indican el importe realmente debido.

La lista de monederos muestra el saldo pendiente total por moneda: es una deuda con tus clientes mientras no se gaste. El bloque Exportar movimientos genera un CSV (UTF-8, separado por punto y coma) con una línea por movimiento: fecha, cliente, operación, importe, moneda, saldo, pedido, factura por abono, validez, empleado, mensaje y nota.

Emails

Se incluyen dos plantillas en 8 idiomas en modules/dfwallet/mails/: dfwallet_credit (monedero abonado) y dfwallet_expiry (recordatorio antes de la caducidad). Se redactan en el idioma del cliente, importes y fechas incluidos. Puedes personalizarlas en Internacional > Traducciones > Traducciones de emails o sobrescribirlas en tu tema.

Desinstalación y RGPD

Los saldos y el historial se conservan al desinstalar, porque son una deuda con tus clientes. Activa Eliminar saldos e historial al desinstalar solo si quieres borrarlo todo. Los movimientos de un cliente se incluyen en la exportación de datos del módulo RGPD oficial.

Preguntas frecuentes

El cliente no ve la opción de pago con monedero

La opción solo aparece cuando el saldo cubre todo el pedido. Si no, se muestra el botón Usar mi saldo encima de los medios de pago, siempre que el uso parcial esté activado. Comprueba también que el módulo está permitido para la moneda, el país y el grupo del cliente.

El monedero no se puede usar con una recarga

Es intencionado: un carrito que contiene una recarga no puede pagarse con el monedero.

El panel no aparece en la página del pedido para un empleado

PrestaShop solo ejecuta los hooks de un módulo si el perfil del empleado tiene el permiso Ver sobre ese módulo. Añádelo en Parámetros avanzados > Equipo > Permisos.