Subscription Eligibility for isPaidUpUntil

Knowledge Base > Subscriptions > Self-Unsubscribe

In Mition, the isPaidUpUntil field is used to determine how long a user is considered financially current. This value influences access control, membership validity, renewal reminders, and other entitlement‑based features. To ensure this calculation remains accurate and reflects genuine financial commitments, the system applies specific rules to different subscription types.

This clarifies how $0 subscriptions behave when they allow users to self‑unsubscribe. This documentation explains the logic behind this rule, why it exists, and how it affects subscription‑based workflows

Subscriptions that meet both of the following criteria:

  • The subscription price is $0, and
  • The subscription has self‑unsubscribe enabled (isSelfUnsubscribeAllowed = true)

are excluded from the isPaidUpUntil auto‑calculation.

In other words, these subscriptions do not extend or influence the date until which a user is considered financially paid up.

Why These Subscriptions Are Excluded

The purpose of isPaidUpUntil is to reflect paid financial entitlement. A subscription that costs nothing and can be cancelled by the user at any time does not represent a financial commitment or a controlled entitlement period.

Including such subscriptions in the calculation could:

  • Incorrectly extend a user’s paid‑up status
  • Override the expiry of a genuine paid membership
  • Cause users to appear financially active when they have not made a payment
  • Interfere with access control or compliance requirements

By excluding these subscriptions, the system maintains an accurate representation of a user’s financial standing.

Example Scenario

A user has the following subscriptions:

  • Annual Membership (Paid) — expires 30 June 2026
  • Newsletter Subscription (Free) — $0 and self‑unsubscribable

Without this rule, the free subscription might incorrectly influence the user’s paid‑up status.
With the rule applied:

  • Only the paid membership contributes to isPaidUpUntil
  • The free subscription is ignored in the calculation

This ensures the user’s financial status is accurate and reflects only paid entitlements.

How the System Applies the Rule

When calculating isPaidUpUntil, Mition:

  1. Reviews all active subscriptions for the user
  2. Identifies any subscription that is:
    • Free ($0), and
    • Self‑unsubscribable
  3. Excludes those subscriptions from the calculation
  4. Uses only paid or non‑self‑unsubscribable subscriptions to determine the final isPaidUpUntil date

This ensures the calculation remains consistent, predictable, and aligned with financial logic.

When This Rule Is Important

This behaviour is particularly relevant for organisations that rely on:

  • Membership validity periods
  • Paid access control
  • Accreditation or compliance timelines
  • Automated renewal reminders
  • Financial reporting based on subscription status

By ensuring only paid commitments influence isPaidUpUntil, the system avoids accidental access extensions or incorrect financial statuses.

Free subscriptions that users can unsubscribe from themselves are intentionally excluded from the isPaidUpUntil calculation. This rule ensures that only genuine paid entitlements determine how long a user is considered financially current. As a result, organisations benefit from more accurate access control, clearer financial reporting, and consistent membership management.