Managing Subscriptions
View and filter every subscription in your project, inspect payment history, and cancel active or trialing subscriptions.
By the end of this page, you'll know where to find every subscription in your project, how to read its status, and which actions are available.
A subscription is the record created when a member signs up to one of your plans. It tracks which plan was chosen, which payment method was used, the current payment status, the amount paid, and which subscriber it belongs to.
Navigating to Subscriptions. Select a project first (top-left picker), then open Subscriptions from the sidebar. The Subscriptions page is separate from Members — one member can have multiple subscription records over time (original trial, upgrade, re-subscribe after churn).
Filters
The Subscriptions page has URL-routed filter tabs at the top:
Every subscription, regardless of status — active, expired, pending, cancelled.
Only subscriptions with status Active — currently granting paid access.
Subscriptions that have ended — typically after cancellation reached cycle-end, or after a one-time plan's duration lapsed.
Non-recurring subscriptions: lifetime plans, access-code-activated plans, and
any plan with Recurring = off.
An additional Pending filter exists on the global All Project Subscriptions route — it surfaces subscriptions whose payments are still being confirmed by the gateway.
The 13 subscription statuses
MemberPass tracks subscription state using a thirteen-option enum. Each status has its own badge colour so you can scan the list quickly:
| Status | Colour | Meaning |
|---|---|---|
| Active | green | Currently running and paid up. |
| Trialing | yellow | Inside a trial period of the plan. |
| Pending | blue | Payment submitted, awaiting confirmation. |
| Processing | blue | Gateway is processing the payment. |
| Capturable | blue | Payment is authorized but not yet captured. |
| Succeeded | green | Payment completed successfully. |
| Incomplete | orange | Payment hasn't completed in time — manual intervention may be needed. |
| Past Due | red | Renewal payment failed; retry window open. |
| Unpaid | red | Payment failed and retries exhausted. |
| Failed | red | Payment outright failed. |
| Expired | red | Billing period ended and access has stopped. |
| Canceled | zinc | Subscriber or creator cancelled. Access usually continues until the current period ends, then the subscription becomes Expired. |
| Paused | yellow | Temporarily paused by you or the payment provider. |
See Status reference for how these map to member-visible states like "your subscription is paused" or "payment failed".
List columns
Each row on the Subscriptions page shows:
| Column | Content |
|---|---|
| Plan | The plan's name, with the bot avatar and the project name beneath. |
| Payment Method | Provider (Stripe, PayPal, etc.) and its mode (Live / Test), plus the gateway's transaction ID. |
| Status | Colour-coded status badge (one of the 13 above). |
| Amount | Price paid, formatted in the subscription's currency. |
| Subscriber | The member's name and Telegram chat ID. If the subscription hasn't been claimed by a user yet — e.g. an unredeemed access-code-activated record — this reads "Unclaimed Subscription". |
Click a column header to sort by that field (ascending/descending toggle).
Per-row actions
Each row has an ellipsis (⋯) dropdown with these actions:
- View Details — opens a flyout with the subscription's full metadata.
- View Payments — opens a separate flyout listing every individual payment attached to this subscription, with its own pagination (10 per page).
- Cancel — opens the cancellation confirmation modal. Only available for Active or Trialing subscriptions that aren't already cancelled.
- Activity — opens the timeline view showing every tracked event for this subscription.
Cancelling a subscription
Find the subscription in the list. If it's not Active or Trialing, cancellation isn't applicable (you'll see an error toast if you try).
MemberPass queues a CancelSubscriptionJob — a background job that:
- Marks the subscription as cancelled.
- Stops future automatic renewals (for recurring plans).
- Lets current paid access continue until the cycle ends, then flips the record to Expired and removes the member from Telegram resources.
You'll see a toast: "Subscription cancellation queued. The subscription cancellation has been queued and will be processed shortly."
Cancellation doesn't automatically issue a refund. Refunds are handled through your payment provider's own dashboard (Stripe, PayPal, Razorpay, etc.). Decide your refund policy up front and communicate it to subscribers.
The View Payments flyout
Each subscription can have multiple payments — the first checkout, any subsequent renewals, and any adjustments. View Payments opens a paginated list of those, including:
- Payment method used
- Amount and currency
- Payment status (from the same 13-status enum)
- Gateway-side identifiers for looking up the transaction in Stripe/PayPal/etc.
Use it when a subscriber asks "was my last renewal charged?" or when reconciling with your gateway dashboard.
Refunds
MemberPass doesn't process refunds directly — that's always at the provider level:
- Stripe / PayPal / Razorpay / Paystack — issue the refund in their dashboard. The payment status in MemberPass updates to Failed or Canceled on the next webhook event from the provider.
- Crypto providers — refunds must be coordinated manually.
- Access codes — no refund applicable (no money changed hands). Cancel the subscription to revoke access.
Finding subscriptions activated via access codes
Subscriptions created by redeeming an access code are listed like any other — the only giveaway is the provider column: they'll show "Access Codes" instead of Stripe/PayPal/etc. The gateway transaction ID column will typically be empty for these.
Open the detail flyout to see the original access code string that activated the subscription — useful for tracing which campaign or influencer batch the signup came from.
Filter recipes
Frequently asked
Related
- Managing members — the subscribers behind the subscriptions.
- Subscription plans — the plans these subscriptions are instances of.
- Status reference — every status explained in plain language.
- Dashboard analytics — aggregated revenue and retention metrics.