Subscriptions, payments, and billing
Subscriptions
Users create a subscription when they sign up for a trial, free, or paid plan with your app (depending on your app's plan tiers). The subscription serves as a billing contract between the user and your app, and every account can only have one active subscription per app.
Each subscription defaults to automatic renewal upon creation. If a user does not want to renew their subscription, they would need to cancel it before its scheduled renewal date.
Tracking subscriptions
One of the easiest ways to monitor subscriptions for your app is through our monetization webhooks that notify you whenever someone creates, changes, renews, or cancels a subscription. These webhooks can retrieve the following subscription information:
- Plan ID: The unique identifier of the plan tier
- Renewal date: The date the current subscription ends and will renew. Please note that for free plans, the
renewal_datewill always be 10 years in the future. - Is trial: Whether or not the user is currently in a trial period
- Billing period: The billing frequency (monthly/annually)
- Days left: The number of remaining days left on the current subscription
- Pricing version: The subscription's pricing version
You can also monitor subscriptions using your app's shared payment board. Once you implement monetization and your app receives marketplace approval, we will invite you to a payment board where you will receive monthly monetization reports. These reports provide the following information about each subscription:
- monday account ID
- customer name and ID
- developer name
- vendor ID
- app name and ID
- plan ID
- business event (renewal, a new subscription, etc.) and creation log
- invoice ID and creation log
- amount without tax
- sum without tax
Payments
Revenue sharing program
The revenue-sharing program is structured to support our partners' growth and incentivize the development of high-quality apps. It has been carefully crafted to ensure that our developers are supported as they scale and to reflect our shared success.
Once an app reaches the milestone of $200,000 in lifetime accumulated revenue*, the revenue-sharing program will be activated. For every subsequent month, 85% of the revenue generated by the app will go to the developer and 15% of the revenue will be collected by monday.com.
For example, say an app has made $200,000 in lifetime accumulated revenue and makes $10,000 in the following month. The app developers will keep $8,500, and monday.com will collect $1,500.
*Accumulated revenue refers to the total amount of revenue generated by a product, service, or entity over its entire existence, without any deductions for expenses or costs.
Payment boards
All payments will be tracked in payment reports on individual boards during the first week of every month. For new apps, invitations to the payment boards are sent during the first week of the month following app approval. The app will only receive an invitation if it had any purchases.
Payouts
Developers will receive monthly payments through Payoneer in USD.
Billing
Users create an app subscription whenever they sign up for a paid app plan. The subscription price varies depending on the plan and the billing period (monthly or annually).
Annual subscriptions are valid for 365 days from the date of purchase, and monthly subscriptions are valid for one month from the date of purchase.
For example: If someone starts a subscription on March 5th, it will renew one month later on April 5th.
Plan changes
Customers can make changes to active subscriptions anytime. The expected behavior depends on the type of change they make:
| Type of change | Expected behavior |
|---|---|
| Plan and billing period change (e.g., monthly to annual, or annual to monthly) | |
| Plan change only |
Subscription renewal
Every subscription automatically renews. If a payment method fails on a renewal date, the account will have a 45-day grace period to change the payment method or resolve the current issue. The app will continue to work during those 45 days. It will stop working after the grace period if a valid payment method hasn't been added.
Your app will receive a webhook for canceling the subscription. A chargeback may cause the payment method to fail on the renewal date.
Uninstalls
App subscriptions are not automatically cancelled when an app is uninstalled. Accounts can reinstall the app before the renewal date to access it again. However, if they decide to reinstall it after the renewal date passes, they must repurchase the subscription.
Your app will receive these webhooks:
| Webhook | When it is received |
|---|---|
app_subscription_cancelled_by_user | When the user cancels the app subscription |
app_subscription_cancelled | When the renewal date passes after the cancellation |
monday.com cancellations
App subscriptions will automatically be cancelled if a user cancels their monday.com plan.
Your app will receive this webhook:
| Webhook | When it is received | Reason field |
|---|---|---|
app_subscription_cancelled | When the user cancels their monday.com plan | monday_subscription_cancel_on_renewal |
Refunds
As part of monetization, monday also handles app subscription refunds. If a user cancels an app within 30 days of the initial purchase, they will get an automatic refund.
If a user requests a refund for any other reason (e.g. over 30 days, refund on a monthly plan), the app developer must first approve the refund. Once approved, the Customer Experience team can issue the refund. The refunded amount will then be deducted from your next invoice.
Join our developer community!
We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎
Updated 2 months ago