Ressources / Webhooks

Notifications d'Événements Temps Réel

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

Temps Réel

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

Fiable

Nouvelles tentatives automatiques avec backoff exponentiel

Surveillé

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

Événements Disponibles

invoice.created

Déclenché quand une nouvelle facture est créée

Payload d'Exemple :

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

Déclenché quand un paiement de facture est reçu

Payload d'Exemple :

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

Déclenché quand un nouveau client est ajouté

Payload d'Exemple :

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

Déclenché quand une tentative de paiement échoue

Payload d'Exemple :

{
  "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 Succès

99.8%

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

Dernière Livraison

Il y a 15 minutes

Taux de Succès

100%

Meilleures Pratiques Webhook

  • Vérifiez toujours les signatures webhook pour assurer l'authenticité
  • Retournez un code de statut 200 rapidement pour accuser réception
  • Traitez les données webhook de manière asynchrone dans une queue
  • Utilisez des endpoints HTTPS pour assurer la sécurité des données
  • Implémentez l'idempotence pour gérer les événements dupliqués

Commencez à Utiliser les Webhooks

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