Requisitos previos
Antes de cancelar un Payout, asegúrate de tener:- Una transacción de Payout activa con estado:
PendingAuth,Received,OnHoldoLocked - Credenciales de API válidas con los permisos adecuados
- El identificador de la transacción (
externalId)
Endpoint de la API
Para cancelar un Payout, envía una solicitudPATCH al endpoint Cancelar un Payout.
Solicitud de cancelación de Payout
Autenticación
Incluye tu token de acceso en los encabezados de la solicitud:Parámetros clave de la solicitud
Ejemplo de solicitud
curl
Gestión de respuestas
Respuesta de éxito
Cuando la cancelación se realiza correctamente, recibirás una respuesta con el estado actualizado:Campos de respuesta clave
Respuestas de error
Mejores prácticas de implementación
- Valida siempre el estado de la transacción antes de intentar la cancelación
- Utiliza HTTPS para todas las solicitudes a la API
- Guarda los tokens de acceso de forma segura y rótalos periódicamente
- Implementa un manejo de errores y una lógica de reintento adecuados
- Registra todos los intentos de cancelación con fines de auditoría
Prueba de tu implementación
Antes de implementar en producción, prueba a fondo tu lógica de cancelación:- Prueba con transacciones válidas en estados que permitan la cancelación
- Prueba con transacciones no válidas para gestionar los errores correctamente
- Prueba los fallos de autenticación y la caducidad del token
- Verifica el manejo de webhooks si lo has implementado
- Prueba la limitación de velocidad y la lógica de reintento
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.

