Webhook-dokumentation

Ta emot realtidsaviseringar för konverteringar, betalningar och kampanjhändelser. Integrera Bankrolls webhooks för att bygga responsiva affiliateapplikationer och automatisera ditt arbetsflöde.

Coming Soon

Webhook-dokumentation under utveckling

Vårt webhook-system förbättras för närvarande med avancerade funktioner och omfattande dokumentation. Vi bygger den mest pålitliga och säkra webhook-infrastrukturen för affiliateaviseringar.

Förväntad lansering: Q2 2024 | Funktioner: Realtidshändelser, återförsökslogik, signaturverifiering | Status: Betatestning

Vad är webhooks?

Webhooks är HTTP-återanrop som Bankrolls skickar till din applikation när specifika händelser inträffar. Istället för att polla vårt API för ändringar skickar webhooks realtidsaviseringar direkt till din server, vilket gör det möjligt för dig att:

Få omedelbara konverteringsaviseringar

Ta emot betalningsbekräftelser

Spåra kampanjstatusändringar

Automatisera affiliatearbetsflöden

Bygga realtidsdashboards

Synkronisera data med externa system

Nyckelfunktioner

Realtidsleverans

Händelser levereras inom millisekunder efter att de inträffat

Säker verifiering

HMAC-signaturverifiering för autentiska förfrågningar

Automatiska återförsök

Smart återförsökslogik med exponentiell backoff

Konfigurerbara händelser

Välj vilka händelser du vill ta emot för ditt användningsfall

Tillgängliga webhook-händelser

Här är de webhook-händelser som kommer att vara tillgängliga i vårt omfattande system:

conversion.createdHög volym

Realtid

Utlöses när en ny spelarkonvertering spåras

payment.processedKritisk

Månadsvis

Skickas när affiliatebetalning har behandlats framgångsrikt

campaign.activatedKampanj

Vid behov

Avisering när ny kampanj går live

deal.updatedDeals

Vid behov

Skickas när casinodealvillkor ändras

account.suspendedKonto

Vid behov

Viktig avisering när kontostatus ändras

bonus.expiredBonus

Dagligen

Avisering när spelarens bonusvillkor löper ut

Exempel på webhook-payload

conversion.created-händelse

{
  "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": "US",
      "currency": "USD"
    },
    "commission": {
      "amount": 125.50,
      "currency": "USD",
      "rate": 0.35,
      "type": "revenue_share"
    },
    "tracking": {
      "click_id": "click_ghi012",
      "source": "google",
      "medium": "cpc",
      "campaign": "summer_promo"
    }
  }
}

Säkerhet & bästa praxis

Signaturverifiering

Varje webhook-förfrågan inkluderar en HMAC SHA-256-signatur i X-BankRolls-Signature-headern. Verifiera alltid denna signatur för att säkerställa att förfrågan är autentisk.

Verifiera HMAC-signatur
Använd säkra webhook-hemligheter
Validera tidsstämpelns aktualitet

Hantera misslyckanden

Utforma dina webhook-endpoints för att hantera misslyckanden på ett smidigt sätt. Vi kommer automatiskt att försöka leverera misslyckade försändelser igen med exponentiell backoff.

Returnera HTTP 200 för framgång
Implementera idempotens
Hantera duplicerade händelser

Redo att integrera webhooks?

Gå med i vårt betaprogram för att få tidig åtkomst till vårt webhook-system. Hjälp oss att bygga det mest pålitliga affiliateaviseringssystemet i branschen.

Vanliga frågor

Vad händer om min webhook-endpoint är nere?

Vi kommer automatiskt att försöka leverera webhooks igen med exponentiell backoff i upp till 72 timmar. Du kan också manuellt spela upp missade händelser via din dashboard.

Kan jag testa webhooks innan jag går live?

Ja! Vår sandbox-miljö låter dig testa alla webhook-händelser med exempeldata innan du behandlar live affiliatetrafik.

Hur hanterar jag högvolym webhook-trafik?

Vi rekommenderar att du använder ett meddelandeköningssystem för att behandla webhooks asynkront. Vår dokumentation kommer att inkludera arkitekturmönster för högvolymscenarier.

Få ett meddelande när webhook-dokumentationen är klar

Var bland de första att få åtkomst till vårt omfattande webhook-system och dokumentation.