Polar

Connect Polar as a payment provider in PayGlue.

A
André
Written By AndréLast updated about 6 hours ago

Polar is the first fully supported payment provider in PayGlue.

Prerequisites

  • A Polar account at polar.sh
  • At least one product created in Polar

Steps

1. Add Polar as provider in PayGlue

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

Payglue Polar

Onboarding Steps

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

2. 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 API Version to 2026-04, set expiration to Never, and select the required events.

Note: Polar asks for an API Version when you create the endpoint and offers 2026-04 and 2026-10. Pick 2026-04. That is the version PayGlue was built and tested against. The events PayGlue reads carry the same fields in both versions, so 2026-10 works as well, but 2026-04 is the one we verify every delivery against.

Polar Webhook

Warning: 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.

3. 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.

Polar Webhook Secret

4. 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.

Polar Developer Api

Tip: 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.

5. Add your webhook secret & (optional) API Token

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

Payglue Polar Connected

6. Run a health check

When everything works as expected, you get a green status indicator for Connection Established.

7. 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.

Payglue Polar Autofetch

Was this helpful?

Your feedback shapes what we write next.

Next →

Lemon Squeezy

Related articles

Test membersWhat PayGlue does with purchases made in a provider's sandbox or test mode, and how to tell them apart afterwards.Start hereConnect Ghost memberships to any payment provider in minutes.Labels on a PayGlue memberThe four labels and the note PayGlue writes on a Ghost member, the fifth one that marks a test purchase, what each means, and how to use them for support and filtering.When a membership endsWhat happens in Ghost when a subscription is cancelled, runs out, or the payment fails, and how to check that it worked.