Webhooks informieren deinen Server über jede Änderung an Zahlungen, Käufen und Auszahlungen. Hinterlege eine Adresse pro Projekt und prüfe bei jedem Aufruf die Signatur.
Adresse hinzufügen
- Öffne das Projekt und fülle Webhook-URL aus. Es muss eine öffentliche https-Adresse sein.
- Klicke auf Einstellungen speichern und dann auf test.ping senden. Das Dashboard zeigt, ob dein Server ihn angenommen hat.
Was wir senden
Einen POST mit JSON-Body: den Event-Typ (zum Beispiel deposit.in_hold, deposit.success, deposit.hold_returned, purchase.accepted oder payout.paid), ob es live oder ein Test ist, und das Objekt selbst. Alle Event-Typen stehen in der API-Referenz.
Signatur prüfen
Jeder Aufruf trägt einen SkinPlata-Signature-Header mit Zeitstempel und einer HMAC-SHA256-Signatur, erstellt mit deinem Webhook-Signing-Secret. Berechne sie aus dem rohen Body und vergleiche, bevor du irgendetwas vertraust. Die API-Referenz hat fertige Beispiele.
Schnell antworten
Antworte innerhalb weniger Sekunden mit einem beliebigen 2xx-Status und erledige die langsame Arbeit danach. Andere Antworten zählen als Fehler, und wir versuchen es etwa zwei Tage lang erneut.
Sicher gutschreiben
- Verarbeite jedes Event nur einmal: Dasselbe Event kann mehrfach ankommen.
- Lies die Zahlung über die API erneut ein, bevor du auf deiner Seite Wert vergibst.
- Hol den Wert zurück, wenn eine Zahlung rückabgewickelt wird, siehe Handelsschutz und vorzeitige Freigabe.
Jede Zustellung, ihre Antwort und ihre Wiederholungen findest du unter Webhooks im Dashboard. Kommt nichts an, siehe Webhooks kommen nicht an: was prüfen.