Recursos / Webhooks

Notificações de Eventos em Tempo Real

Receba notificações instantâneas quando eventos acontecem na sua conta Laabam

Tempo Real

Seja notificado instantaneamente quando eventos ocorrem

Confiável

Tentativas automáticas com backoff exponencial

Monitorizado

Acompanhe o estado de entrega e depure problemas

Eventos Disponíveis

invoice.created

Acionado quando uma nova fatura é criada

Exemplo de Payload:

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

Acionado quando um pagamento de fatura é recebido

Exemplo de Payload:

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

Acionado quando um novo cliente é adicionado

Exemplo de Payload:

{
  "customer_id": "cust_789",
  "name": "João Silva",
  "email": "joao@exemplo.com"
}
payment.failed

Acionado quando uma tentativa de pagamento falha

Exemplo de Payload:

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

Exemplo de Implementação

Aqui está como lidar com webhooks na sua aplicação:

// 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');
});

Seus Webhooks

https://api.seusite.com/webhooks/laabam
ATIVO
invoice.createdinvoice.paid

Última Entrega

há 2 minutos

Taxa de Sucesso

99,8%

https://staging.seusite.com/webhooks
ATIVO
customer.createdpayment.failed

Última Entrega

há 15 minutos

Taxa de Sucesso

100%

Melhores Práticas de Webhooks

  • Sempre verifique assinaturas de webhooks para garantir autenticidade
  • Retorne código de estado 200 rapidamente para confirmar receção
  • Processe dados de webhooks assincronamente numa fila
  • Use endpoints HTTPS para garantir segurança de dados
  • Implemente idempotência para lidar com eventos duplicados

Comece a Usar Webhooks

Construa integrações em tempo real com webhooks Laabam