One-time and recurring donations

Explain donation intervals, recurring subscription states, and self-service controls.

One-time and recurring donations

The public checkout supports one-time donations and recurring subscriptions. A recurring donation can use a weekly, monthly, or yearly interval. A tier selection always creates a one-time donation because tiers have fixed sponsorship amounts.

One-time donations

A one-time donation is charged once and appears in the project’s transaction list after it succeeds. It can be online, in person through SumUp, or manually recorded as offline. One-time online donations can later be refunded by an administrator through the Stripe refund workflow when they meet the refund requirements.

Recurring donations

For recurring giving, the donor chooses an interval and confirms the payment-provider checkout. The resulting subscription creates donation records for successful charges. The dashboard normalizes active subscriptions to a monthly figure for recurring KPIs; the original interval remains part of the donation data.

The donor portal can show:

  • Current amount and interval
  • Project
  • Subscription status
  • Start date and current period end
  • Failed-payment notice
  • Payment-method update action
  • Pause or resume action
  • Amount-change action
  • Cancellation at the end of the current period

The organization can manage subscriptions from /donations/projects/[id]/recurring and the donor can manage their own subscription from the token-protected portal.

Subscription states

  • Active: collection is operating normally.
  • Paused: collection is paused until the donor or organization resumes it.
  • Past due or unpaid: a payment needs attention and the donor should update the payment method.
  • Cancellation scheduled: the subscription is set to end at the current period boundary.
  • Canceled: the subscription has ended.

The exact status shown depends on the payment-provider state synchronized to moschee.io.

Renewal messages

The Notifications tab can enable confirmation emails on monthly renewals. Notices about failed payments and cancellations are sent regardless of that renewal setting. The donor’s selected language and the organization default influence donor-facing messages.

Continue