> ## 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 pago (POP)

Descarga mediante programación el documento de comprobante de pago (POP) de las transacciones de Payout completadas.

El comprobante de pago (POP) es el documento oficial de confirmación de una transacción de Payout completada. Además de descargarlo manualmente desde el [Business Portal](https://docs.localpayment.com/es/docs/dashboard-payout-proof-of-payment.md), puedes solicitarlo mediante programación a través de la API.

## Requisitos previos

Antes de comenzar, asegúrate de tener:

* Credenciales de API válidas con un token de acceso activo.
* Una o más transacciones de Payout en estado `Completed`.
* El `internalId` o `externalId` de cada transacción para la que deseas un POP.

***

## Endpoint de la API

Para descargar el POP de un Payout, envía una solicitud `POST` al endpoint [Download Payout Proof of Payment](https://docs.localpayment.com/es/reference/download-payout-proof-of-payment.md).

### Endpoint

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
POST https://api.stage.localpayment.com/api/v1/payouts/proof-of-payment
```

### Autenticación

Incluye tu token de acceso en los encabezados de la solicitud:

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
Authorization: Bearer <your_access_token>
```

### Cuerpo de la solicitud

El cuerpo es un arreglo JSON de identificadores de transacción. Puedes combinar valores `internalId` y `externalId` en la misma solicitud.

| Campo | Tipo | Descripción | Requerido |
| - | - | - | - |
| (elemento del arreglo) | string | `internalId` o `externalId` de una transacción de Payout en estado `Completed` | ✅ |

### Ejemplo de solicitud

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/v1/payouts/proof-of-payment \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '[
       "550e8400-e29b-41d4-a716-446655440000",
       "f47ac10b-58cc-4372-a567-0e02b2c3d479"
     ]'
```

***

## Gestión de respuestas

### Respuesta de éxito

Si la solicitud es exitosa, el cuerpo de la respuesta es el propio archivo ZIP, codificado en base64 como texto plano. No está envuelto en un campo JSON: decodifica directamente el cuerpo de la respuesta para obtener el archivo ZIP, que contiene un PDF de comprobante de pago por cada transacción solicitada.

### Respuestas de error

**401 No autorizado.** El token de acceso no existe, no es válido o ha caducado.

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "code": "token_not_valid",
  "detail": "Given token not valid for any token type",
  "messages": [
    {
      "message": "Token is invalid or expired",
      "token_class": "AccessToken",
      "token_type": "access"
    }
  ]
}
```

**403 Prohibido.** Una o más de las transacciones solicitadas no están en estado `Completed`.

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "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 No encontrado.** Ninguno de los identificadores solicitados tiene información de comprobante de pago disponible.

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "Status": 404,
  "Code": null,
  "Message": "There is no payments information to generate the file",
  "TraceId": "6a907fb4000000001f723f645b1fdee3"
}
```

***

## Mejores prácticas de implementación

* Valida que una transacción esté en estado `Completed` antes de solicitar su POP.
* Agrupa varios ID de transacción en una sola solicitud en lugar de llamar al endpoint una vez por transacción.
* Guarda los tokens de acceso de forma segura y rótalos periódicamente.

***

## Recursos y próximos pasos

Maximiza el éxito de tu integración con estos recursos esenciales.

> [card] [Integración de webhooks](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.

> [card] [Portal de informes empresariales](https://docs.localpayment.com/es/docs/balance-report.md)
>
> Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.

> [card] [Monitoreo de transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes)
>
> Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.

> [card] [Referencia de la API](https://docs.localpayment.com/es/reference/exchange-bulk.md)
>
> Documentación completa del endpoint con ejemplos interactivos.

> [!NOTE]
>
> **Consejo profesional**
>
> Siempre prueba tu flujo de trabajo en nuestro entorno de pruebas antes de implementarlo en producción. Esto garantiza que el manejo de errores, el procesamiento de webhooks y el seguimiento del estado funcionen correctamente en todos los escenarios.

***

> [!NOTE]
>
> **¿Necesitas ayuda?**
>
> Ponte en contacto con nuestro [equipo de soporte](mailto:support@localpayment.com) si experimentas algún problema o necesitas ayuda con la integración.


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