Polar

Add Polar as provider in PayGlue

In your PayGlue dashboard, go to Connection > Polar and follow the steps.

Onboarding Steps

On the right side, you see important steps to set up your connection to run properly.

Create a Webhook Endpoint in Polar

In Polar, go to Settings > Webhooks > Add Endpoint and create a new Webhook. Paste the webhook URL from your PayGlue connection page, set Format to Raw, set expiration to Never, and select the required events.

The format has to be Raw. The signature Polar sends is calculated over the exact bytes of the payload, so any other format reshapes it on the way and the signature no longer matches. Every delivery then fails verification, and the error looks like a wrong webhook secret rather than a wrong format.

Events to select

order.created, subscription.active, subscription.canceled and subscription.revoked.Both subscription.canceled and subscription.revoked remove the membership, and they are different moments: canceled fires when the customer clicks cancel, revoked when access should actually end. Enable both so the behaviour follows Polar.

Copy your Webhook Secret

After saving the endpoint, you get a webhook secret from polar. We need this secret to communicate safely with Polar to add new member to your ghost blog.

Optional: Create an API Token in Polar

In Polar, go to Settings > Preferences > Developers and create a new API token. Set expiration to Never and enable the required scopes.

This step is optional, but it grants some nice features. Our product auto-fetch. If you decide to add a developer key from Polar to PayGlue, we can automatically fetch all products; no manual copy and paste with product_IDs is needed anymore.

Add your webhook secret & (optional) API Token

In your PayGlue dashboard, go to Connection > Polar and paste your secret & token.

Run a health check

Create a test and see if auto-fetch works

In your PayGlue dashboard, go to Installation > Button. Choose Polar and link to a product to auto-fetch your products.