Saltar al contenido principal

¿Qué es un Webhook?

Los webhooks permiten que tu tienda reciba notificaciones automáticas cada vez que ocurre un evento importante, como la aprobación o expiración de un pago. Así, puedes automatizar procesos e integrar sistemas externos fácilmente.

¿Cómo funciona en caBRAPI?

Cuando cambia el estado de un pago (por ejemplo, aprobado o expirado), caBRAPI envía una solicitud HTTP POST a todas las URLs de webhook registradas para la tienda. Cada tienda puede registrar múltiples webhooks, respetando el límite del plan contratado. El límite máximo se muestra en el panel y puede consultarse vía API.

Eventos soportados

  • Pago aprobado (APPROVED)
  • Pago expirado (EXPIRED)

¿Cómo funciona el payload cifrado

El campo payload enviado a cada webhook es una cadena cifrada con AES-256-CBC, en el formato:
  • El IV (vector de inicialización) y el contenido cifrado están separados por dos puntos.
  • La clave de cifrado se deriva de la API Key del dueño de la tienda mediante SHA-256.
Atención: Tu endpoint debe conocer la API Key del dueño de la tienda para descifrar el payload.

Descifrando el payload (Node.js)

Estructura del objeto descifrado


Ejemplo completo de recepción (Node.js)


Cómo configurar tu Webhook

  1. Accede al panel de tu tienda y ve a Configuraciones → Webhooks.
  2. Añade una o más URLs — el límite depende de tu plan y se muestra en el panel.
  3. Al registrarlas, caBRAPI enviará automáticamente un evento de prueba (WEBHOOK_TEST) para validar el endpoint. Tu servidor debe responder con estado 2xx.
  4. A partir de ahí, todos los eventos de pago se dispararán automáticamente a las URLs registradas.

Enlaces útiles