MaxRedsys: guía de cobro con tarjeta (Redsys)

Guía de uso de MaxRedsys

MaxRedsys (antes PagoRecibosRedsys) permite cobrar facturas, presupuestos, pedidos y albaranes de cliente con tarjeta a través de Redsys, usando la redirección oficial con 3D Secure / SCA real. Genera enlaces de pago que puedes enviar por email, confirma el cobro tanto por la notificación servidor-a-servidor como por el retorno firmado, y marca los recibos como pagados. Incluye además una gestión propia de anticipos de cliente (que se convierten en recibos) y, si tienes el plugin PortalCliente, permite que el cliente pague sus facturas pendientes desde su portal. Está pensado para cualquier empresa que quiera ofrecer pago con tarjeta seguro y automatizado.

1. Instalación

Descarga el ZIP de MaxRedsys.
En FacturaScripts, ve a Administrador → Plugins, pulsa Añadir y sube el ZIP.
Actívalo y pulsa Reconstruir.

Requisitos: FacturaScripts 2025 o superior y PHP 8.1+. Es compatible con PortalCliente: si lo tienes instalado, MaxRedsys se registra automáticamente como pasarela de pago del portal.

2. Configuración de Redsys

Ruta: Administrador → Panel de control, pestaña Redsys / TPV.

Necesitas los datos que te facilita tu banco al contratar el TPV virtual de Redsys. La pantalla separa dos juegos de credenciales para que puedas probar sin tocar las reales:

En el grupo principal elige el Entorno activo: Pruebas (sandbox) o Producción (real). El entorno seleccionado decide qué grupo de credenciales se utiliza.
En Credenciales de pruebas (sandbox) y en Credenciales de producción (real) introduce, para cada entorno:
- FUC (código de comercio): el código FUC que te facilita tu banco.
- Terminal: el número de terminal Redsys (normalmente 1).
- Clave secreta SHA-256: la clave de firma del comercio.
Pulsa Guardar. Prueba primero en sandbox y, cuando todo funcione, cambia el entorno a Producción.

3. Cobrar un documento con tarjeta

MaxRedsys añade un botón Cobrar con tarjeta en los listados de Facturas de cliente, Presupuestos de cliente, Pedidos de cliente y Albaranes de cliente, y en las fichas de Factura de cliente y Presupuesto de cliente.

Ve, por ejemplo, a Ventas → Facturas de cliente (o abre la ficha del documento).
Selecciona el documento y pulsa Cobrar con tarjeta. Se genera un cobro Redsys con su enlace de pago, incluyendo empresa y concepto.
Opcionalmente pulsa Aplicar anticipo para descontar un anticipo previo del cliente antes de cobrar el resto con tarjeta.
Cuando el cliente paga (pantalla "Pago seguro" de Redsys), el cobro se confirma por dos vías (notificación servidor-a-servidor y retorno firmado) y el recibo del documento queda marcado como pagado automáticamente.

4. Enviar el enlace de pago por email

Ruta de menú: Ventas → Cobros y anticipos Redsys, pestaña Cobros Redsys.

Marca uno o varios cobros pendientes en la lista.
Pulsa Enviar enlace por email. El cliente recibe un correo con el importe pendiente y un enlace seguro para pagar con tarjeta. (Si el cliente no tiene email, el sistema lo avisa y omite ese cobro.)

En esta misma pantalla puedes filtrar por Estado (pendiente, pagado, error) y buscar por nº de pedido, cliente, documentos o token.

5. Devoluciones

Desde Ventas → Cobros y anticipos Redsys:

En la pestaña Cobros Redsys, marca los cobros a reembolsar y pulsa Devolución total; se pide confirmación y se solicita a Redsys la devolución del importe pendiente.
Para devoluciones parciales, abre la ficha del Cobro e indica el Importe a devolver; el campo Devuelto refleja lo ya reembolsado.
Las devoluciones quedan registradas en el apartado Devoluciones.

6. Anticipos de cliente

Ruta de menú: Ventas → Cobros y anticipos Redsys, pestaña Anticipos Redsys.

Aquí se listan los anticipos con su saldo disponible. Puedes filtrar los agotados.
Un anticipo cobrado se convierte en recibo y su saldo puede aplicarse a documentos futuros con el botón Aplicar anticipo (paso 3 del apartado 3).
También puedes hacer una Devolución total del saldo de un anticipo desde el botón correspondiente.

7. Pago desde el Portal del Cliente (si aplica)

Si tienes instalado PortalCliente, MaxRedsys se registra como pasarela automáticamente. El cliente entra en su portal, ve sus facturas pendientes y las paga con tarjeta mediante Redsys, con la misma confirmación segura. No requiere configuración adicional más allá de las credenciales del apartado 2.

Preguntas frecuentes

No veo el menú del plugin. Ve a Administrador → Plugins y pulsa Reconstruir; después recarga la página.
No aparece el botón "Cobrar con tarjeta". Solo se muestra en los listados y fichas de ventas (facturas, presupuestos, pedidos y albaranes de cliente). Reconstruye el plugin y recarga la página.
El pago se realiza pero la factura no se marca como pagada. Redsys debe poder llamar a la URL de tu FacturaScripts; asegúrate de que la instalación es accesible desde Internet por HTTPS y de que las credenciales (FUC, Terminal, Clave SHA-256) del entorno activo son correctas.
¿Cómo hago una prueba sin cobrar de verdad? Pon el Entorno activo en Pruebas (sandbox) y usa las credenciales de sandbox de Redsys.
El cobro se queda en estado "error". Revisa las credenciales del entorno activo y que hayas seleccionado el entorno correcto (pruebas/producción).

Soporte: soporte@adelantia.com