Donations

Donations let members choose how much to pay without starting a subscription. They appear beside your paid plans and can optionally benefit access through an entitlement.

Use donations when you want tips, community support, or sponsor-style access. Use one-time payment plans when you want to sell a fixed-price lifetime tier, pass, course, or add-on.

Create a donation path

You can configure one active donation path per server.

From the dashboard, open Donations and select Create Donation. If a donation path already exists, the button changes to Edit Donation.

Set:

• Title: The member-facing name, usually Donations or Support Us.
• Currency: The currency used for this donation path.
• Default amount: The amount members see first in checkout.
• Minimum amount and Maximum amount: The allowed donation range.
• Entitlement: Optional entitlement benefited after payment succeeds. See Entitlements.
• Timed role access: Optional number of days before the access is removed.

The minimum amount must be less than or equal to the default amount, and the default amount must be less than or equal to the maximum amount.

Create from Discord

Admins can also create a donation path from Discord:

/arcalotl donation create

The command accepts optional role and access_duration_days options, then opens a modal for the title, default amount, minimum amount, maximum amount, and currency.

Create from Fluxer

Fluxer accepts the values in one typed command:

/arcalotl donation create name="Donations" default=5.00 min=1.00 max=100.00 currency=usd

Attach an entitlement from the dashboard when donors should receive a role.

Member checkout

Members can start a donation from /donate, /subscribe, or the subscribe channel when one is configured.

In member-facing plan lists, donations show:

• The donation title
• Choose your amount as the price
• A Donate button on Discord or /donate guidance on Fluxer

The checkout page opens with the default amount. Members can edit the amount on the same page before paying. Arcalotl keeps the amount inside the configured minimum and maximum, then refreshes the payment form for the selected amount.

Role access

If the donation path benefits access, Arcalotl applies it after the payment succeeds.

Access can be:

• Permanent: Leave timed role access off.
• Timed: Set a number of days for the donor access.

Members can donate more than once. If timed role access is enabled and the member still has active access, the new donation extends access from the current expiration.

Track donations in the dashboard

The Donations page shows performance for the active donation path:

• Total Donators: Unique members who have completed a donation.
• Total Donated: Successful donation volume in the donation currency.
• Average Donation: Average completed donation amount.

The Recent Donations list shows completed donation records with donator, amount, status, access state, and date. Statuses cover paid, expired, refunded, and disputed donations; pending or failed checkout attempts are not shown.

Quirks

• Donations are one-time payments. They do not renew and do not use payment recovery, cancellation saves, free trials, or upgrade and downgrade hierarchy.
• Donations are not managed through the billing portal because there is no subscription to change or cancel.
• Deleting a donation path stops new donations but keeps previous donation history in the dashboard.
• Refunds and open disputes remove donation access unless the member has another active purchase or subscription that benefits the same access.