Detalles del flujo

GET

/flow/v1/flows/{flowUuid}

Recupera el detalle completo de un flujo. Se usa para trazabilidad y sincronización con sistemas externos como ERP.

Incluye el estado agregado, la configuración aplicada, las etiquetas y los resúmenes de las operaciones de pago y firma.

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"

Path Parameters

flowUuid*

UUID del flujo a recuperar

Tipo

string

Requerido

Formato

"uuid"

Respuestas

Detalles del flujo y sus operaciones

Content-Type

application/json

{

  

"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

  

"status": "IN_PROGRESS",

  

"externalId": "FLOW-2025-9911",

  

"countryCode": "ES",

  

"languageCode": "es",

  

"additionalLanguageCode": "en",

  

"channel": "API",

  

"createdAt": "2025-10-15T09:10:00Z",

  

"labels": [

  

  

{

  

  

  

"name": "product",

  

  

  

"value": "pagafactu"

  

  

}

  

],

  

"paymentOperations": [

  

  

{

  

  

  

"uuid": "c1ab3a78-8d0a-4f05-b51d-219a28f50111",

  

  

  

"externalId": "OP-12345",

  

  

  

"status": "OPENED",

  

  

  

"statusUpdatedAt": "2025-10-16T11:10:00Z",

  

  

  

"expiresAt": "2025-10-22T00:00:00Z",

  

  

  

"amount": 1999,

  

  

  

"currency": "EUR"

  

  

}

  

],

  

"signatureOperations": [

  

  

{

  

  

  

"uuid": "91a23f12-5089-4d38-af11-bea213f44077",

  

  

  

"externalId": "OP-12345",

  

  

  

"status": "CREATED",

  

  

  

"statusUpdatedAt": "2025-10-16T11:10:00Z",

  

  

  

"expiresAt": "2025-10-16T11:10:00Z"

  

  

}

  

]

}

GET

/flow/v1/flows/{flowUuid}

Playground

Autorización

OAuth2

Headers

x-tenant-id*

Variables

Key

Value

flowUuid*

Ejemplos