Sell and manage a subscription listing

A marketplace listing can be free, a one-time purchase, or a monthly subscription. A subscription bills the buyer every month, pays the seller for every month, and grants a licence that lasts only as long as the buyer keeps paying — unlike a one-time purchase, whose licence never expires.

Publish a subscription listing

1. Open Marketplace → Seller dashboard and start a listing as usual (App, workflow, script, connector node, or bundle).

2. Under Pricing model, choose Monthly subscription and enter the price per month.

3. Publish. The listing now shows a monthly price, and buyers who check out get a recurring payment rather than a single charge.

Note

A listing has one recurring price. Moving an existing subscriber between price tiers is not supported yet — to change what you charge, publish the new price and let existing subscribers stay on the one they agreed to.

What a buyer gets

The licence runs for the period the buyer has paid for. While it is running, the package installs and updates exactly like a one-time purchase. When the subscription ends, the licence stops granting and the package can no longer be installed or updated — anything already installed keeps running, but it will not receive updates.

When a payment fails

A failed payment does not switch the buyer off:

• The licence keeps working through a grace window, so a card that is retried successfully never causes an interruption. The buyer sees a notice on the package page that the last payment failed.
• If the grace window passes without payment, the licence is suspended: it stops granting, but the record is kept. A later successful payment restores it — the buyer does not have to subscribe again from scratch.

Instance administrators set the length of the grace window under Marketplace Payouts → Fee Settings in the admin console (“Subscription grace period”, seven days by default, maximum 90). Setting it to 0 makes a licence lapse the moment its paid period ends.

Cancel a subscription

1. Open the package in Marketplace and find the Subscription card.

2. Choose Cancel subscription. The card asks when the cancellation should take effect.

3. Pick an effect and confirm:

   • At period end (preselected) — the subscription stops renewing and access continues to the end of the month already paid for. The card shows that date. Nothing is refunded, because nothing is being taken away.
   • Immediately — access ends at once and the unused part of the current month is refunded. The card shows the refund amount before you confirm.

At period end is preselected on purpose: it is the option that moves no money and takes nothing away, so ending a subscription by accident cannot cost anyone their remaining month or trigger a refund they did not ask for.

Cancelling twice does nothing the second time. Choosing Immediately after you already scheduled a cancellation is allowed — that is how you get the unused remainder back if you change your mind about waiting.

Note

The refund figure shown before you confirm is the unused share of the month, counted from now to the end of the paid period. It is shown as an approximate amount because the exact figure is computed by the server when the cancellation runs. The refund appears in the billing history on the card, and reverses the seller’s earnings for that month in the same proportion — see When a month is refunded.

Caution

If the payment provider refuses the cancellation, nothing changes: the subscription is left exactly as it was rather than half-cancelled, and the card says why. An immediate cancellation whose refund the provider rejects reports that too, so it is never mistaken for a refund that went through.

Caution

The subscription belongs to the workspace that paid for it, not to the person who clicked Buy. Any member of that workspace sees the card and can cancel it, which is deliberate: a colleague leaving must not strand a subscription that nobody can end.

What the seller is paid

Every month the buyer pays, the seller earns a payable ledger entry for that month, with the same platform-fee split a one-time sale gets. The fee policy in force at the time of that month is the one applied and recorded, so a fee change affects future months rather than rewriting past ones. A failed month credits nothing.

Sellers see each month as its own entry under Marketplace → Seller dashboard → Earnings.

When a month is refunded

Refunding a single month through the payment provider reverses that month, and only that month:

• Its entry stops being payable, and a matching negative entry records the refund. The platform fee comes back in the same proportion it was charged, so a refund never turns into a cost for the seller.
• If that month had already been paid out, it cannot be taken back — so the negative entry stays payable instead, and the next payout absorbs it.
• Other months are untouched. A subscription earns one entry per month, and a refund is always about one of them.
• The buyer keeps access for the period they paid for. A refund is a correction to money, not a way to end a subscription — cancelling is.