Allgemein

Zahlungs-Webhooks: Was sie sind und wie Sie die Bestellbestätigung automatisieren

Erfahren Sie, was Zahlungs-Webhooks sind, wie sie funktionieren und wie Sie per Pix, Karte und Boleto bezahlte Bestellungen in Brasilien automatisch in Ihrem System oder ERP bestätigen.

Von Equipe Sila Pay3 Min. Lesezeit
Lächelnde Entwicklerin in einem Coworking-Space, seitlich am Laptop arbeitend

Wenn ein Kunde bezahlt, muss Ihr System davon erfahren: die Bestellung als bezahlt markieren, die Ware kommissionieren, die Rechnung ausstellen und die Bestätigung versenden. Das per Kontoauszug zu prüfen, klappt am Anfang, bremst aber den Betrieb, sobald die Verkäufe wachsen. Genau dafür gibt es Zahlungs-Webhooks.

Was ist ein Zahlungs-Webhook?

Ein Webhook ist eine automatische Benachrichtigung, die die Zahlungsplattform an eine Adresse (URL) Ihres Systems sendet, sobald sich bei einer Zahlung etwas tut: Ein Pix wurde bezahlt, ein Boleto beglichen, ein Kartenkauf genehmigt oder erstattet. Statt dass Ihr System regelmäßig nachfragt, ob schon bezahlt wurde, wird es informiert, sobald sich der Status ändert.

So funktioniert es – Schritt für Schritt

  1. URL angeben: die Adresse Ihres Systems, die die Benachrichtigungen empfängt – im Dashboard eingerichtet oder im Feld postbackUrl einer per API erstellten Zahlung übergeben.
  2. Kunde bezahlt: per Pix, Kreditkarte oder Boleto.
  3. Plattform sendet die Benachrichtigung: einen HTTP-POST-Request mit den Ereignisdaten im JSON-Format.
  4. Ihr System bestätigt die Bestellung: Es prüft die Nachricht, aktualisiert den Status und antwortet mit HTTP 200 als Empfangsbestätigung.

Was ein Webhook enthält

Jede Benachrichtigung enthält eine eindeutige Ereignis-ID, den Zahlungsstatus und die Transaktionsdaten. Ein vereinfachtes Beispiel: {"id": "evt_...", "status": "LIQUIDATED", "data": {"value": "16.5", "txId": "...", "method": "pix"}}.

Bei Sila Pay wählen Sie im Dashboard außerdem aus, welche Ereignisse Sie erhalten möchten, etwa Kauf genehmigt (purchase_approved), Pix bezahlt (pix_paid), Boleto bezahlt (boleto_paid), Pix abgelaufen und Kauf erstattet.

Wo Webhooks im Alltag helfen

  • Automatische Bestellabwicklung: Die Bestellung wechselt in Ihrem System oder ERP auf „bezahlt“, ohne dass jemand Kontoauszüge prüft.
  • Lager und Versand: Die Kommissionierung beginnt, sobald die Zahlung bestätigt ist.
  • Digitale Produkte und Dienstleistungen: Schalten Sie Zugänge, Tickets oder Termine direkt nach der Zahlung frei.
  • Abgelaufene Zahlungen: Erfahren Sie, wann ein Pix oder Boleto unbezahlt abgelaufen ist, und fassen Sie nach.

Möchten Sie Ihre Bestellbestätigungen automatisieren? Jetzt Sila-Pay-Konto eröffnen

Best Practices für den Empfang von Webhooks

  • Signatur prüfen: Jede Benachrichtigung von Sila Pay enthält den Header X-Silapay-Signature, einen HMAC-SHA256, der mit Ihrem Secret berechnet wird. Prüfen Sie ihn vor der Verarbeitung.
  • Schnell antworten: Senden Sie innerhalb von 5 Sekunden HTTP 200 zurück und erledigen Sie aufwendige Aufgaben wie die Rechnungsstellung später.
  • Duplikate abfangen: Antwortet Ihr System nicht, versucht es die Plattform erneut; nutzen Sie die Ereignis-id, damit dieselbe Nachricht nie doppelt verarbeitet wird.
  • HTTPS nutzen und Secret schützen: Bewahren Sie es auf dem Server auf, niemals auf der Website oder in der App.

Häufige Fragen

Muss ich programmieren können, um Webhooks zu nutzen?

Jemand muss die Adresse einrichten, die die Benachrichtigungen empfängt. Viele ERP-Systeme und Shop-Plattformen bringen diese Funktion bereits mit; wenn Sie WooCommerce oder Shopify nutzen, bietet Sila Pay Plugins zur Anbindung Ihres Shops.

Was ist der Unterschied zwischen Webhook und API?

Bei der API ruft Ihr System die Plattform auf, etwa um eine Zahlung anzulegen. Beim Webhook ruft die Plattform Ihr System auf, um eine Änderung zu melden. Meist arbeiten beide zusammen.

Was passiert, wenn mein System nicht erreichbar ist?

Sila Pay unternimmt automatisch weitere Zustellversuche, wenn keine HTTP-200-Antwort eingeht. Für längere Ausfälle empfiehlt sich trotzdem ein regelmäßiger Abgleich.

Wo finde ich die Dokumentation?

Unter doc.silapay.pro – mit der Liste der Ereignisse, dem Payload-Format und einem Beispiel zur Signaturprüfung.

Bestätigen Sie Bestellungen automatisch – ohne Kontoauszüge zu prüfen. Bei Sila Pay registrieren

#pagamentos#vendas online
TeilenWhatsAppLinkedInX

Bereit, das umzusetzen?

Erstellen Sie Ihr Sila Pay Konto in wenigen Minuten und nehmen Sie Zahlungen per Pix, Karte und Zahlungslink an.

  • ✓ Kostenlose Registrierung
  • ✓ Keine Monatsgebühr
  • ✓ Auszahlung in T+1
Kostenloses Konto erstellen →

Neue Artikel per E-Mail

Praxiswissen zu Zahlungen und Online-Verkauf, direkt in Ihr Postfach.

Kein Spam. Jederzeit abbestellbar.

Weitere Artikel

Sila Pay

Alles, was Sie zum Verkaufen brauchen, an einem Ort.

Jetzt starten →