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_date will always be set 10 years in the future.
  • 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

StepStatusDescription
1Approved to invite vendorAdded to the payment board
2Invoice uploadedInvoice successfully uploaded
3Approved by revenueFinance review complete
4Process the invoiceUnder bookkeeping review
5Upcoming paymentAwaiting scheduled payout
6PaidPayment 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:

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)

  • Pay immediately for the new plan
  • Charged only for the new plan minus unused days from the previous plan
  • Renewal date updates to the date of change

Plan change only

  • Renewal date stays the same
  • Charged the prorated difference until renewal
  • Any remaining balance rolls over

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:

WebhookWhen it is received
app_subscription_cancelled_by_userWhen the user manually cancels the app subscription
app_subscription_cancelledWhen 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:

WebhookWhen it is receivedReason field
app_subscription_cancelledWhen the monday.com plan is cancelledmonday_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.