Descargar documento de pago

GET

/flow/v1/operations/{operationUuid}/payment-documents/{paymentDocumentUuid}/content

Descarga los documentos adjuntos a una operación de pago mediante streaming eficiente. Permite recuperar PDF o adjuntos grandes sin cargar el archivo completo en memoria.

El paymentDocumentUuid proviene del array payment.documents[] devuelto por el endpoint de detalle de la operación. El documento se retransmite usando codificación de transferencia por bloques (chunked). La respuesta establece Content-Disposition: attachment; filename="<name>"; cuando no hay nombre disponible, se usa payment-document.pdf como alternativa.

Autorizaciones

OAuth2

Esquema de seguridad OAuth2

clientCredentials Flow

URL del token"/api/v2/auth/token"

Scopes:

• "zertiban-api"Access to the API

Parámetros

Header Parameters

x-tenant-id*

Identificador del tenant que contiene el UUID de la organización

Tipo

string

Requerido

Ejemplo"1f56c928-7621-44fe-8cda-c211fda0a828"

Formato

"uuid"

Path Parameters

operationUuid*

UUID de la operación

Tipo

string

Requerido

Formato

"uuid"

paymentDocumentUuid*

UUID del documento de pago

Tipo

string

Requerido

Formato

"uuid"

Respuestas

Documento recuperado correctamente y en streaming. El cuerpo de la respuesta contiene
el contenido binario crudo del documento.
Cabeceras:

• Content-Type: Tipo MIME específico del documento "application/octet-stream"
• Content-Length: Tamaño total del documento en bytes (si se conoce)
• Transfer-Encoding:"chunked" para el streaming

Content-Type

application/octet-stream

GET

/flow/v1/operations/{operationUuid}/payment-documents/{paymentDocumentUuid}/content

Playground

Servidor

Autorización

OAuth2

Headers

x-tenant-id*

Variables

Key

Value

operationUuid*

paymentDocumentUuid*

Ejemplos