​

Whop Webhooks

​

What You’ll Learn

• How to configure Whop webhooks
• Supported Whop events
• Email attribution matching
• Testing and verification

​

Before You Start

• DATALYR tracking script installed on your website
• Email capture with datalyr.identify({ email }) before checkout
• Admin access to Whop Dashboard
• Active workspace in DATALYR

​

Supported Events

​

How Attribution Works

1. Whop sends webhook with customer email to DATALYR
2. DATALYR queries events table: “Find visitor_id where email matches”
3. DATALYR retrieves original attribution (fbclid, gclid, UTMs)
4. Event is created with source: 'whop' and attribution data
5. Conversion rules fire postbacks to Meta, Google, TikTok

​

Step 1: Get Webhook URL

1. Log in to DATALYR dashboard
2. Navigate to Sources tab
3. Click Webhooks tab
4. Click Whop card
5. Copy your webhook URL

https://webhooks.datalyr.com/webhooks/whop/YOUR_WORKSPACE_ID

​

Step 2: Configure Whop Webhook

​

Add Webhook Endpoint

1. Log in to Whop Dashboard
2. Navigate to Settings → Developer → Webhooks
3. Click Create Webhook
4. Paste your DATALYR webhook URL
5. Enter a description: “DATALYR Attribution”

​

Select Events

• payment.succeeded
• membership.went_valid
• membership.renewed (optional, for recurring payments)

​

Get Signing Secret

1. Click on the webhook endpoint
2. Copy the Signing Secret
3. Return to DATALYR webhook setup modal
4. Paste the signing secret
5. Click Save

​

Step 3: Verify Setup

​

Test with Live Purchase

1. Visit your site with ad parameters: yoursite.com?fbclid=test123
2. Call datalyr.identify({ email: '[email protected]' })
3. Complete Whop checkout with the same email
4. Check DATALYR Event Stream

• A purchase or subscribe event with source: 'whop'
• Attribution data (fbclid, visitor_id) from original session
• Event value matching Whop amount

​

Check Webhook Delivery

1. Navigate to Settings → Developer → Webhooks
2. Click on your DATALYR webhook
3. View Recent Deliveries
4. Verify status is 200 OK

​

Step 4: Create Conversion Rules

​

Example: Meta Subscribe Event

1. Navigate to Integrations → Conversion Rules
2. Click Create Rule
3. Configure rule:

• Event Name: subscribe
• Event Source: whop

• Platform: Meta Ads
• Event Type: Subscribe

• Use event value from webhook

​

Event Data Structure

{
  "event_id": "whop_payment_abc123",
  "workspace_id": "uuid",
  "event_name": "purchase",
  "source": "whop",

  "visitor_id": "original_visitor_id",
  "user_id": "[email protected]",
  "fbclid": "original_fbclid",
  "gclid": "original_gclid",

  "value": 49.99,
  "currency": "USD",

  "event_data": {
    "payment_id": "payment_abc123",
    "user_id": "user_abc123",
    "plan_id": "plan_abc123",
    "product_id": "prod_abc123",
    "status": "paid"
  }
}

​

Attribution Match Rate

• 95%+ match rate when email is captured before checkout
• 90%+ match rate for cross-device (mobile ad → desktop purchase)
• 85%+ match rate for 30+ day attribution windows

​

Maximize Match Rate

// When user submits email form (before Whop)
document.getElementById('email-form').addEventListener('submit', function(e) {
  const email = document.getElementById('email').value;

  datalyr.identify({
    email: email
  });
});

// Or on landing page if using Whop checkout link
datalyr.identify({
  email: urlParams.get('email') // If email passed in URL
});

​

Value Calculation

• Payments: amount / 100 (Whop uses cents)
• Memberships: Monthly value calculated from billing period
  • Annual: price / 100 / 12
  • Monthly: price / 100
  • Lifetime: price / 100 (treated as one-time)

​

Deduplication

1. Extract event.id from webhook
2. Check if workspace_id:event_id exists in KV
3. If exists, return 200 OK but skip processing
4. If new, process and store in KV

​

Security

1. Extract X-Whop-Signature header
2. Verify signature matches webhook secret
3. Reject invalid signatures with 401 Unauthorized

​

Troubleshooting

​

Events have no attribution data

1. Add datalyr.identify({ email }) on email capture forms
2. Ensure identify call happens before Whop checkout
3. Test by checking Event Stream for identify events with the same visitor_id

​

Webhooks not appearing in Event Stream

1. Check Whop Dashboard → Developer → Webhooks → verify endpoint is active
2. Check Recent Deliveries for errors
3. Verify signing secret in DATALYR matches Whop
4. Test with a new purchase

​

Signature verification failed

1. Get signing secret from Whop webhook settings
2. Return to DATALYR webhook setup modal
3. Paste and save the signing secret
4. Trigger new test event

​

Wrong event value

1. Check event_data.amount in Event Stream
2. Verify billing period for memberships
3. For annual memberships, value is divided by 12 for monthly attribution
4. Contact support if amounts are incorrect

​

What Happens Next

1. Postback Worker checks for matching conversion rules
2. Rules filtered by trigger_event_source: 'whop'
3. Conversions fire to Meta, Google, TikTok with original attribution
4. Ad platforms receive events with fbclid/gclid for optimization

​

Whop Revenue Analytics (Coming Soon)

• Real-time conversion tracking
• Fires events to ad platforms
• No OAuth required

• Dashboard metrics (MRR, ARR, churn)
• Requires OAuth connection
• Periodic data sync via GraphQL API

​

Next Steps

• Create conversion rules for Whop events
• Set up Stripe webhooks
• Set up ClickFunnels webhooks
• Monitor webhook events in Event Stream