Business Guide

Access Model

Business routes are protected by Better Auth session resolution plus role checks:

• Session lookup via BETTER_AUTH_URL/api/auth/get-session
• Required role for business namespace: BUSINESS
• Business ownership checks for privileged operations

Major Route Groups

• Members: GET/POST /business/members
• Balance and funding: GET /business/balance, POST /business/funding/verify
• Analytics: GET /business/analytics
• Reward creation: POST /business/rewards
• Config:
  • GET /business/config
  • PATCH /business/config/general
  • PATCH /business/config/spend
• Tier management:
  • GET/POST /business/config/tiers
  • PATCH/DELETE /business/config/tiers/:tierId
  • GET /business/config/tier-categorization
• API key lifecycle:
  • GET/POST /business/api-keys
  • POST /business/api-keys/:apiKeyId/rotate
  • DELETE /business/api-keys/:apiKeyId
  • GET /business/api-keys/:apiKeyId/referrals
• Events and referral settings:
  • GET/POST /business/events
  • PATCH /business/events/:eventId/status
  • GET/PATCH /business/referrals/settings
  • GET /business/referrals/stats

Data You Control

• Budget constraints (maxEthPerDayPerUser, maxReferralEthPerEvent, maxBonusEthPerEvent)
• Alert thresholds (lowPoolAlertEth)
• Auto-refill toggle
• Reward strategy and anti-abuse referral rules

Next: Campaign Lifecycle