Crear flujo

POST

/flow/v1/flows

Crea un nuevo flujo de cobro que agrupa una o varias operaciones y devuelve de inmediato las URL de pago. El punto de entrada principal para iniciar cobros de Open Banking de forma síncrona.

Debe enviarse como multipart/form-data. La parte payload contiene el cuerpo JSON y debe usar Content-Type: application/json — de lo contrario el servidor devuelve 400. Las partes adicionales suben documentos binarios (normalmente PDF) cuyos nombres de parte deben coincidir con documents[].id en el payload. La respuesta devuelve el nuevo flowUuid y, por cada operación que genera un enlace, la URL para entregar al usuario final.

Autorizaciones

OAuth2

Esquema de seguridad OAuth2

clientCredentials Flow

Token URL"/api/v2/auth/token"

Scopes:

• "zertiban-api"Access to the API

Parámetros

Header Parameters

x-tenant-id*

UUID del negocio propietario del flujo

Tipo

string

Requerido

Formato

"uuid"

Cuerpo de la petición

multipart/form-data

object

object

Payload para crear un nuevo flujo. Se envía como la parte payload del cuerpo multipart/form-data; cualquier
documento binario adjunto a operaciones viaja como partes adicionales cuyos nombres coinciden con
documents[].id.

Contenido binario de un documento referenciado desde el payload. El nombre de la parte multipart
(aquí first-file) debe coincidir exactamente con el id de una entrada de documents[] para que
el binario quede vinculado a ese documento y a las operaciones que lo referencian.

Formato"binary"