Ressources / Webhooks

Notifications d'événements en temps réel

Recevez des notifications instantanées lorsque des événements se produisent dans votre compte Laabam

Temps réel

Soyez notifié instantanément lorsque des événements se produisent

Fiable

Nouvelles tentatives automatiques avec recul exponentiel

Surveillé

Suivez le statut de livraison et déboguez les problèmes

Événements disponibles

invoice.created

Déclenché lorsqu'une nouvelle facture est créée

Exemple de charge utile :

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

Déclenché lorsqu'un paiement de facture est reçu

Exemple de charge utile :

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

Déclenché lorsqu'un nouveau client est ajouté

Exemple de charge utile :

{
  "customer_id": "cust_789",
  "name": "John Doe",
  "email": "john@example.com"
}
payment.failed

Déclenché lorsqu'une tentative de paiement échoue

Exemple de charge utile :

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

Exemple d'implémentation

Voici comment gérer les webhooks dans votre application :

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

Vos webhooks

https://api.yoursite.com/webhooks/laabam
ACTIF
invoice.createdinvoice.paid

Dernière livraison

il y a 2 minutes

Taux de réussite

99,8 %

https://staging.yoursite.com/webhooks
ACTIF
customer.createdpayment.failed

Dernière livraison

il y a 15 minutes

Taux de réussite

100 %

Meilleures pratiques de webhooks

  • Vérifiez toujours les signatures de webhook pour assurer l'authenticité
  • Retournez rapidement le code de statut 200 pour confirmer la réception
  • Traitez les données de webhook de façon asynchrone dans une file d'attente
  • Utilisez des points de terminaison HTTPS pour assurer la sécurité des données
  • Implémentez l'idempotence pour gérer les événements en double

Commencez à utiliser les webhooks

Construisez des intégrations en temps réel avec les webhooks Laabam