npm install @chargebee/better-auth

npm install chargebee

import { betterAuth } from "better-auth"
import { chargebee } from "@chargebee/better-auth"
import Chargebee from "chargebee"

const chargebeeClient = new Chargebee({
  apiKey: process.env.CHARGEBEE_API_KEY!,
  site: process.env.CHARGEBEE_SITE!,
})

export const auth = betterAuth({
  // ... your existing config
  plugins: [
    chargebee({
      chargebeeClient,
      createCustomerOnSignUp: true,
      webhookUsername: process.env.CHARGEBEE_WEBHOOK_USERNAME,
      webhookPassword: process.env.CHARGEBEE_WEBHOOK_PASSWORD,
    }),
  ],
})

import { createAuthClient } from "better-auth/client"
import { chargebeeClient } from "@chargebee/better-auth/client"

export const authClient = createAuthClient({
  // ... your existing config
  plugins: [
    chargebeeClient({
      subscription: true, // set false if you only need customer linking
    }),
  ],
})

npx auth migrate

npx auth generate

https://your-domain.com/api/auth/chargebee/webhook

chargebee({
  chargebeeClient,
  subscription: {
    enabled: true,
    plans: [
      {
        name: "starter",
        itemPriceId: "starter-USD-Monthly",
        type: "plan",
        limits: { projects: 5, storage: 10 },
      },
      {
        name: "pro",
        itemPriceId: "pro-USD-Monthly",
        type: "plan",
        limits: { projects: 20, storage: 50 },
        freeTrial: { days: 14 },
      },
    ],
  },
})

subscription: {
  enabled: true,
  plans: async () => {
    const plans = await db.query("SELECT * FROM plans")
    return plans.map((plan) => ({
      name: plan.name,
      itemPriceId: plan.chargebee_item_price_id,
      type: "plan" as const,
      limits: JSON.parse(plan.limits),
    }))
  },
},

await authClient.subscription.create({
  itemPriceId: "pro-USD-Monthly",
  successUrl: "/dashboard",
  cancelUrl: "/pricing",
})

const { data } = await authClient.subscription.list()

const { data: orgSubscriptions } = await authClient.subscription.list({
  query: {
    referenceId: "org_123",
    customerType: "organization",
  },
})

await authClient.subscription.update({
  itemPriceId: "enterprise-USD-Monthly",
  successUrl: "/dashboard",
  cancelUrl: "/pricing",
})

await authClient.subscription.portal({
  returnUrl: "/account/billing",
  fetchOptions: {
    onSuccess: (ctx) => {
      window.location.href = ctx.data.url
    },
  },
})

organization: { enabled: true }

chargebee({
  // ...
  onCustomerCreate: async ({ chargebeeCustomer, user }) => {
    console.log(`Customer ${chargebeeCustomer.id} for user ${user.id}`)
  },
})

getCustomerCreateParams: (user) => {
  const [firstName, ...rest] = (user.name ?? "").split(" ")
  return {
    first_name: firstName || undefined,
    last_name: rest.join(" ") || undefined,
  }
},

npx auth generate

I'm integrating Chargebee with Better Auth. Generate a complete auth.ts file that:
- Initializes the Chargebee SDK using CHARGEBEE_API_KEY and CHARGEBEE_SITE env vars
- Adds the chargebee plugin with createCustomerOnSignUp enabled
- Configures webhookUsername and webhookPassword from env vars
- Defines two plans: "starter" (itemPriceId: "starter-USD-Monthly", 5 projects, 10 GB storage)
  and "pro" (itemPriceId: "pro-USD-Monthly", 20 projects, 50 GB storage, 14-day free trial)
My database adapter is [Prisma / Drizzle / Kysely — fill in yours].

Generate auth-client.ts for a Better Auth + Chargebee integration.
Include the chargebeeClient plugin with subscription enabled.
The base URL for the auth server is /api/auth.

I'm about to run `npx auth migrate` after adding the Better Auth Chargebee plugin.
What tables and columns will be added or modified in my schema?
My adapter is [Prisma / Drizzle / Kysely — fill in yours].
List every change so I can review it before applying.

After running `npx auth migrate` for the Better Auth Chargebee plugin I'm seeing this error:
[paste error here]
My adapter is [Prisma / Drizzle / Kysely] and my database is [Postgres / MySQL / SQLite].
What went wrong and how do I fix it?

Write a TypeScript utility that verifies incoming Chargebee webhook requests using
HTTP Basic Auth. Read the expected username and password from
CHARGEBEE_WEBHOOK_USERNAME and CHARGEBEE_WEBHOOK_PASSWORD env vars.
Return 401 if credentials are missing or wrong, and export a reusable middleware
function compatible with [Next.js / Express / Hono — fill in yours].

Write a TypeScript handler for the Chargebee `subscription_cancelled` webhook event
inside a Better Auth project. When the event fires:
1. Find the local user by chargebeeCustomerId.
2. Update their subscription status to "cancelled" in the database.
3. Send them a cancellation confirmation email using [Resend / Nodemailer — fill in yours].
Show the full handler including type definitions for the Chargebee event payload.

Walk me through testing Chargebee webhooks locally with ngrok and Better Auth.
My local dev server runs on port 3000 and my auth base path is /api/auth.
Include the exact ngrok command, the webhook URL to enter in the Chargebee dashboard,
and how to set matching Basic Auth credentials in my .env file.

Using Better Auth with the Chargebee plugin, write a TypeScript function
`requireActivePlan(userId: string, planName: string): Promise<boolean>`
that returns true only if the user has an active or trialing subscription
matching the given plan name. Show how to call it in a Next.js API route
to protect a feature.

Generate a React pricing page component that:
- Displays "Starter" ($9/mo) and "Pro" ($29/mo) cards
- Calls authClient.subscription.create() with the correct itemPriceId on click
- Uses successUrl: "/dashboard" and cancelUrl: "/pricing"
- Shows a loading state while the checkout redirects
- Handles the ALREADY_SUBSCRIBED error by redirecting to the billing portal instead

Refactor the static `plans` array in my Better Auth Chargebee plugin config to load
plans dynamically from a `plans` table. The table has columns:
name, chargebee_item_price_id, limits (JSON), trial_days (nullable).
Use [Prisma / Drizzle / Kysely — fill in yours]. Map the rows to the
shape expected by the plugin and handle the case where the query fails.

I have the Better Auth organization plugin installed alongside the Chargebee plugin.
Show me how to:
1. Enable organization billing in the Chargebee plugin config.
2. Implement authorizeReference on the server so only org owners and admins
   can create or update a subscription for that organization.
3. Call authClient.subscription.create() from the client with customerType "organization"
   and the correct referenceId.

My Better Auth Chargebee webhooks are not reaching the server. Help me debug:
- Chargebee dashboard shows delivery attempts but the server logs show nothing.
- My auth base path is /api/auth.
- I'm running on [Vercel / Railway / a VPS — fill in yours].
Walk me through every layer to check: DNS, routing, middleware, and the plugin config.

A user's subscription status in my database is not updating after they complete
checkout or cancel. My setup uses Better Auth with the Chargebee plugin.
What are the most likely causes and how do I verify each one step by step?
Include how to check whether chargebeeCustomerId and chargebeeSubscriptionId
are populated correctly.