PolarBilling

Polar provisioning and the Polar provider in one call.

Source: packages/paykit-polar/src/PolarBilling.ts Kind: Primitive · Product: Polar

Polar provisioning and the Polar provider in one call.

PolarPrices creates the products, meters and prices the catalog states; Polar(props) turns those products into the provider the billing stack validates. A deployment always needs both, and the tier map is the same in both, so this joins them once instead of making the user repeat it.

When webhookSecret is omitted, the deploy also reconciles the WebhookEndpoint at origin + webhookPath and carries the secret Polar mints at create into the Worker’s environment. The secret stays an Output because the stack program declares it before Polar has minted it: the returned provider’s webhook decoder reads the attribute when a delivery is verified, and a Worker builds its own Polar from the environment, where the secret is a plain Redacted. Supplying webhookSecret keeps the endpoint managed by hand, exactly as before, and creates nothing.

The token is resolved once for both halves. A supplied accessToken wins; otherwise the Credentials layer polarProviders() supplies resolves POLAR_API_KEY or the selected ALCHEMY_PROFILE. The provider exposes the resolved token as accessToken, so a deployment can put it in the Worker’s environment, where no profile store exists.

A Polar product id is minted by Polar, so the join cannot be a plain string at declaration time: the provider carries the Outputs PolarPrices returned and resolves one at the moment a checkout or a webhook needs it.

The two primitives stay exported: use PolarPrices when the provider is configured elsewhere, and Polar when the product ids are written by hand.

Selling a catalog through Polar

const polar = yield* PolarBilling("Polar", {
  origin: "https://app.example.com",
  tiers: {
    pro: {
      price: proPrice,
      usage: { messages: { amount: 2, currency: "usd" } },
    },
  },
});

yield* Paykit.BillingStack("Billing", { catalog, providers: [polar] });
// The Worker receives `polar.accessToken` and `polar.webhookEndpoint.secret`,
// plus the ids in `polar.sold`.