Webhook Documentation
Receive real-time notifications for conversions, payments, and campaign events. Integrate BankRolls webhooks to build responsive affiliate applications and automate your workflow.
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:
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.created
High VolumeTriggered when a new player conversion is tracked
payment.processed
CriticalSent when affiliate payment has been processed successfully
campaign.activated
CampaignNotification when new campaign goes live
deal.updated
DealsSent when casino deal terms are modified
account.suspended
AccountImportant notification when account status changes
bonus.expired
BonusNotification 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.