Saltar al contenido principal
A veces necesitas detener un Payout después de iniciarlo; esta guía describe los procedimientos de cancelación. Si necesitas cancelar un Payout debido a un error o a un cambio en los requisitos, puedes hacerlo siempre que el Payout se encuentre en uno de los siguientes estados: Autorización pendiente, Recibido, En espera o Bloqueado. Puedes cancelar los pagos a través del Business Portal o mediante programación a través de la API.

Requisitos previos

Antes de cancelar un Payout, asegúrate de tener:
  • Una transacción de Payout activa con estado: PendingAuth, Received, OnHold o Locked
  • Credenciales de API válidas con los permisos adecuados
  • El identificador de la transacción (externalId)
ImportanteUna vez que un Payout pasa al estado En proceso o Completado, no se puede cancelar a través de la API. Comunícate con soporte para recibir asistencia con las transacciones procesadas.

Endpoint de la API

Para cancelar un Payout, envía una solicitud PATCH 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:
  1. Prueba con transacciones válidas en estados que permitan la cancelación
  2. Prueba con transacciones no válidas para gestionar los errores correctamente
  3. Prueba los fallos de autenticación y la caducidad del token
  4. Verifica el manejo de webhooks si lo has implementado
  5. 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.

Última modificación el 10 de noviembre de 2026