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). Each subscription serves as a billing contract between the user and your app. Every monday.com account can only have one active subscription per app.
By default, subscriptions are set to automatically renew. If a user chooses not to renew, they must cancel the subscription before its renewal date.
Monitoring via Webhooks
You can monitor subscriptions for your app using monetization webhooks that notify you whenever a user creates, changes, renews, or cancels a subscription. These webhooks provide the following data:
- Plan ID: Unique identifier of the plan tier
- Renewal date: The date the current subscription ends and will renew
- Note: For free plans,
renewal_datewill always be set 10 years in the future.
- Note: For free plans,
- Is trial: Indicates whether the user is currently in a trial period
- Billing period: Monthly or annual billing frequency
- Days left: Number of remaining days in the current subscription
- Pricing version: The subscription's pricing version
Monitoring via Payment Boards
You can also track your app's subscriptions using your shared payment board. After monetization is implemented and your app receives marketplace approval, monday.com will invite you to this board.
Each month, you'll receive a monetization report summarizing relevant subscription activity, including:
- monday account ID
- customer name and ID
- developer name
- vendor ID
- app name and ID
- plan ID
- business event (renewal, 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 designed to support partner 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 your app reaches $200,000 in lifetime accumulated revenue*, the program is activated. From that point on, for every subsequent month:
- 85% of the app's revenue goes to the developer
- 15% is collected by monday.com.
For example: If your app has already generated $200,000 and earns an additional $10,000 in a month, you'll receive $8,500, and monday.com will collect $1,500.
*Accumulated revenue refers to the total lifetime revenue generated by a product, service, or entity over its entire existence, without any deductions for expenses or costs.
Payment Boards
All payments are tracked in monthly reports on dedicated payment boards. For new apps, invitations to payment boards are sent during the first week of the month following the approval of the app. You'll only receive an invitation if your app has any active purchases.
Payouts
Developers receive monthly payouts via Payoneer in USD. Payments are only made for invoices that are up to one year old.
Payment Cycles and Invoice Flow in the Marketplace
Payments are issued on the 1st and 15th of each month.
Invoices reviewed and approved by monday.com’s finance department, at least 7 business days before the payment date, will be included in that cycle. Invoices still under review by that time will roll over to the next cycle.
You can expect your uploaded invoice to be reviewed within 7 business days.
Note: Actual payment may be delayed by up to 5 business days due to external banking processes.
Invoice and Payment Flow
Step 1: Get assigned to the board
You’ll be added to the relevant payments board for the current payment cycle once the new payment month group is created on the payments board and the calculation file is ready. The status will display “Approved to invite vendor.” This indicates you can now upload your invoice.
Step 2: Upload your invoice
Upload your invoice directly to the board. Once uploaded, the status automatically changes to “Invoice uploaded.”
Step 3: Finance review
The finance team reviews your invoice within 7 business days. After approval, the status changes to “Approved by revenue.” No further action is required from you after this step.
Step 4: Bookkeeping review
Approved requests are reviewed by the bookkeeping team as part of the payment preparation process. The status changes to “Process the invoice” in the Finance Billing column, and the Finance column updates to “Upcoming payment.” You’ll see your expected payment date in the Ex. payment date column.
Step 5: Payment issued
Once the payment is processed, the status updates to “Paid.” Funds typically arrive in your Payoneer account within a few business days.
Example: Full Invoice Cycle Statuses
| Step | Status | Description |
|---|---|---|
| 1 | Approved to invite vendor | Added to the payment board |
| 2 | Invoice uploaded | Invoice successfully uploaded |
| 3 | Approved by revenue | Finance review complete |
| 4 | Process the invoice | Under bookkeeping review |
| 5 | Upcoming payment | Awaiting scheduled payout |
| 6 | Paid | Payment issued via Payoneer |
Handling Issues
If there's an issue with your invoice, the finance team will update the status to “Need another check” and leave a comment describing the problem. Once resolved, the review process restarts from the “Invoice uploaded” step.
To ensure timely payments, be sure to review the Marketplace Invoice Guide .
Support
For questions about payment or invoice status:
- Tag @Dana Levy on your payments board
- Or email [email protected]
Billing
Users create a subscription when they sign up for a paid app plan. The price depends on the selected plan and billing period (monthly or annual).
Annual subscriptions are valid for 365 days, while monthly subscriptions are valid for one month from the date of purchase.
For example: A subscription started on March 5th will renew on April 5th.
Plan Changes
Users can update active subscriptions at any time. The expected behavior depends on the type of change:
Type of Change | Expected Behavior |
|---|---|
Plan and billing period change (e.g., monthly → annual, or annual → monthly) |
|
Plan change only |
|
Subscription Renewal
All app subscriptions automatically renew. If a payment method fails on the renewal date, the account enters a 45-day grace period to update the payment information. The app will continue to function during the 45-day period.
If payment is not resolved within 45 days, the app will stop working. Your app will receive the relevant cancellation webhook. Chargebacks may also trigger payment failures.
Uninstalls
Uninstalling an app does not automatically cancel the app subscription. Accounts can reinstall the app before the renewal date to regain access. If reinstalled after the renewal date, the user must purchase a new subscription.
Your app will receive the following webhooks:
| Webhook | When it is received |
|---|---|
app_subscription_cancelled_by_user | When the user manually cancels the app subscription |
app_subscription_cancelled | When the renewal date passes after cancellation |
monday.com Cancellations
If a user cancels their monday.com plan, their app subscriptions will automatically be cancelled.
Your app will receive the following webhook:
| Webhook | When it is received | Reason field |
|---|---|---|
app_subscription_cancelled | When the monday.com plan is cancelled | monday_subscription_cancel_on_renewal |
Refunds
Refunds are handled through the monday.com app marketplace billing system to ensure consistent and transparent processing for both users and developers.
There are two main refund flows:
- Automatic refunds: If a user cancels their app subscription within 30 days of the initial purchase, the refund is automatically applied.
- Manual refunds: For refund requests submitted after the 30-day period, or for special cases, the developer must first approve the refund before it can be processed through the Custom Experience team. Once a refund is issued, the amount will be deducted from your next invoice.
Updated 3 days ago
