Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Subscription Management

The Subscriptions page shows all recurring billing arrangements with your customers.
Subscriptions List

​
Subscription List

View all subscriptions in a detailed table:
ColumnDescription
StatusCurrent subscription status
ProductProduct name and image
CustomerSubscriber email
AmountSubscription price with currency
IntervalBilling frequency
Next BillingNext charge date
CreatedWhen subscription started

​
Subscription Statuses

Active

Subscription is live and billing normally.

Trialing

Customer is in free trial period.

Past Due

Payment failed, awaiting retry.

Canceling

Cancellation requested, active until period end.

Expired

Subscription has expired.

Canceled

Subscription has been terminated.

​
Billing Intervals

IntervalBilling FrequencyMRR Calculation
WeeklyEvery 7 daysAmount × 4.33
MonthlyEvery monthAmount × 1
QuarterlyEvery 3 monthsAmount ÷ 3
YearlyEvery 12 monthsAmount ÷ 12

​
Filtering Subscriptions

FilterOptions
StatusActive, Trialing, Past Due, Canceling, Expired, Canceled
ProductAny subscription product
IntervalWeekly, Monthly, Quarterly, Yearly
CustomerSearch by email

​
Subscription Details

Click on a subscription to view:

​
Overview

  • Subscription ID
  • Status and status history
  • Product details
  • Pricing and currency
  • Billing interval

​
Billing Info

  • Current period start/end
  • Next billing date
  • Payment method on file
  • Billing history

​
Customer

  • Customer email
  • Account details
  • Other subscriptions from same customer

​
Payment History

  • All charges for this subscription
  • Successful and failed attempts
  • Refunds

​
Managing Subscriptions

​
Cancel Subscription

1

Open Subscription Details

Click on the subscription you want to cancel.
2

Click 'Cancel Subscription'

Find the button in the actions menu.
3

Confirm Cancellation

Cancellation takes effect at the end of the current billing period. The subscription enters “Canceling” status until the period ends, then becomes “Canceled”.
The customer retains access until the end of their current paid billing period.

​
Resume Subscription

For subscriptions in “Canceling” status, a reactivation endpoint exists but currently returns 501 (not yet implemented).

​
Subscription Metrics

​
Statistics Cards

MetricDescription
MRRMonthly Recurring Revenue
ActiveCount of active subscriptions
TrialingCount of subscriptions in trial
CanceledCount of canceled (this period)
ARPUAverage Revenue Per User

​
MRR Calculation

MRR is calculated from all active subscriptions: 
MRR = Σ (Subscription Amount × Interval Factor)

Where Interval Factor:
- Weekly: 4.33
- Monthly: 1
- Quarterly: 0.33
- Yearly: 0.083

​
Failed Payments

When a subscription payment fails:
  1. Status changes to “Past Due”
  2. Automatic retry attempts (3 attempts over 7 days)
  3. Customer notified via email
  4. If all retries fail, subscription may cancel

​
Dunning Emails

Automatic emails sent to customers:
  • First failed payment notification
  • Retry attempt reminders
  • Final warning before cancellation
  • Cancellation confirmation

​
Trial Periods

For products with trials enabled:
FieldDescription
Trial StatusActive trial indicator
Trial DaysTotal trial length
Days RemainingTime left in trial
Conversion DateWhen first charge occurs
Track trial conversions:
  • Trial → Active (converted)
  • Trial → Canceled (churned before conversion)

​
Platform Trial Protection

Waffo Pancake automatically tracks consumer trial history at the platform level. The actual trial days granted to a consumer may be less than the configured value if the consumer has used trials before. This prevents trial abuse without requiring any action from the merchant. For Product Groups with shared trial enabled, trial usage is shared across all products in the group.

​
Subscription Actions

Upgrade or downgrade the subscription to a different product. Note: this endpoint currently returns 501 (not yet implemented).
Send customer a link to update their card on file.