Subscriptions
Key facts
- Billing period: monthly/quarterly/annually (depends on plan)
- Messages reset on the same calendar day each month
- Subscription = Stripe product with recurring price + metadata
- Package = Stripe product with one-off price + metadata
Required Stripe metadata
On the product (not price!):
case: "buddy_pro"
messages: 1000
Check subscription status
/getInfoAboutUser:sub_xxx
Shows: renewal date, billing date, message limit, used/remaining messages, extra messages.
Find activation links by email
/getActivationLinks:email
Lists non-activated Stripe subscriptions and packages for the given email. Useful as an alternative to /getInfoAboutUser when you know the user's email and only need to check if they have any Stripe subscriptions they haven't yet activated.