Webhooks

Qyvn.io pousse les événements de votre organisation vers l'URL que vous configurez.

Configuration

Depuis Paramètres → Webhooks, ajoutez une URL HTTPS et sélectionnez les événements.

Événements

transaction.created, transaction.reconciled
invoice.paid, invoice.overdue
project.budget.exceeded
report.generated
user.invited, user.removed
audit.entry.appended

Payload

{
  "id": "evt_01HZ...",
  "type": "invoice.paid",
  "created_at": "2025-11-04T09:12:44Z",
  "data": {
    "invoice": {
      "id": "inv_01HZ...",
      "amount": 129900,
      "currency": "EUR"
    }
  }
}

Signature

Chaque requête inclut :

Qyvn-Signature: t=1730723400,v1=5257a869...

Vérification (Node.js) :

import { verifyWebhook } from "@qyvn/node";

const event = verifyWebhook(req.body, req.headers["qyvn-signature"], process.env.QYVN_WEBHOOK_SECRET);

Livraison

Tentatives : jusqu'à 24 h avec backoff exponentiel
Timeout : 10 s
Rejouables depuis la console