@gebarbilling/js

Browser-safe GEBARBILLING SDK for checkout, portal, and billing-state workflows.

Install

pnpm add @gebarbilling/js

Quickstart

import { GebarBilling } from "@gebarbilling/js";

const billing = new GebarBilling({
  publishableKey: import.meta.env.VITE_GEBARBILLING_PUBLISHABLE_KEY,
  baseUrl: import.meta.env.VITE_GEBARBILLING_BASE_URL
});

await billing.openCheckout({ customerId: "cus_123", planId: "plan_growth" });

API Summary

openCheckout, openPortal, getBillingState, redirectToCheckout, parseReturnUrl, mountEmbeddedCheckout, and unmountEmbeddedCheckout.

Common Pitfalls

Never pass secret keys to this package. It accepts publishable configuration only.

Security Defaults

• HTTPS is required for baseUrl, checkout URLs, and portal URLs unless allowInsecureHttp is explicitly enabled for local development.
• Browser navigation validates URL schemes before opening checkout or portal links.
• Set allowedRedirectHosts or checkoutDomain before using browser navigation helpers.
• API endpoint paths can be overridden with the endpoints option for custom gateways. Overrides must be relative paths, not absolute URLs.