Zum Hauptinhalt springen

Webhooks

Erhalten Sie Echtzeit-Benachrichtigungen über Änderungen an Ihren Forderungen.

Events

EventBeschreibung
claim.createdNeue Forderung erstellt
claim.approvedForderung genehmigt, Schuldner wird kontaktiert
claim.rejectedForderung abgelehnt
claim.paidZahlung eingegangen
claim.disputedSchuldner hat Widerspruch eingelegt
claim.escalatedForderung zur Eskalation weitergeleitet

Webhook einrichten

Erstellen Sie einen Webhook unter Einstellungen → Webhooks:

bash
curl -X POST https://api.cashmich.com/api/webhooks \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/cashmich",
    "events": ["claim.created", "claim.paid"]
  }'

Payload Format

json
{
  "event": "claim.paid",
  "timestamp": "2026-03-27T10:00:00Z",
  "data": {
    "id": "clm_abc123",
    "status": "paid",
    "amount": 250.00,
    "creditorName": "Firma GmbH",
    "debtorName": "Max Mustermann",
    "paidAt": "2026-03-27T09:58:00Z"
  }
}

HMAC Verifizierung

Jeder Webhook-Request enthält einen X-Webhook-Signature Header mit einer HMAC-SHA256 Signatur.

javascript
const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Express Middleware
app.post('/webhooks/cashmich', (req, res) => {
  const signature = req.headers['x-webhook-signature'];
  const isValid = verifyWebhook(
    JSON.stringify(req.body),
    signature,
    process.env.CASHMICH_WEBHOOK_SECRET
  );

  if (!isValid) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  // Event verarbeiten
  const { event, data } = req.body;
  console.log(`Received ${event} for claim ${data.id}`);

  res.status(200).json({ received: true });
});

Retry Policy

Fehlgeschlagene Webhook-Zustellungen werden automatisch wiederholt:

VersuchWartezeit
1. Retry5 Sekunden
2. Retry30 Sekunden
3. Retry2 Minuten

Nach 3 aufeinanderfolgenden Fehlschlägen wird der Webhook automatisch deaktiviert. Sie erhalten eine Benachrichtigung und können den Webhook in den Einstellungen reaktivieren.

Best Practices

  • Antworten Sie immer mit HTTP 200 innerhalb von 10 Sekunden.
  • Verarbeiten Sie Events asynchron — bestätigen Sie den Empfang sofort.
  • Verifizieren Sie immer die HMAC-Signatur.
  • Implementieren Sie Idempotenz — Events können bei Retries doppelt zugestellt werden.
KI-gestützt
Schuldnerfreundlich
DSGVO-konform
€Keine Vorabkosten

Newsletter abonnieren

© 2026 CashMich. Alle Rechte vorbehalten.

Alle Systeme betriebsbereit

Cookies

Wir nutzen Cookies für Betrieb und Verbesserung.

Mehr in der Datenschutzerklärung.