Domiciliación bancaria SEPA con mandato online: documentación del módulo PrestaShop
Instalar, configurar y usar el módulo de adeudo directo SEPA: mandato firmado en línea con prueba sellada, fichero pain.008 validado, calendarios, rechazos y RGPD.
Presentación
El módulo dfsepadebit añade el adeudo directo SEPA como medio de pago en PrestaShop 1.7.8, 8 y 9. El cliente firma un mandato en línea durante la compra, con un código recibido por correo, sin salir de la página de pago. Cada pedido, cada vencimiento de un calendario y cada adeudo puntual se convierte en un cobro notificado previamente al cliente. Usted genera el fichero pain.008 y lo sube a la banca en línea de su banco. Después importa los ficheros de respuesta para actualizar los pagos y los rechazos.
El módulo no se conecta a su banco y no envía ningún dato a terceros: los fondos llegan directamente a su cuenta.

Novedades de la 2.0.0: firma en línea corregida (fallaba en la 1.1.0 con PrestaShop 8 y 9), compatibilidad con PrestaShop 1.7.8, mandatos únicos (OOFF), secuencia FNAL, pain.008.001.08 por defecto, validación de cada fichero con el esquema oficial ISO 20022, PDF del mandato sellado y registro de auditoría encadenado, ficheros bancarios cifrados y nunca enviados por correo, permisos por perfil de empleado, asistente de puesta en marcha y configuración en 5 pestañas.
Requisitos
- Identificador de acreedor SEPA y contrato de emisión de adeudos directos SEPA, que se solicitan a su banco. Indique el esquema B2B si cobra a empresas.
- El formato de fichero que acepta su banco (pain.008.001.08 o pain.008.001.02) y su plazo de presentación (normalmente 1 día hábil TARGET antes de la fecha de cobro).
- Una tienda con el euro activado: el medio de pago solo aparece en carritos en euros.
- PrestaShop 1.7.8 a 9.x, PHP 7.1 a 8.5 con la extensión OpenSSL (cifrado AES-256-GCM de los IBAN y de los ficheros).
- Una tarea cron diaria (alojamiento o servicio externo) para los calendarios, los ficheros automáticos y las confirmaciones de pago.
Instalación y actualización
- En Módulos > Gestor de módulos, haga clic en Subir un módulo y seleccione
dfsepadebit-2.0.0.zip. - El módulo crea sus tablas, dos estados de pedido («Adeudo directo SEPA programado» y «Adeudo directo SEPA rechazado») y el menú Vender > Adeudo directo SEPA: Panel, Mandatos, Cobros, Calendarios recurrentes y Ficheros bancarios.
- Abra la configuración. El asistente de puesta en marcha de la parte superior indica lo que falta: nombre y dirección completa del acreedor, identificador de acreedor, IBAN, euro activado, tarea diaria y primer fichero aceptado por su banco. Mientras el acreedor no esté completo, el medio de pago permanece oculto.
- Copie la URL de cron que aparece en la configuración y prográmela una vez al día. El botón Nueva URL de cron genera otra e invalida la anterior.

Actualización desde la 1.1.0: suba el nuevo ZIP sobre el anterior. Se conservan los mandatos, cobros, calendarios, ficheros bancarios y ajustes, incluido el formato pain.008.001.02 si lo había elegido. La actualización recalcula las huellas de los IBAN, cifra los ficheros ya generados, abre el registro de auditoría de cada mandato y renombra los estados de pedido que conservaban su nombre original. Los mandatos firmados con la 1.1.0 no tienen PDF sellado: su PDF se regenera a partir de la prueba original, con la mención «copia regenerada».
Configuración
La configuración se reparte en 5 pestañas.
Acreedor
Nombre del acreedor (tal como aparecerá en los extractos de sus clientes), identificador de acreedor, IBAN de la cuenta de abono, BIC (opcional en el EEE) y dirección completa: calle, código postal, ciudad y país son obligatorios porque figuran en el mandato. El identificador se comprueba con su clave (MOD 97-10) y el IBAN con su clave y la longitud de su país.
Mandatos y proceso de compra
- Esquema de los nuevos mandatos: SEPA B2B (entre empresas, sin derecho a reembolso, el deudor debe registrar el mandato en su banco) o SEPA Core (cualquier cliente, reembolso posible durante 8 semanas).
- Tipo de pago de los mandatos firmados en línea: recurrente (el cliente firma una vez y el mandato sirve para los pedidos y calendarios siguientes) o único (un mandato por pedido, válido para un solo adeudo).
- 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: recomendada, refuerza el expediente de prueba. Si se desactiva, el cliente firma con una simple casilla.
- Adjuntar el PDF del mandato al correo de confirmación: la copia adjunta muestra el IBAN parcialmente oculto. La copia completa sigue disponible en la cuenta del cliente.
- Solo para clientes con nombre de empresa: el medio 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 medio de pago se oculta para ese cliente.
- Ocultar tras rechazos en los últimos 12 meses: 2 por defecto, 0 para desactivar.
Cobros y ficheros bancarios
- Plazo de notificación previa: los rulebooks fijan 14 días naturales, salvo otro plazo acordado con el deudor. El módulo propone 2 días: un plazo inferior a 14 días debe figurar en sus condiciones de venta. El plazo se recoge en el texto del mandato. Un pedido se cobra al final de este plazo.
- Plazo de presentación de su banco, en días hábiles TARGET.
- Formato del fichero: pain.008.001.08 por defecto (versión 2019 de ISO 20022, utilizada por las guías de implementación del EPC vigentes). Mantenga pain.008.001.02 solo si su banco todavía lo pide.
- Apunte agrupado: un único abono por fichero en su extracto, o un abono por cobro.
- Enviar el primer adeudo de un mandato como FRST: el rulebook admite RCUR desde el primer adeudo; mantenga FRST si su banco todavía lo exige.
- Enviar el último adeudo de un calendario limitado como FNAL: opcional. Tras un adeudo FNAL, el mandato se cierra y ya no puede usarse.
- Incluir siempre la dirección del deudor en el fichero: la dirección se envía siempre para las cuentas fuera del EEE; active la opción si su banco la pide en cada adeudo.
- Generar el fichero bancario automáticamente: la tarea diaria crea el fichero de los cobros que vencen en N días y envía un aviso a la dirección de alertas. El fichero en sí nunca se envía por correo: se descarga en el back office.
- Marcar como pagado automáticamente tras N días sin rechazo (5 por defecto). 0 para confirmar a mano o con un camt.054.
Rechazos
- Códigos de motivo con nuevo intento automático: AM04 y MS03 por defecto.
- Número máximo de nuevos intentos y plazo antes de un nuevo intento.
- Gastos de rechazo añadidos al nuevo intento, solo si sus condiciones de venta lo prevén.
- Códigos de motivo que revocan el mandato: AC01, AC04, AC06, AC13, MD01 y MD07 por defecto. El mandato se cierra y sus calendarios se cancelan.
- Email para las alertas del comerciante: rechazos, revocaciones, cambios de banco, calendarios suspendidos y ficheros automáticos. Si se deja vacío, el email de la tienda.
Datos y privacidad
- Conservar los mandatos cerrados tras el último adeudo: 13 meses como mínimo (véase RGPD más abajo).
- Eliminar todos los datos al desinstalar: desactivado por defecto. Los mandatos son pruebas; eliminarlos puede incumplir sus obligaciones de conservación.
Recorrido del cliente
Firma en el proceso de compra
En el paso de pago, el cliente elige el adeudo directo SEPA. El bloque muestra el importe y la fecha de cargo. Si ya tiene un mandato activo, selecciona su cuenta (IBAN oculto) y confirma el pedido.
Si no, firma un nuevo mandato en 3 pasos dentro del bloque de pago. El formulario se rellena con la dirección de facturación: empresa, titular, dirección, lugar de firma (la ciudad), IBAN y BIC. El IBAN se formatea y se comprueba mientras se escribe: longitud del país, clave y BIC obligatorio fuera del EEE. El cliente lee el texto del mandato (desplegable) y marca la aceptación. En B2B, también confirma que la cuenta es profesional y que registrará el mandato en su banco.

Recibe por correo un código de 6 cifras válido durante 10 minutos. Puede pedir un nuevo código tras 45 segundos; tras 5 errores, debe pedir otro. El mandato queda firmado en cuanto se introduce el código correcto. Hasta entonces, la confirmación del pedido se bloquea con un mensaje.


La página de confirmación recuerda el importe, la fecha de cargo, el IBAN oculto, la referencia del mandato y el identificador de acreedor.

Si el tema impide que se ejecute el script, tras confirmar se redirige al cliente a la página de firma independiente y después se crea el pedido. No se puede crear dos veces un pedido para el mismo carrito, y el importe siempre se recalcula en el servidor a partir del carrito.
Correo de confirmación y PDF del mandato
El cliente recibe la confirmación de su mandato con el IBAN oculto y un enlace a sus mandatos. Si la opción está activada, la copia PDF adjunta también lleva el IBAN oculto.

El PDF incluye las menciones del mandato SEPA: título «SEPA Business to Business Direct Debit Mandate» en B2B o «SEPA Direct Debit Mandate» en Core, referencia única, identificador y dirección del acreedor, deudor, cuenta, tipo de pago (recurrente o único), texto de autorización, lugar y fecha de firma, método de firma y huella SHA-256.

Página de firma independiente
Cuando envía una solicitud de firma desde el back office, el cliente recibe un enlace seguro a una página de firma, sin necesidad de iniciar sesión. Muestra el resumen del acreedor y los mismos controles que en el proceso de compra.

Cuenta del cliente
La página Mis mandatos SEPA presenta cada mandato en una tarjeta: PDF, calendarios en curso y últimos cobros. El cliente puede revocar un mandato o hacer clic en 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 enlace solo aparece en Mi cuenta para los clientes de los grupos autorizados o que ya tienen un mandato. El detalle de cada pedido muestra la fecha de cargo 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 rechazo 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). Los últimos rechazos y los mandatos pendientes de firma, con un botón Recordar, completan la página. Aparece una alerta si la tarea diaria no se ha ejecutado en 36 horas.

Mandatos
La lista muestra la referencia, el deudor, el IBAN oculto, el esquema (B2B o Core), el tipo (recurrente o único) y el estado. El botón Nuevo mandato ofrece dos modos: enviar al cliente una solicitud de firma en línea o registrar un mandato en papel ya firmado, con su lugar y fecha de firma. El campo Sustituye al mandato transfiere los calendarios de un mandato existente cuando se firma el nuevo.

La ficha de un mandato muestra las pruebas de firma (fecha, método, lugar, dirección IP, navegador, huella de la prueba), el PDF sellado con su SHA-256, los calendarios, los cobros y el registro de auditoría cronológico con su control de integridad. El botón Mostrar el IBAN completo exige el permiso de modificación y cada visualización queda registrada. La ficha de cliente del back office muestra también un bloque Mandatos SEPA con un botón para solicitar un nuevo mandato.

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 un rechazo con su código, cancelar (antes de exportar). Tras un rechazo con un código de nuevo intento, la ficha muestra el nuevo intento programado y el historial. El botón Nuevo cobro puntual crea un cobro sobre un mandato activo, vinculado o no a un pedido. Se rechaza un importe nulo, y un mandato único solo admite un cobro.

Calendarios recurrentes
Un calendario se vincula a un mandato recurrente (activo o pendiente de firma) y funciona en dos modos: 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 cobra). Elija la frecuencia, el próximo vencimiento y el número de cobros (0 para sin fin). El cliente recibe un correo de resumen. Un calendario puede suspenderse, reanudarse o detenerse.
Ficheros bancarios
- Elija la fecha límite de los cobros que se incluirán y haga clic en Vista previa: no se exporta nada. La vista previa muestra un bloque de pago por esquema, secuencia (FRST, RCUR, OOFF, FNAL) y fecha, y las fechas adelantadas para respetar el plazo de su banco.
- Haga clic en Generar. El fichero se valida con el esquema oficial ISO 20022 antes de guardarse y después se almacena cifrado con su huella SHA-256. La lista indica el resultado de la validación y el número de descargas.
- Descargue el fichero y súbalo el mismo día a la banca en línea de su banco. El módulo nunca envía nada a un banco.
- Importe después los ficheros de respuesta: pain.002 (rechazo del fichero o de operaciones), camt.054 o camt.053 (devoluciones y abonos). Un mismo fichero importado dos veces no se vuelve a procesar.

Un fichero aún no enviado puede cancelarse: sus cobros vuelven a «por exportar». La generación está bloqueada: dos clics, dos empleados o una tarea diaria simultánea no pueden exportar dos veces los mismos cobros.
Página del pedido
La página del pedido del back office muestra un bloque de adeudo SEPA: mandato, IBAN oculto, importe, vencimiento y estado de cada cobro.

Ciclo de un cobro
- Por exportar: creado con el pedido, por un calendario o a mano. El cliente recibe la notificación previa. El pedido está en «Adeudo directo SEPA programado».
- Enviado al banco: incluido en un fichero. La fecha puede trasladarse al primer día posible según el calendario TARGET y el plazo de presentación.
- Pagado: tras el plazo sin rechazo, al importar un camt.054 o a mano. El pedido pasa a «Pago aceptado».
- Rechazado: código de motivo registrado, pedido en «Adeudo directo SEPA rechazado», nuevo intento o revocación según la configuración.
Secuencias
- FRST: primer adeudo de un mandato recurrente, si la opción está activada. Un solo primer adeudo por mandato y por fichero; si se rechaza, el siguiente intento vuelve a salir como FRST.
- RCUR: adeudos siguientes de un mandato recurrente.
- OOFF: adeudo único de un mandato único. Un nuevo intento tras un rechazo se trata como el mismo pago; si es necesario, confirme esta práctica con su banco.
- FNAL: último adeudo de un calendario limitado, si la opción está activada. El mandato se cierra tras el pago.
Un mandato que no se ha utilizado para ningún cobro durante 36 meses caduca.
Gestión de los rechazos
| Código | Significado | Acción por defecto |
|---|---|---|
| AM04 | Fondos insuficientes | Nuevo intento |
| MS03 | Motivo no especificado por el banco | Nuevo intento |
| AC01, AC04, AC06 | Cuenta incorrecta, cerrada o bloqueada | Revocación del mandato |
| AC13 | Cuenta de consumidor en B2B | Revocación del mandato |
| MD01 | Sin mandato válido (a menudo un mandato B2B no registrado en el banco) | Revocación del mandato |
| MD07 | Deudor fallecido | Revocación del mandato |
| MS02, MD06 | Rechazo o reembolso solicitado por el deudor | Alerta, gestión manual |
Un rechazo del fichero o de un bloque de pago en un pain.002 (formato, identificador de acreedor no reconocido…) no afecta al cliente: los cobros vuelven a «por exportar» para el siguiente fichero.
Prueba de firma y registro de auditoría
- Instantánea de prueba: en el momento de la firma, el módulo registra una instantánea con fecha y hora que contiene el texto exacto del mandato y su huella, el esquema, el tipo de pago, el lugar, la dirección IP, el navegador, el método de firma, el IBAN oculto y su huella. El IBAN completo nunca figura en ella.
- PDF sellado: el PDF del mandato se genera una sola vez, en la firma, y se almacena cifrado. Su SHA-256 se registra en el mandato y en el registro de auditoría; las descargas posteriores devuelven exactamente ese fichero.
- Registro de auditoría: creación, envío y errores de código, firma, PDF sellado, correos, visualizaciones del IBAN completo, descargas, cobros, exportaciones, pagos, rechazos, revocación y anonimización. Los eventos de cada mandato se encadenan con SHA-256: una línea modificada o eliminada se señala en la ficha del mandato.
El código de un solo uso enviado por correo es una firma electrónica en el sentido del artículo 3, punto 10, del Reglamento eIDAS (UE) n.º 910/2014; no es una firma cualificada. El módulo no garantiza ningún valor jurídico concreto: su valor probatorio y su aceptación por su banco quedan a su criterio y al de sus asesores.
Seguridad y permisos de los empleados
- IBAN de los mandatos y ficheros bancarios cifrados con AES-256-GCM, con una clave derivada de la clave secreta de la tienda (fichero de parámetros, no la base de datos). Conserve este fichero si migra la tienda: sin él, los IBAN y los ficheros ya no se pueden leer.
- Los duplicados se detectan con una huella HMAC-SHA256, nunca con el IBAN en claro.
- Descargar un fichero bancario o el PDF completo, mostrar el IBAN completo, reenviar un enlace de firma o ejecutar las tareas exige el permiso de modificación en la pestaña correspondiente. Un perfil de solo lectura obtiene una copia del PDF con el IBAN oculto y no puede descargar ficheros bancarios.
- En multitienda, un empleado solo ve los mandatos, cobros, calendarios y ficheros de las tiendas de su contexto.
- En la tienda, un mandato solo es accesible para su titular, en su tienda, con un token contra la falsificación de solicitudes en la revocación y en el PDF.
- Los ficheros de respuesta importados se leen sin entidades externas (protección XXE).
Tarea diaria (cron)
La URL de 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 rechazo tras el plazo configurado, deja caducados los mandatos sin uso desde hace 36 meses y elimina las firmas abandonadas desde hace 60 días. Dos ejecuciones simultáneas no pueden solaparse. El botón Ejecutar las tareas ahora de la página Ficheros bancarios hace lo mismo para la tienda actual.
Correos enviados
- Al cliente: código de firma, confirmación del mandato, solicitud de firma, aviso de calendario, notificación previa del cobro, rechazo.
- Al comerciante: rechazo, revocación por el cliente, cambio de banco, calendario suspendido, fichero automático listo (con el enlace al back office, sin fichero adjunto).
Las 8 plantillas se entregan en 8 idiomas, en HTML y texto, en mails/, y se editan como los correos nativos. Ningún correo contiene un IBAN completo ni un fichero bancario.
Factura, ficha del pedido y RGPD
La factura PDF incluye una mención de notificación previa (importe, fecha, IBAN oculto, referencia del mandato, identificador de acreedor), que pasa a «pagado el» cuando se confirma el cobro.
Con el módulo RGPD oficial, los mandatos (IBAN oculto) y los cobros se incluyen en la exportación de datos. Ante una solicitud de supresión, solo se anonimizan los mandatos pendientes y los mandatos cerrados cuyo último adeudo supera el plazo de conservación configurado: se eliminan entonces el IBAN, el email, la dirección y el PDF sellado. Los demás mandatos se conservan como prueba y usted recibe una alerta.
Plazo de conservación: los rulebooks del EPC remiten al derecho nacional e imponen como mínimo el periodo de reembolso de una operación no autorizada, es decir, 13 meses tras la fecha de cargo. El derecho nacional, en particular el contable, puede exigir más: fíjelo con sus asesores. El módulo no fija ningún plazo nacional y rechaza un valor inferior a 13 meses.
Límites
- El módulo genera ficheros pain.008 y lee ficheros pain.002, camt.054 y camt.053. No transmite nada a un banco ni ofrece conexión EBICS o proveedor de pagos.
- No garantiza la conformidad legal de su uso: compruebe con su banco el formato, los plazos, el BIC, la dirección y el uso de FRST, y con sus asesores sus condiciones de venta, el plazo de notificación previa y el plazo de conservación.
- Solo se tienen en cuenta los festivos TARGET comunes: 1 de enero, Viernes Santo, Lunes de Pascua, 1 de mayo, 25 y 26 de diciembre.
- Los países añadidos recientemente por el EPC (Albania, Moldavia, Montenegro, Macedonia del Norte, Serbia) se aceptan con BIC obligatorio; no se comprueba la participación efectiva de cada banco.
Solución de problemas
El medio de pago no aparece
Compruebe el asistente de puesta en marcha (acreedor completo con su dirección), que el carrito está en euros, que el cliente ha iniciado sesión (no es invitado), que la dirección de facturación tiene una empresa si la opción está activada, que el cliente pertenece a un grupo autorizado y que no ha superado el riesgo o el número de rechazos permitidos.
Rechazo MD01 en un mandato B2B
El cliente no ha registrado el mandato en su banco. Pídale que lo haga con la referencia del mandato y su identificador de acreedor, y cree después un nuevo cobro puntual.
El cliente no recibe el código
Compruebe la configuración de correo de PrestaShop y la carpeta de spam del cliente. Puede pedirse un nuevo código tras 45 segundos; es válido durante 10 minutos.
El banco rechaza el fichero
Compruebe el formato esperado (pain.008.001.08 o .02), el BIC y la dirección del deudor. Un fichero que no cumple el esquema ISO 20022 nunca se guarda: el mensaje mostrado al generarlo cita los primeros errores. Si la columna del esquema indica «No verificado», faltan las extensiones PHP DOM o libxml en el servidor.
«Registro de auditoría alterado»
Una línea del registro de auditoría del mandato se ha modificado o eliminado directamente en la base de datos. El mensaje indica el evento a partir del cual la cadena ya no está intacta. Restaure la tabla desde una copia de seguridad.