Webhooks

Recibe eventos de los recursos como payments, merchants, y más.

Los Webhooks permiten que tu sistema reciba notificaciones automáticas cuando ciertos eventos ocurren en nuestra plataforma. En lugar de consultar continuamente nuestra API, puedes suscribirte a eventos específicos y recibir actualizaciones mediante solicitudes HTTP.

Este mecanismo es ideal para integraciones donde se requiere reaccionar rápidamente a cambios en payments, merchants u otras acciones relevantes del negocio.

A lo largo de esta documentación, te mostraremos cómo configurar, recibir y validar Webhooks de forma segura y eficiente.


Eventos

Debajo se listan los diferentes eventos a los cuales es posible subscribirse.

Instruments

NombreDescripción
instrument.createdEste evento se activa cuando se crea un instrumento en Akua. El valor devuelto es el ID del instrumento relacionado.
instrument.deletedEste evento se activa cuando se elimina un instrumento en Akua. El valor devuelto es el ID del instrumento relacionado.
instrument.updatedEste evento se activa cuando se actualiza un instrumento en Akua. El valor devuelto es el ID del instrumento relacionado.

Payments

NombreDescripción
payment.account-status.rejectedEste evento ocurre cuando un pago es rechazado debido a problemas con el estado de la cuenta.
payment.adjust.rejectedEste evento ocurre cuando un ajuste de pago es rechazado.
payment.authorization.processedEste evento ocurre cuando una autorización de pago se procesa con éxito.
payment.authorization.rejectedEste evento ocurre cuando una autorización de pago es rechazada.
payment.cancel.processedEste evento ocurre cuando una cancelación de pago se procesa con éxito.
payment.cancel.rejectedEste evento ocurre cuando una solicitud de cancelación de pago es rechazada.
payment.capture.automatic.processedEste evento ocurre cuando una captura automática de pago se procesa con éxito.
payment.capture.clearedEste evento ocurre cuando una captura de pago es liquidada.
payment.capture.manual.processedEste evento ocurre cuando una captura manual de pago se procesa con éxito.
payment.processing.failedEste evento ocurre cuando falla el procesamiento de un pago.
payment.refund.clearedEste evento ocurre cuando un reembolso es liquidado.
payment.refund.rejectedEste evento ocurre cuando una solicitud de reembolso es rechazada.
payment.validation.failedEste evento ocurre cuando falla la validación de un pago.

Merchants

NombreDescripción
merchant.createdEste evento ocurre cuando se crea un nuevo comerciante en la plataforma de Akua.
logo akua

© Akua 2025 - Todos los derechos reservados