> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Descargar comprobante de reembolso

Descarga un documento de comprobante de pago (POP) para una o más transacciones de reembolso completadas.

Envía un arreglo de valores `internalId` o `externalId` de transacciones de reembolso en estado `Completed`. La respuesta es un archivo ZIP codificado en base64 que contiene un PDF de comprobante de pago por cada transacción solicitada.

> [!NOTE]
>
> Se admite combinar valores `internalId` y `externalId` en el mismo arreglo de la solicitud.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/v1/refunds/proof-of-payment
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/v1/refunds/proof-of-payment:
    post:
      summary: Descargar comprobante de reembolso
      operationId: download-refund-proof-of-payment
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              description: >-
                Lista de identificadores de transacciones para generar
                documentos de comprobante de pago. Acepta cualquiera de los
                siguientes formatos: `internalId` o `externalId` valores,
                mezclados en la misma solicitud. Cada transacción debe estar en
                `Completed` estado.
              items:
                type: string
              example:
                - 550e8400-e29b-41d4-a716-446655440000
                - f47ac10b-58cc-4372-a567-0e02b2c3d479
              x-examples:
                Example 1:
                  - 550e8400-e29b-41d4-a716-446655440000
                  - f47ac10b-58cc-4372-a567-0e02b2c3d479
            examples:
              Example 1 - Two internalId/externalId values:
                value:
                  - 550e8400-e29b-41d4-a716-446655440000
                  - f47ac10b-58cc-4372-a567-0e02b2c3d479
        required: true
      responses:
        '200':
          description: >-
            OK. El cuerpo de la respuesta es el propio archivo ZIP, codificado
            en base64 como texto plano (no envuelto en un campo JSON), que
            contiene un comprobante de pago en PDF por cada transacción
            solicitada. Confirmado con una captura real: los bytes decodificados
            comienzan con la firma del archivo ZIP (`PK\x03\x04` ).
          content:
            application/json:
              schema:
                type: string
                format: byte
                description: >-
                  Archivo ZIP codificado en Base64 que contiene los archivos PDF
                  de comprobante de pago solicitados. Decodifique esta cadena
                  directamente para obtener el archivo ZIP; no contiene ningún
                  objeto JSON.
              examples:
                Example 1 - Base64-encoded ZIP (truncated):
                  value: UEsFBgAAAAAAAAAAAAAAAAAAAAAAAA==
        '401':
          description: >-
            Acceso no autorizado. El token de acceso no existe, no es válido o
            ha caducado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                token_not_valid - Token invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
        '403':
          description: >-
            Prohibido. El comprobante de pago solo está disponible para
            transacciones en estado `Completed`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de error.
                  message:
                    type: string
                    description: Mensaje de error legible.
                  invalid_transactions:
                    type: array
                    description: >-
                      Transacciones que no se encuentran en un estado válido
                      para el Comprobante de pago.
                    items:
                      type: object
                      properties:
                        transaction_id:
                          type: string
                          description: internalId o externalId de la transacción inválida.
                        current_status:
                          type: string
                          description: Estado actual de la transacción.
                x-examples:
                  Example 1:
                    error: INVALID_STATUS
                    message: >-
                      Proof of Payment is only available for Completed
                      transactions
                    invalid_transactions:
                      - transaction_id: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                        current_status: Cancelled
              examples:
                INVALID_STATUS - Transaction not Completed:
                  value:
                    error: INVALID_STATUS
                    message: >-
                      Proof of Payment is only available for Completed
                      transactions
                    invalid_transactions:
                      - transaction_id: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                        current_status: Cancelled
        '404':
          description: >-
            No encontrado. Ninguno de los identificadores de transacción
            solicitados tiene disponible información de comprobante de pago.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: integer
                    description: Código de estado HTTP.
                  Code:
                    type: string
                    nullable: true
                    description: Código de error interno, si lo hay.
                  Message:
                    type: string
                    description: Mensaje de error legible.
                  TraceId:
                    type: string
                    description: Identificador de seguimiento para fines de soporte.
                x-examples:
                  Example 1:
                    Status: 404
                    Code: null
                    Message: There is no payments information to generate the file
                    TraceId: 6a907fb4000000001f723f645b1fdee3
              examples:
                404 - No payment information:
                  value:
                    Status: 404
                    Code: null
                    Message: There is no payments information to generate the file
                    TraceId: 6a907fb4000000001f723f645b1fdee3
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.