Domiciliación bancaria SEPA con mandato online: documentación del módulo PrestaShop

Presentación

El módulo dfsepadebit añade el adeudo directo SEPA como método de pago en PrestaShop 8 y 9. El cliente firma un mandato online durante la compra con un código recibido por email. Cada pedido, cada cuota de suscripción o cada cobro puntual se convierte en un cobro notificado previamente al cliente. Usted genera el fichero pain.008 y lo sube a su banco, y después importa los ficheros de respuesta para actualizar pagos y devoluciones.

El módulo no se conecta a su banco y ningún dato pasa por terceros: los fondos llegan directamente a su cuenta.

Requisitos

• Identificador de acreedor SEPA y contrato de emisión de adeudos directos SEPA, que se solicitan al banco. Indique el esquema B2B si cobra a empresas.
• El formato de fichero que acepta su banco (pain.008.001.02 o pain.008.001.08) y su plazo de presentación (normalmente 1 día hábil TARGET antes de la fecha de cobro).
• Una tienda en EUR: el método de pago solo aparece para carritos en euros.
• PrestaShop 8.0 a 9.x, PHP con la extensión OpenSSL (cifrado AES-256-GCM de los IBAN).
• Una tarea cron diaria (panel del alojamiento o servicio externo) para los calendarios y las confirmaciones automáticas.

Instalación

1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y seleccione el ZIP dfsepadebit.
2. El módulo crea sus tablas, dos estados de pedido («En espera de adeudo directo SEPA» y «Adeudo directo SEPA rechazado») y un menú Vender > Adeudo directo SEPA.
3. Abra la configuración y complete los datos del acreedor. Mientras el nombre, el identificador y el IBAN no sean válidos, el método de pago permanece oculto.
4. Copie la URL cron que aparece arriba en la configuración y prográmela una vez al día.

Configuración

Acreedor

Nombre del acreedor (tal como aparecerá en los extractos de sus clientes), identificador de acreedor, IBAN de la cuenta abonada, BIC (opcional en el EEE) y dirección. El identificador y el IBAN se comprueban al guardar.

Mandatos y proceso de compra

• Esquema de los nuevos mandatos: SEPA B2B o SEPA Core.
• Prefijo de las referencias de mandato: letras y cifras, 8 caracteres como máximo (DF por defecto).
• Firma con un código enviado por email: recomendado. Si se desactiva, el cliente firma con una casilla.
• Solo para clientes con nombre de empresa: el método de pago solo se ofrece si la dirección de facturación incluye una empresa.
• Grupos de clientes autorizados, importes mínimo y máximo del pedido.
• Riesgo máximo por cliente: cobros aún no pagados más el carrito actual. Por encima, el método de pago se oculta para ese cliente.
• Ocultar tras devoluciones en los últimos 12 meses: 2 por defecto, 0 para desactivar.

Cobros y ficheros bancarios

• Plazo de notificación previa: el plazo legal por defecto es de 14 días. Un plazo más corto (el módulo propone 2 días) solo es válido si figura en sus condiciones de venta. Un pedido se adeuda al final de este plazo.
• Plazo de presentación de su banco, en días hábiles TARGET.
• Formato del fichero: pain.008.001.02 (el más aceptado) o pain.008.001.08.
• Apunte agrupado: un solo abono por fichero en su extracto, o un abono por cobro.
• Primer adeudo como FRST: manténgalo activado si su banco aún exige la secuencia FRST.
• Generar el fichero bancario automáticamente: la tarea diaria crea el fichero de los cobros que vencen en N días y lo envía como adjunto a la dirección de alertas.
• Marcar como pagado automáticamente tras N días sin devolución (5 por defecto). 0 para confirmar a mano o con camt.054.

Devoluciones

• Códigos de motivo con nuevo intento automático: AM04, MS03 por defecto.
• Número máximo de nuevos intentos y plazo antes de un nuevo intento.
• Gastos de devolución añadidos al importe del nuevo intento, solo si sus condiciones de venta lo prevén.
• Códigos de motivo que revocan el mandato: AC01, AC04, AC06, AC13, MD01, MD07 por defecto.
• Email para las alertas: devoluciones, revocaciones, cambios de banco, calendarios en pausa, ficheros automáticos.

Recorrido del cliente

Firma en el checkout

En el paso de pago, el cliente elige «Pagar por adeudo directo SEPA». Si ya tiene un mandato activo, selecciona su cuenta (IBAN enmascarado) y confirma el pedido. Si no, se abre un formulario en el bloque de pago, rellenado desde la dirección de facturación: empresa, titular, dirección, IBAN (comprobado al escribir) y BIC. Lee el texto del mandato, marca la casilla de aceptación y recibe un código de 6 cifras por email. El mandato queda firmado al introducir el código. Hasta entonces, la confirmación del pedido está bloqueada con un mensaje.

Cuenta del cliente

La página Mis mandatos SEPA muestra los mandatos con su PDF, los calendarios en curso y los últimos adeudos. El cliente puede revocar un mandato o pulsar Cambiar de cuenta bancaria: firma un nuevo mandato, sus calendarios y cobros aún no enviados pasan a la nueva cuenta y el mandato anterior se cierra. El detalle de cada pedido muestra la fecha de adeudo y su estado.

Back-office

Panel

Importe por enviar al banco en 7 días, importe en el banco pendiente de confirmación, cobrado en el mes, tasa de devolución a 90 días, ingresos recurrentes mensuales de los calendarios de importe fijo, mandatos activos y pendientes. Un gráfico muestra las 6 próximas semanas (cobros creados y previsión de los calendarios). Completan la página las últimas devoluciones y los mandatos pendientes de firma, con un botón Recordar. Aparece un aviso si la tarea diaria no se ha ejecutado en 36 horas.

Mandatos

El botón Nuevo mandato ofrece dos modos: enviar al cliente una solicitud de firma online (recibe un enlace seguro, sin necesidad de iniciar sesión) o registrar un mandato en papel ya firmado con su fecha de firma. El campo Sustituye al mandato traslada los calendarios de un mandato existente cuando se firma el nuevo. La ficha del mandato muestra las pruebas de firma (fecha, método, IP, navegador, huella SHA-256), el PDF, los calendarios y los cobros, y permite revocarlo.

Cobros

Lista filtrable de todos los cobros con su estado: por exportar, enviado al banco, pagado, rechazado, cancelado. Desde la ficha de un cobro: marcar como pagado, registrar una devolución con su código, cancelar (antes de exportar). El botón Nuevo cobro puntual crea un cobro sobre un mandato activo, vinculado o no a un pedido.

Calendarios recurrentes

Un calendario se vincula a un mandato (activo o pendiente de firma) y funciona de dos formas: importe fijo o repetir un pedido (el pedido de referencia se vuelve a crear a los precios del día en cada vencimiento y después se adeuda). Elija la frecuencia, el próximo vencimiento y el número de adeudos (0 para sin fin). El cliente recibe un email de resumen. Un calendario se puede pausar, reanudar o detener.

Ficheros bancarios

1. Elija la fecha límite de los cobros que se incluyen y haga clic en Generar.
2. Descargue el fichero XML y súbalo a su banco el mismo día.
3. Después importe los ficheros de respuesta del banco: pain.002 (rechazo de fichero o de operaciones), camt.054 o camt.053 (devoluciones y abonos).

Un fichero no enviado puede anularse: sus cobros vuelven a quedar por exportar.

Ciclo de un cobro

1. Por exportar: creado con el pedido, por un calendario o a mano. El cliente recibe la notificación previa.
2. Enviado al banco: incluido en un fichero. La fecha puede moverse al primer día posible del calendario TARGET2.
3. Pagado: tras el plazo sin devolución, al importar un camt.054 o manualmente. El pedido pasa a «Pago aceptado».
4. Rechazado: código R registrado, pedido en «Adeudo directo SEPA rechazado», nuevo intento o revocación según la configuración.

Gestión de devoluciones

El rechazo de un fichero o de un bloque de pago en un pain.002 (formato, identificador no reconocido…) no afecta al cliente: los cobros vuelven a quedar por exportar para el siguiente fichero.

Tarea diaria (cron)

La URL cron, protegida por un token, crea los cobros de los calendarios que vencen dentro del plazo de notificación previa, genera el fichero automático si está activado, marca como pagados los cobros sin devolución tras el plazo configurado, caduca los mandatos sin uso durante 36 meses y purga las firmas abandonadas hace 60 días. El botón Ejecutar las tareas ahora de la página Ficheros bancarios hace lo mismo para la tienda actual.

Emails enviados

• Al cliente: código de firma, confirmación del mandato con PDF, solicitud de firma, aviso de calendario, notificación previa del adeudo, devolución.
• Al comerciante: devolución, revocación por el cliente, cambio de banco, calendario en pausa, fichero automático listo (XML adjunto).

Las plantillas se entregan en 8 idiomas en mails/ y se editan como los emails nativos.

Factura, ficha de pedido y RGPD

La factura PDF lleva una mención de notificación previa (importe, fecha, IBAN enmascarado, referencia del mandato, identificador de acreedor), que pasa a «pagado el» cuando se confirma el cobro. La ficha de pedido del back-office muestra el mandato y los cobros. Con el módulo RGPD oficial, los mandatos se incluyen en la exportación de datos; al eliminar un cliente, solo se anonimizan los mandatos pendientes y los cerrados hace más de 14 meses, el resto se conserva como prueba.

Solución de problemas

El método de pago no aparece

Compruebe que el acreedor es válido (recuadro verde arriba en la configuración), que el carrito está en EUR, que el cliente ha iniciado sesión (no es invitado), que la dirección de facturación tiene empresa si la opción está activa y que el cliente no ha superado el riesgo ni el número de devoluciones permitidos.

Devolución MD01 en un mandato B2B

El cliente no ha comunicado el mandato a su banco. Pídale que lo haga con la referencia del mandato y su identificador de acreedor, y después cree un nuevo cobro puntual.

El cliente no recibe el código

Revise la configuración de emails de PrestaShop y la carpeta de spam del cliente. Se puede pedir un nuevo código tras un minuto; el código es válido 10 minutos.