Documentation développeur

Webhooks sortants (bêta)

Événements fidélité livrés en HTTPS vers vos endpoints (asynchrone, at-least-once).

Contrat de livraison

  • Transport : HTTPS POST
  • Intégrité : en-têtes X-Baara-Signature, X-Baara-Delivery-Id, X-Baara-Correlation-Id
  • Garantie : at-least-once — dédupliquez sur event.id
  • Pas d'ordre global garanti ; retries exponentiels (jusqu'à 8 tentatives)

Types d'événements (MVP)

  • loyaltyPointsEarned
  • rewardRedeemed
  • loyaltyPointsBalanceUpdated

CRUD vs livraison HTTP

La configuration des endpoints (création, secret, révocation) est disponible dans la Plateforme développeur. La livraison HTTP peut être désactivée par environnement (WEBHOOK_WORKER_ENABLED, merchant_webhook_delivery_enabled) : dans ce cas, l'enregistrement reste actif sans envoi réel.

La livraison HTTP peut être désactivée par environnement (WEBHOOK_WORKER_ENABLED).

Détails opérationnels : voir la documentation plateforme WEBHOOK_DELIVERY_SEMANTICS (dépôt services/docs/platform).