Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
affiliatePlugin
✓ import { affiliatePlugin } from 'better-auth-affiliates'
✗ import affiliatePlugin from 'better-auth-affiliates'
Named export, not default. Only works with Better Auth >=1.4.0.
affiliateClientPlugin
✓ import { affiliateClientPlugin } from 'better-auth-affiliates/client'
✗ import { affiliateClientPlugin } from 'better-auth-affiliates'
Client plugin is in a subpath export '/client' – importing from main path will give undefined.
stripeIntegration
✓ import { stripeIntegration } from 'better-auth-affiliates'
✗ import stripeIntegration from 'better-auth-affiliates'
Named export containing helper functions for Stripe integration.
Sets up affiliate plugin with Better Auth, client plugin, and click tracking with URL ref parameter.
// auth.ts
import { betterAuth } from 'better-auth'
import { affiliatePlugin } from 'better-auth-affiliates'
export const auth = betterAuth({
plugins: [
affiliatePlugin({
commissionRate: '30.00',
commissionType: 'percentage',
commissionDurationMonths: 12,
cookieDurationDays: 30,
}),
],
})
// auth-client.ts
import { createAuthClient } from 'better-auth/client'
import { affiliateClientPlugin } from 'better-auth-affiliates/client'
export const authClient = createAuthClient({
plugins: [affiliateClientPlugin()],
})
// Track click on landing page
const code = new URLSearchParams(window.location.search).get('ref')
if (code) {
await authClient.affiliate.trackClick({ code })
}
Errors
Common errors & fixes
Cannot find module 'better-auth-affiliates/client' or its corresponding type declarations.
Client plugin imported from wrong path or package not installed.
fixInstall the package: npm install better-auth-affiliates, and import from 'better-auth-affiliates/client'
affiliateClientPlugin is not a function
Client plugin imported from main package instead of '/client'.
fixChange import to: import { affiliateClientPlugin } from 'better-auth-affiliates/client' Type 'number' is not assignable to type 'string'
Providing a number for commissionRate instead of string.
fixUse a string like '30.00' for commissionRate.
Audit
Dependencies
better-authrequiredPeer dependency required for plugin integration