PagaFactu: Funcionalidades

Gestión de cobros de facturas mediante Open Banking (PSD2), flujo síncrono con URL de cobro y documento asociado.

PagaFactu es el producto de Zertiban para la gestión de cobros de facturas mediante Open Banking (PSD2). Permite generar un flujo de cobro a partir de una factura y obtener, de forma síncrona, los recursos necesarios para su ejecución: URL de cobro y documento asociado en distintos formatos.

Está diseñado para integrarse directamente con ERPs o sistemas de facturación, simplificando la generación del cobro y la experiencia del cliente final.

Para los conceptos comunes de flujos y operaciones, estructura, estados y transiciones, consulta Flujos y operaciones.

Opciones de integración

PagaFactu ofrece tres opciones de integración en función del nivel de control sobre la generación del cobro y la experiencia documental del cliente final:

Opción	Descripción
Solo URL de cobro	Se devuelve únicamente el enlace que el cliente final utilizará para completar la transferencia
URL + PDF con QR generado por Zertiban	Se devuelve la URL de cobro junto con un PDF generado automáticamente por Zertiban que incluye los datos de la transferencia y un código QR al enlace de cobro
URL + PDF con página añadida	El cliente envía su propia factura en PDF y Zertiban devuelve la URL de cobro junto con el mismo documento enriquecido, añadiendo una única página adicional al final con el QR y el enlace

Funcionalidades de PagaFactu

Funcionalidad	Descripción
Cobro inmediato	Transferencias SEPA estándar (D+1) o instantáneas (SCT Inst en segundos)
Cobro programado	Tipo FUTURE_PAYMENT con requestedExecutionDate (mínimo 1 día hábil de antelación)
Generación de PDF con QR	Activando generateDocument: true, Zertiban devuelve el PDF en base64 en la respuesta
Enriquecimiento mediante página añadida	Se añade una única página adicional al final del documento del cliente, que incluye el QR de cobro y el enlace directo
Control de expiración	Configurable entre 1 y 156 días mediante expirationOffset
Cancelación de operaciones	PUT/flow/v1/operations/{operationUuid}/cancel disponible en estados CREATED u OPENED (si no hay transacciones en curso)
Reconciliación por externalId	El identificador de negocio (ej. número de factura) viaja en todo el flujo y en los eventos webhook

Flujo funcional de PagaFactu

1. ERP: Creación del flujo

El sistema del cliente realiza una única llamada síncrona a la API:

POST /pagafactu/v1/flows/pagafactu

En esta llamada se envía:

• datos de la factura,
• importe,
• datos del deudor,
• y opcionalmente el PDF de la factura si se utiliza la opción de documento con página añadida.

Zertiban responde de forma inmediata con:

• URL de cobro lista para uso,
• PDF con página añadida (si aplica),
• identificadores de flujo y operación.

2. ERP: Distribución del cobro

Zertiban no envía comunicaciones al cliente final. El ERP es responsable de la entrega del enlace de cobro mediante los canales que considere:

• Email
• WhatsApp
• SMS
• Integración en factura o portal del cliente

En este punto, el ERP puede enviar directamente:

• la URL de cobro, o
• el documento generado por Zertiban.

La página añadida es la misma en todos los casos, ya que se genera una única vez en la creación del flujo y forma parte del documento devuelto, incluyendo el QR y el enlace de cobro.

3. Cliente final: Acceso al flujo

El cliente final accede al flujo de dos formas equivalentes:

• Abriendo la URL de cobro directamente desde su navegador, o
• Escaneando el QR incluido en la página añadida del documento.

En ambos casos accede a la misma experiencia de cobro alojada por Zertiban. Una vez dentro:

• selecciona su banco,
• inicia el proceso de cobro,
• la operación pasa a estado OPENED.

CREATED → OPENED

4. Banco: Autenticación y autorización (PSD2)

El cliente es redirigido a su banca online para completar la Autenticación Reforzada de Cliente (SCA). Durante este proceso:

• revisa los detalles del cobro,
• autoriza la transferencia,
• confirma la operación desde su entidad bancaria.

5. Zertiban: Confirmación del cobro

Una vez el banco confirma la operación, la operación pasa a estado COMPLETED y Zertiban emite el webhook correspondiente:

{
  "eventType": "OPERATION_COMPLETED",
  "resource": {
    "externalId": "INV-2026-001",
    "status": "COMPLETED"
  }
}

6. ERP: Conciliación automática

El ERP recibe el webhook y utiliza resource.externalId para:

• localizar la factura,
• marcarla como cobrada,
• ejecutar procesos contables o de negocio.

Comportamiento síncrono del sistema

La creación del flujo en PagaFactu es completamente síncrona:

• la URL de cobro se devuelve en la misma respuesta del API,
• el documento con página añadida (si aplica) se devuelve en la misma respuesta,
• no existen callbacks asíncronos durante la fase de creación.

Responsabilidad de entrega

Zertiban no realiza la comunicación con el cliente final. El sistema del cliente es responsable de:

• generar y distribuir el enlace de cobro o el documento,
• elegir el canal de comunicación,
• gestionar la experiencia de notificación.

Zertiban actúa como motor de generación del flujo de cobro y ejecución bancaria.

Siguientes pasos

• Cómo empezar: Onboarding, post-onboarding y los 6 valores de configuración
• Flujos y operaciones: Conceptos comunes, estructura, estados y transiciones
• Webhooks: Recibe notificaciones en tiempo real
• ZertiPay: Pagos pay by bank con múltiples operaciones o destinatarios
• Entornos: Sandbox y producción