Webhooks
Erhalten Sie Echtzeit-Benachrichtigungen über Änderungen an Ihren Forderungen.
Events
| Event | Beschreibung |
|---|---|
| claim.created | Neue Forderung erstellt |
| claim.approved | Forderung genehmigt, Schuldner wird kontaktiert |
| claim.rejected | Forderung abgelehnt |
| claim.paid | Zahlung eingegangen |
| claim.disputed | Schuldner hat Widerspruch eingelegt |
| claim.escalated | Forderung 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:
| Versuch | Wartezeit |
|---|---|
| 1. Retry | 5 Sekunden |
| 2. Retry | 30 Sekunden |
| 3. Retry | 2 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.