Polar Integration

Overview

The Polar integration allows you to automatically track customer cancellations from your Polar subscriptions. When a customer cancels their subscription, SeggWat captures the event along with the cancellation reason and any comments they provide.

Features

• Automatic churn tracking - Cancellation events are captured in real-time via webhooks
• Cancellation reasons - See why customers are leaving (too expensive, missing features, etc.)
• Customer comments - Capture verbatim feedback from departing customers
• Churn analytics - View trends, statistics, and breakdowns in the Insights dashboard
• Owner notifications - Get notified when customers leave feedback with their cancellation

Setup Instructions

Step 1: Open the Polar Integration

1. Navigate to your project in SeggWat
2. Go to Integrations in the sidebar
3. Click on the Polar integration card

Step 2: Copy the Webhook URL

In the Polar integration modal, you'll see a unique webhook URL for your project:

https://seggwat.com/hooks/polar/{your-project-key}

Click the Copy button to copy this URL to your clipboard.

Step 3: Configure Polar Webhook

1. Open your Polar Dashboard
2. Go to Settings → Webhooks
3. Click Add Endpoint
4. Paste the webhook URL from SeggWat
5. For Format, select Raw (important!)
6. Under Events, enable:
   • subscription.canceled
7. Click Create

Step 4: Copy the Webhook Secret

After creating the webhook in Polar:

1. Click on the webhook you just created
2. Copy the Webhook Secret (starts with polar_whs_)
3. Return to SeggWat and paste it in the Webhook Secret field
4. Click Save Secret

Viewing Churn Data

Once configured, churn data appears in two places:

Insights → Churn Tab

Navigate to Insights and click the Churn tab to see:

• Total cancellations - All-time count
• Monthly trends - This month vs. last month with percentage change
• Cancellation reasons - Visual breakdown of why customers churn
• Recent cancellations - List of recent events with customer details and comments

Notifications

Project owners receive notifications when customers include comments with their cancellations. This helps you quickly respond to actionable feedback.

Cancellation Reasons

Polar captures standardized cancellation reasons that SeggWat maps to the following categories:

Reason	Description
Too Expensive	Customer finds the price too high
Missing Features	Product lacks features the customer needs
Switched Service	Customer moved to a competitor
Low Quality	Customer is unhappy with product quality
Too Complex	Product is too difficult to use
Unused	Customer no longer needs the product
Customer Service	Issues with support experience
Other	Custom reason provided by customer

Troubleshooting

Webhook Not Receiving Events

1. Verify the webhook URL is correct in Polar
2. Ensure the webhook secret matches (starts with polar_whs_)
3. Check that subscription.canceled event is enabled
4. Confirm the webhook format is set to Raw

Integration Shows "Pending"

The status changes to "Active" after the first successful webhook is received. You can:

• Wait for a real cancellation
• Use Polar's webhook testing feature to send a test event

Invalid Secret Error

If you see a secret validation error:

1. Re-copy the secret from Polar (click to reveal the full secret)
2. Ensure no extra spaces before or after the secret
3. The secret should start with polar_whs_

Data Privacy

SeggWat only stores:

• Subscription ID (for deduplication)
• Customer ID and email (if provided by Polar)
• Cancellation reason and comment
• Timestamp and product name

We do not store payment information or access your Polar billing data.

Next Steps