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_date will 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, scheduled to launch on September 1st, 2024, 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, and only if the app had any purchases.

Payouts

Developers will receive monthly payments through Payoneer in USD.

Billing

Whenever users sign up for a free or paid plan with an app, they create an app subscription. The subscription price varies based on which plan they subscribe to and whether your app bills monthly or annually. Annual subscriptions are valid for 365 days from the date of purchase. Monthly subscriptions are valid for one month from the date of purchase (e.g., if someone starts a subscription on March 5th, it will renew one month later on April 5th).

If an account upgrades its plan, it will pay for the new plan at the time of the upgrade. The total cost will be the amount of the new plan minus the price of the unused days of the previous plan, and the renewal date changes to the date on which they upgraded.

Renewal

Every subscription automatically renews. When 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. If they have not added a valid form of payment after the grace period ends, the account's app will stop working and get a webhook for canceling the subscription. The payment method failure may occur on the renewal date because of a chargeback.

If an account uninstalls an app, its subscription is not automatically canceled. It will still be valid until the renewal date, so the account can access it at any point by reinstalling the app before that date. The account must repurchase the subscription if they decide to reinstall it after the renewal date passes. That said, the app will get an app_subscription_cancelled_by_user webhook at the moment the user cancels their subscription and an app_subscription_cancelled webhook when the renewal date passes after the cancellation.

If users churn from monday.com, their app subscriptions will automatically be canceled. Your app will then receive the app_subscription_cancelled webhook with the reason field displaying 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! 😎