Crear flujo de PagaFactu
Crea un flujo optimizado para el cobro de facturas, generando automáticamente la operación y la URL de pago. Diseñado para casos de uso de ERP donde el cobro está ligado a una factura.
Devuelve de forma síncrona, en la misma respuesta, la URL de pago para enviar al cliente y —cuando invoice.generateDocument es true— un PDF en base64 con un código QR.
Debe enviarse como multipart/form-data con una parte payload que contiene el cuerpo JSON. Para adjuntar tu propio PDF de factura, añade una segunda parte multipart cuyo nombre coincida con operations[].invoice.id; Zertiban añade una página de PagaFactu con el QR al final de ese documento. Tamaño máximo de PDF: 8 MB.
Una vez que el cliente abre la URL devuelta, elige su banco y autoriza la transferencia SEPA mediante PSD2 SCA, la operación pasa de OPENED a COMPLETED y se entrega un webhook al endpoint registrado. Concilia usando el externalId que proporcionaste.
Autorizaciones
Esquema de seguridad OAuth2
clientCredentials Flow
"/api/v2/auth/token""zertiban-api"Access to the API
Parámetros
Header Parameters
UUID del negocio (businessUuid) bajo el cual se crea el
flujo. Obligatorio en cada llamada; identifica el tenant cuya
configuración, cuentas de cobro y suscripciones de webhook
aplican a la solicitud.
"uuid"Cuerpo de la petición
PDF de factura opcional para adjuntar a la operación. El
nombre de la parte multipart (aquí invoice-file) debe
coincidir exactamente con el valor operations[].invoice.id
del payload. Cuando se adjunta y invoice.generateDocument
es true, Zertiban añade una página de PagaFactu con el QR
a la última página del PDF proporcionado. Tamaño máximo: 8 MB.
Si invoice.generateDocument es false, el archivo se
ignora de forma silenciosa y no se devuelve ningún documento.
"binary"Respuestas
Flujo de PagaFactu creado. La respuesta incluye el UUID del flujo, la
operación creada con su URL de pago y, cuando se solicita, el
PDF generado como cadena en base64.