Recursos / Webhooks

Notificaciones de Eventos en Tiempo Real

Reciba notificaciones instantáneas cuando ocurran eventos en su cuenta de Laabam

Tiempo Real

Reciba notificaciones instantáneas cuando ocurran eventos

Confiable

Reintentos automáticos con retroceso exponencial

Monitoreado

Rastree el estado de entrega y depure problemas

Eventos Disponibles

invoice.created

Se activa cuando se crea una nueva factura

Ejemplo de Carga:

{
  "invoice_id": "inv_123",
  "status": "borrador",
  "amount": 50000
}
invoice.paid

Se activa cuando se recibe el pago de una factura

Ejemplo de Carga:

{
  "invoice_id": "inv_123",
  "payment_id": "pay_456",
  "amount": 50000
}
customer.created

Se activa cuando se agrega un nuevo cliente

Ejemplo de Carga:

{
  "customer_id": "cust_789",
  "name": "Juan Pérez",
  "email": "juan@ejemplo.com"
}
payment.failed

Se activa cuando falla un intento de pago

Ejemplo de Carga:

{
  "payment_id": "pay_456",
  "reason": "fondos_insuficientes"
}

Ejemplo de Implementación

Así es como manejar webhooks en su aplicación:

// Webhook endpoint example (Node.js/Express)
const express = require('express');
const app = express();

app.post('/webhooks/laabam', express.json(), (req, res) => {
  const event = req.body;
  
  // Verify webhook signature
  const signature = req.headers['x-laabam-signature'];
  if (!verifySignature(signature, req.body)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Handle different event types
  switch (event.type) {
    case 'invoice.created':
      console.log('New invoice:', event.data.invoice_id);
      // Your business logic here
      break;
      
    case 'invoice.paid':
      console.log('Payment received:', event.data.payment_id);
      // Update your database, send email, etc.
      break;
  }
  
  res.status(200).send('Webhook received');
});

Sus Webhooks

https://api.tusitio.com/webhooks/laabam
ACTIVO
invoice.createdinvoice.paid

Última Entrega

hace 2 minutos

Tasa de Éxito

99.8%

https://staging.tusitio.com/webhooks
ACTIVO
customer.createdpayment.failed

Última Entrega

hace 15 minutos

Tasa de Éxito

100%

Mejores Prácticas de Webhook

  • Siempre verifique las firmas de webhook para garantizar la autenticidad
  • Devuelva el código de estado 200 rápidamente para confirmar la recepción
  • Procese los datos de webhook de forma asíncrona en una cola
  • Use endpoints HTTPS para garantizar la seguridad de los datos
  • Implemente idempotencia para manejar eventos duplicados

Comience a Usar Webhooks

Construya integraciones en tiempo real con webhooks de Laabam