Webhook-Dokumentation

Erhalten Sie Echtzeitbenachrichtigungen für Conversions, Zahlungen und Kampagnenereignisse. Integrieren Sie BankRolls Webhooks, um responsive Affiliate-Anwendungen zu erstellen und Ihren Workflow zu automatisieren.

Coming Soon

Webhook-Dokumentation in Entwicklung

Unser Webhook-System wird derzeit mit erweiterten Funktionen und umfassender Dokumentation verbessert. Wir bauen die zuverlässigste und sicherste Webhook-Infrastruktur für Affiliate-Benachrichtigungen auf.

Erwartete Veröffentlichung: Q2 2024 | Funktionen: Echtzeitereignisse, Wiederholungslogik, Signaturverifikation | Status: Beta-Tests

Was sind Webhooks?

Webhooks sind HTTP-Callbacks, die BankRolls an Ihre Anwendung sendet, wenn bestimmte Ereignisse auftreten. Anstatt unsere API auf Änderungen abzufragen, pushen Webhooks Echtzeitbenachrichtigungen direkt an Ihren Server und ermöglichen es Ihnen:

Sofortige Conversion-Benachrichtigungen erhalten

Zahlungsbestätigungen empfangen

Kampagnenstatusänderungen verfolgen

Affiliate-Workflows automatisieren

Echtzeit-Dashboards erstellen

Daten mit externen Systemen synchronisieren

Hauptfunktionen

Echtzeitlieferung

Ereignisse werden innerhalb von Millisekunden nach dem Auftreten geliefert

Sichere Verifikation

HMAC-Signaturverifikation für authentische Anfragen

Automatische Wiederholungen

Intelligente Wiederholungslogik mit exponential backoff

Konfigurierbare Ereignisse

Wählen Sie, welche Ereignisse Sie für Ihren Anwendungsfall erhalten möchten

Verfügbare Webhook-Ereignisse

Hier sind die Webhook-Ereignisse, die in unserem umfassenden System verfügbar sein werden:

conversion.createdHohes Volumen

Echtzeit

Ausgelöst, wenn eine neue Spieler-Conversion verfolgt wird

payment.processedKritisch

Monatlich

Gesendet, wenn Affiliate-Zahlung erfolgreich verarbeitet wurde

campaign.activatedKampagne

Bei Bedarf

Benachrichtigung, wenn neue Kampagne online geht

deal.updatedDeals

Bei Bedarf

Gesendet, wenn Casino-Deal-Bedingungen geändert werden

account.suspendedKonto

Bei Bedarf

Wichtige Benachrichtigung bei Kontostatusänderung

bonus.expiredBonus

Täglich

Benachrichtigung, wenn Spieler-Bonus-Bedingungen ablaufen

Beispiel-Webhook-Payload

conversion.created Ereignis

{
  "event": "conversion.created",
  "timestamp": "2024-03-15T10:30:00Z",
  "data": {
    "conversion_id": "conv_abc123",
    "affiliate_id": "aff_xyz789",
    "campaign_id": "camp_def456",
    "casino": {
      "id": "casino_123",
      "name": "Premium Casino",
      "brand": "premium-casino"
    },
    "player": {
      "id": "player_789",
      "registration_date": "2024-03-15T10:29:45Z",
      "country": "DE",
      "currency": "EUR"
    },
    "commission": {
      "amount": 125.50,
      "currency": "EUR",
      "rate": 0.35,
      "type": "revenue_share"
    },
    "tracking": {
      "click_id": "click_ghi012",
      "source": "google",
      "medium": "cpc",
      "campaign": "sommer_promo"
    }
  }
}

Sicherheit und Best Practices

Signaturverifikation

Jede Webhook-Anfrage enthält eine HMAC SHA-256-Signatur im X-BankRolls-Signature-Header. Überprüfen Sie immer diese Signatur, um sicherzustellen, dass die Anfrage authentisch ist.

HMAC-Signatur überprüfen
Sichere Webhook-Geheimnisse verwenden
Timestamp-Frische validieren

Umgang mit Fehlern

Entwerfen Sie Ihre Webhook-Endpunkte so, dass sie Fehler elegant behandeln. Wir werden fehlgeschlagene Zustellungen automatisch mit exponential backoff wiederholen.

HTTP 200 für Erfolg zurückgeben
Idempotenz implementieren
Doppelte Ereignisse handhaben

Bereit für die Webhook-Integration?

Treten Sie unserem Beta-Programm bei, um frühen Zugang zu unserem Webhook-System zu erhalten. Helfen Sie uns beim Aufbau des zuverlässigsten Affiliate-Benachrichtigungssystems der Branche.

Häufig Gestellte Fragen

Was passiert, wenn mein Webhook-Endpunkt nicht erreichbar ist?

Wir werden Webhook-Zustellungen automatisch mit exponential backoff für bis zu 72 Stunden wiederholen. Sie können auch verpasste Ereignisse manuell über Ihr Dashboard wiedergeben.

Kann ich Webhooks vor der Live-Schaltung testen?

Ja! Unsere Sandbox-Umgebung ermöglicht es Ihnen, alle Webhook-Ereignisse mit Beispieldaten zu testen, bevor Sie Live-Affiliate-Traffic verarbeiten.

Wie gehe ich mit hochvolumigem Webhook-Traffic um?

Wir empfehlen ein Message-Queue-System für die asynchrone Verarbeitung von Webhooks. Unsere Dokumentation wird Architekturmuster für hochvolumige Szenarien enthalten.

Benachrichtigt werden, wenn die Webhook-Dokumentation fertig ist

Gehören Sie zu den Ersten, die Zugang zu unserem umfassenden Webhook-System und der Dokumentation haben.