Plans
Manage paid tiers, billing options, and Discord role access.
The Dashboard Plans view manages the same plan model used by Discord commands: a customer-facing tier with one or more billing options.
Donations use a separate Donations dashboard page because members choose the amount at checkout instead of buying a fixed-price tier.
Plan model
- A tier is what members see, such as VIP or Pro.
- A billing option is how that tier is billed, such as monthly, annual, or one-time.
- A role is the Discord role granted while access is active.
Tiers can be recurring or one-time.
Recurring tiers create subscriptions and support:
month: Monthly access.year: Annual access and term optimization offers.
If a recurring tier has both monthly and annual billing, the annual amount must be lower than 12 monthly payments.
One-time tiers use a single purchase price. They can grant permanent access or timed access for a fixed number of days.
See Supported Currencies for the currency codes available when creating plans.
What admins can do
Admins can:
- Create a tier with billing options
- Assign a Discord role
- Set free trial days for new recurring subscribers
- Configure whether one-time plans can be bought more than once
- Configure permanent or timed access for one-time plans
- Edit plan names
- Edit billing amounts
- Configure upgrade and downgrade groups
- Archive plans that should no longer be sold
Archiving a plan stops new purchases. Existing subscriptions keep following their Stripe subscription state, and existing one-time purchases keep their recorded access window.
Upgrade and downgrade groups
The create and edit dialogs include an optional upgrade group and rank for the
tier. All billing options on that tier use the same group and rank. Tiers in the
same group can be switched from /manage or when a member tries to buy another
related tier; lower rank is a downgrade target and higher rank is an upgrade
target. Leave the group blank for add-ons or unrelated tiers that members should
be able to buy separately.
Free trial days apply to new subscriptions created from that tier. A trialing subscription follows Stripe's trial state. By default, trialing members receive the configured Discord role; limited-trial servers can disable trial role access from server settings.
One-time tiers do not use upgrade and downgrade groups. They can be permanent or timed, and they can optionally allow repeat purchases. Timed repeat purchases extend access when the member already has active access for that tier. Permanent one-time plans usually should not allow repeat purchases unless paying again for the same role is intentional.
Stripe objects
When you create a plan through Arcalotl, Arcalotl creates matching Stripe products and prices in the connected Stripe account. When you edit a billing amount, Arcalotl creates a new provider price and updates the local plan reference.
Arcalotl manages the offer, Discord role mapping, and member access experience while the connected Stripe account processes charges, invoices, and payouts.