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 reembolso en estado
Completed. - El
internalIdoexternalIdde cada transacción para la que deseas un POP.
Endpoint de la API
Para descargar el POP de un reembolso, envía una solicitudPOST al endpoint Download Refund 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 valoresinternalId 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.Completed.
Mejores prácticas de implementación
- Valida que una transacción esté en estado
Completedantes 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.

