Skip to main content

Webhook Documentation

Receive real-time notifications for conversions, payments, and campaign events. Integrate BankRolls webhooks to build responsive affiliate applications and automate your workflow.

Coming Soon

Webhook Documentation In Development

Our webhook system is currently being enhanced with advanced features and comprehensive documentation. We're building the most reliable and secure webhook infrastructure for affiliate notifications.

Expected Release: Q2 2024 | Features: Real-time events, retry logic, signature verification | Status: Beta Testing

What Are Webhooks?

Webhooks are HTTP callbacks that BankRolls sends to your application when specific events occur. Instead of polling our API for changes, webhooks push real-time notifications directly to your server, enabling you to:

Get instant conversion notifications
Receive payment confirmations
Track campaign status changes
Automate affiliate workflows
Build real-time dashboards
Sync data with external systems

Key Features

Real-time Delivery

Events delivered within milliseconds of occurrence

Secure Verification

HMAC signature verification for authentic requests

Automatic Retries

Smart retry logic with exponential backoff

Configurable Events

Choose which events to receive for your use case

Available Webhook Events

Here are the webhook events that will be available in our comprehensive system:

conversion.createdHigh Volume
Real-time

Triggered when a new player conversion is tracked

payment.processedCritical
Monthly

Sent when affiliate payment has been processed successfully

campaign.activatedCampaign
As needed

Notification when new campaign goes live

deal.updatedDeals
As needed

Sent when casino deal terms are modified

account.suspendedAccount
As needed

Important notification when account status changes

bonus.expiredBonus
Daily

Notification when player bonus terms expire

Sample Webhook Payload

conversion.created Event

{
  "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"
    }
  }
}

Security & Best Practices

Signature Verification

Every webhook request includes an HMAC SHA-256 signature in the X-BankRolls-Signature header. Always verify this signature to ensure the request is authentic.

  • Verify HMAC signature
  • Use secure webhook secrets
  • Validate timestamp freshness

Handling Failures

Design your webhook endpoints to handle failures gracefully. We'll automatically retry failed deliveries with exponential backoff.

  • Return HTTP 200 for success
  • Implement idempotency
  • Handle duplicate events

Ready to Integrate Webhooks?

Join our beta program to get early access to our webhook system. Help us build the most reliable affiliate notification system in the industry.

Frequently Asked Questions

What happens if my webhook endpoint is down?

We'll automatically retry webhook deliveries using exponential backoff for up to 72 hours. You can also manually replay missed events through your dashboard.

Can I test webhooks before going live?

Yes! Our sandbox environment allows you to test all webhook events with sample data before processing live affiliate traffic.

How do I handle high-volume webhook traffic?

We recommend using a message queue system to process webhooks asynchronously. Our documentation will include architecture patterns for high-volume scenarios.

Get notified when webhook documentation is ready

Be among the first to access our comprehensive webhook system and documentation.

BankRolls Webhook Documentation | Real-time Event Notifications | Bankrolls