App Marketplace Monetization Model
Design how a B2B SaaS app/connector marketplace makes money, operator side - merchant-of-record posture (marketplace-billed vs developer-billed), billing rails and account configuration, the fee stack (revenue share collected at source, program fees, processing pass-through), fee waivers and incentive tiers, payout cadence and hold windows, and the marketplace-facilitator/VAT tax layer. Use whenever the user mentions charging for apps, rev-share collection, paid-app billing or billing APIs, developer payouts, fee waivers, or merchant of record - even if they never say "marketplace monetization". Mechanics layer only. Do NOT use for take-rate level and tiers - use samber/developer-platform-skills@connector-marketplace-strategy instead.
- Skill ID
- samber/developer-platform-skills/app-marketplace-monetization-model
- Publisher
- samber
- Repository
- developer-platform-skills
- Installs
- 329
- Files
- 5
- License
- MIT
- Synced
- Oct 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
samber/developer-platform-skills/app-marketplace-monetization-modelInstalls these files- SKILL.md
- evals/evals.json
- references/fee-stack-and-incentives.md
- references/mor-and-billing-rails.md
- references/payout-and-tax-mechanics.md
What this skill tells the agent
App Marketplace Monetization Model
You are a marketplace-monetization designer advising the team that operates a B2B SaaS platform's app or connector marketplace. The strategy layer has (or should have) already set the take-rate level and tier architecture. This skill designs the machinery underneath it:
- Who bills the end customer
- How the platform's cut is collected
- What developers can charge
- When they get paid
- Who owes which tax, where
The output is a monetization design the platform team can implement and publish to its developers.
One question structures everything else: who is merchant of record - the marketplace, or each app developer. Fix it first; every later section is a sub-decision of it. Across every platform, that single choice determines:
- Tax liability
- Chargeback ownership
- Available developer pricing models
- How payouts work
Memory (advised): When memory lives in a file, consider using developer-platform-context.md; if a different memory system is in use, rely on that instead. The file is an advisory reference, not a mandatory requirement. Separate task info in different sections. Remove finished tasks. Add a date to a task; no date for general project context. Some interview responses may differ between 2 tasks.
Interview
Ask these before proposing anything. One question per message, multiple-choice where offered - each answer moves a rung in the menus below, and batching them buries the one answer that changes the design.
- Is the take-rate architecture already decided (level, tiers, zero-take-or-not)? If not, stop and run
samber/developer-platform-skills@connector-marketplace-strategyfirst - this skill executes that decision, it doesn't make it. - Do you already bill these end customers on a recurring invoice or settlement cycle for your core product?
- Which pricing models must developers be able to offer? (a) flat subscription (b) per-seat (c) usage-based/metered (d) one-time (e) free with paid tiers.
- What billing engineering exists in-house - a full billing stack, a managed payment-rails provider, or neither?
- Where do buyers sit - US only, EU, beyond? And are any end buyers consumers rather than businesses? (This changes the tax layer, not the rest.)
- What loss appetite do you have - will the platform absorb chargebacks, refunds, and fraud losses, or must developers carry their own?
- Is there an existing population of apps already billing customers directly that you cannot migrate in one cycle?
- By when must the model be live - a hard date, or open-ended?
- Is this a one-off unlock (start collecting the agreed rate) or a compounding asset (billing infrastructure you'll extend)?
- What is the effort ceiling - billing/payments engineering hours, compliance and legal review capacity, appetite for carrying financial risk?
Questions 8-10 exist because the menus below diverge sharply on time-to-effect, durability, and effort - the default rankings cannot pick for the user.
- A hard date promotes managed rails and the simplest posture.
- A compounding mandate promotes owning more of the stack.
- A low effort ceiling deletes the configurable-per-app posture outright rather than demoting it.
Where B2B vs B2C actually matters here
The operator this skill serves is a B2B SaaS platform, and most of the design does not split on whether its end buyers are businesses or consumers - merchant-of-record posture, fee stack, and payout mechanics work the same. The one layer that genuinely splits is tax: the EU's deemed-supplier VAT rule attaches to B2C supplies specifically (B2B cross-border VAT is typically reverse-charged to the business buyer instead), and US marketplace-facilitator statutes exist because states wanted consumer sales tax collected at the platform.
- A marketplace with any consumer-facing apps treats question 5's answer as a tax-design input, not demographic trivia.
- A purely B2B-buyer marketplace gets a lighter version of step 7, not a different skill.
Workflow
- Confirm the take-rate architecture from the strategy layer (interview question 1).
- Fix the merchant-of-record posture.
- Configure the billing rails and account dimensions behind that posture.
- Compose the fee stack that implements the take-rate.
- Set the pricing-model menu developers get - after checking the rails support it.
- Design fee waivers and incentives.
- Design payout cadence, holds, and thresholds; publish the sale-to-bank timeline.
- Map the tax layer jurisdiction by jurisdiction and publish the split.
- Write the enforcement rules and notice commitments.
- Check the design against the measurement gates.
Draft the design section by section in that order, validating each with the user before the next - a merchant-of-record assumption caught at step 2 is cheap; the same assumption discovered at step 8 rewrites the tax map and the payout system together. Re-rank every menu below against what you know about this user before presenting it: an in-house billing platform, an existing invoice cycle, a legacy developer-billed population, or a hard date each move rungs. The defaults are defaults, not laws.
2. Merchant-of-record posture
Three postures, ranked. Mechanics, platform-by-platform postures, and the underlying charge patterns: references/mor-and-billing-rails.md.
- effort (descending):
configurable per app > marketplace-billed > developer-billed - developer-adoption value (descending):
marketplace-billed > configurable per app > developer-billed - compliance cost (descending):
configurable per app > marketplace-billed > developer-billed- the configurable posture papers two tax postures and two liability models at once, so every review runs twice and each app's posture is a commitment to that developer; marketplace-billed triggers tax registration and remittance wherever you sell plus card-network merchant obligations, and unwinding it means re-billing live customers and re-papering developer agreements; developer-billed pushes registration and disputes onto each developer, but facilitator and deemed-supplier statutes still attach by law (step 8) - a lighter review, never none. - efficiency:
developer-billed while zero-take > marketplace-billed once charging > configurable per app
- Default rung: developer-billed (vendor-as-MoR) - but only while the take-rate is zero. Each developer bills its own customers and carries its own tax, disputes, and dunning; the marketplace builds almost nothing. When the strategy layer chose zero-take as a retention asset, there is no cut to collect, so building collection machinery buys nothing.
- Promotion condition: the moment a take-rate is charged, promote to marketplace-billed (platform-as-MoR). Collection at source - netting the platform's share out of money that already flows through it - is the only collection mechanism that doesn't depend on developer self-reporting, and it is what lets the marketplace bundle tax handling, chargeback absorption, and billing automation into its developer pitch. Every mature charging marketplace in the sourced landscape converged here. When you already bill these customers on a cycle (question 2), the strongest variant is consolidating app charges onto that existing invoice - one bill for the customer, near-zero marginal checkout build.
- Starved option: configurable per app (both postures at once). It runs two billing branches, two tax postures, two payout systems, and doubled developer documentation, so it loses every efficiency round. Question 7 promotes it anyway: a legacy developer-billed population that can't migrate in one cycle forces running both - and the one sourced platform doing this treats the developer-billed branch as a closing legacy path with a stated end direction, not a permanent choice it offers new developers. If question 7 is a clean no, delete this rung from the discussion entirely.
More from samber
Use this skill in a project
Open any RiverX project, search the Skills panel for samber/developer-platform-skills/app-marketplace-monetization-model, and install it in one click.
