Saltar al contenido principal
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, 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.

Endpoint

Autenticación

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

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.

Ejemplo de solicitud

curl

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.
403 Prohibido. Una o más de las transacciones solicitadas no están en estado Completed.
404 No encontrado. Ninguno de los identificadores solicitados tiene información de comprobante de pago disponible.

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.

Integración de webhooks

Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.

Portal de informes empresariales

Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.

Monitoreo de transacciones

Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.

Referencia de la API

Documentación completa del endpoint con ejemplos interactivos.

Consejo profesionalSiempre 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.

¿Necesitas ayuda?Ponte en contacto con nuestro equipo de soporte si experimentas algún problema o necesitas ayuda con la integración.

Última modificación el 10 de noviembre de 2026