Membership tiers & capabilities
What it is
RIVR membership is capability-based, not a single ladder. A paid membership unlocks specific things you can do — sell event tickets, sell offerings, claim paid jobs, create an organization. The paid tiers grant parallel specialties: Host and Seller are peers (each adds one specialty on top of the free Collaborator baseline), and only the combined tiers hold both. Community, family, and ring groups stay free for any signed-in user; only organization-type groups require a membership.
Parallel, not a strict ladder
A Seller can sell paid offerings but cannot sell paid event tickets; a Host can sell paid tickets but cannot sell paid offerings. Hold Provider or Organization to do both. Gating is per-capability, not "tier ≥ X".
Where it lives
/subscribe— the plan picker (current tier, per-tier value, monthly/yearly) ·src/app/(main)/subscribe/page.tsx/products/membership-{host,seller,provider,organizer,…}— per-tier marketing pages ·src/app/products/**- Capability model ·
src/lib/entitlements.ts· billing/checkout ·src/lib/billing.ts
The tiers
| Tier | Adds | Can sell tickets | Can sell offerings | Claim jobs & badges | Create org groups |
|---|---|---|---|---|---|
| Collaborator (free baseline) | claim paid jobs, earn badges | — | — | ✅ | — |
| Host | + create paid ticketed events | ✅ | — | ✅ | — |
| Seller | + sell paid offerings / listings | — | ✅ | ✅ | — |
| Provider | Host and Seller (both specialties) | ✅ | ✅ | ✅ | — |
| Organization | everything above + create organization-type groups | ✅ | ✅ | ✅ | ✅ |
Steward and Worker are hidden, org-granted, all-capabilities roles tied
to the cooperative's hidden share-class groups. They are not self-serve —
they never appear on /subscribe and can't be purchased; they exist to carry
governance/share membership internally.
Every interaction
- See your current tier —
/subscribemarks the plan you're on and which capabilities each tier gates. - Subscribe / upgrade — pick a tier and monthly or yearly billing; checkout runs on Stripe-hosted Checkout. A separate Connect settlement line item is always added ($2/mo or $24/yr) so the member's payout account is funded.
- Manage billing — open the Stripe billing portal from Account settings to change, cancel, or update payment (see Account & settings).
- Get a payout account automatically — activating any paid tier provisions a Stripe Connect settlement account so you can receive card money (see Wallet & treasury).
Permissions / gating
Capabilities are checked server-side against your active subscription
(active or a live trialing period); no active subscription grants none of
them.
- Claim jobs & earn badges — any paid tier (Collaborator and up).
- Sell paid event tickets — Host, Provider, or Organization.
- Sell paid offerings / marketplace listings — Seller, Provider, or Organization. The listing must also accept card (USD) and the seller's Connect account must be able to receive card money, or creation is blocked (no dead-on-arrival paid listings).
- Create organization-type groups — Organization only. Community, family, and ring groups are free; a subgroup nested under an existing org only needs write access on that org, not a fresh tier.
- Steward / Worker — internal all-capability roles, granted by the org, never self-serve.
Current per-tier pricing is shown live on /subscribe (Stripe price IDs are
environment-configured); the $2/mo · $24/yr Connect settlement surcharge is added
as a separate line at checkout.
Cross-links
- API/MCP:
/api/billingREST ·/api/stripeREST - Wiki: Wallet & treasury · Marketplace & gifts · Calendar & events · Groups & subgroups · Account & settings