Skip to content
How-toForVendor ownerVendor developerVendor billing⏱ About 5 min
Before you start:
  • Owner or developer role to add plans

Plans and who bills ​

A planPlan A way to buy a product: free, one-time, recurring, per seat, or on request. A plan sets the price, billing cycle, trial and who collects payment. is one way to buy your product. Products that are bought (hosted products, and those set up by BMA) need at least one plan before review. Quote and link products need none.

Add a plan ​

  1. Open Vendor portal → Products and open the product.
  2. Under Plans, fill in:
    • Code: a short id, such as standard. Lower-case, up to 32 characters.
    • Name: what buyers see, such as "Standard".
    • Model, Billed, Price (USD) and Trial days (see below).
    • Paid by: who bills the customer.
  3. Click Add plan.

Models ​

ModelChargedNotes
Recurringevery month or year (Billed)the usual subscription
Per userevery month or year, per userpriced per user
One timeonceset-up work, a licence
Freeneverno price or Paid by
Usageafter each period, per unit useda price per unit, units included free, and a cap per period
Tieredafter each period, by tiersper-unit prices that change with the amount used (see below)

Trial days (0–365) give buyers time before the first charge. A set-up fee, if your agreement has one, is shown in the Set-up fee column; BMA staff add it.

Usage and tiered plans ​

Usage is billed after each period ends, from what you report. Report it with a signed call from your system (Provisioning API: usage); the marketplace team can also enter or correct it.

  • Usage: a price per unit, Included units that cost nothing, and a cap per period.
  • Tiered: up to 10 tiers, each "up to N units at $x each" (plus an optional flat fee), the last one open-ended. Graduated prices each tier's units at that tier's price; Volume prices all units at the tier the total reaches. An optional cap limits a period's charge.

A plan may also have a base price per period, billed in advance as usual.

Paid byWho billsWhere the money goes
Card on your Stripethe card is charged on your Stripe accountstraight to you; set up Stripe in Sales
Your invoicean invoice in your company's namethe customer pays you; record it in Sales
No charge here (you bill outside)you, outside the marketplaceyours
BMA (set by BMA staff)BMABMA pays you the price minus its commission; see Earnings

The first three need ordering turned on for your company. See Take orders and get paid directly and Earnings and payouts.

Prices in host marketplaces ​

A host may add a markupMarkup An amount a marketplace adds on top of the vendor’s price. It can go to the host, to BMA, or be split. on top of your price in its marketplace, but only on plans BMA or the host bills: buyers there see and pay the higher price, and your share is still worked out on your own price. Plans you bill yourself (Paid by your Stripe or your invoice) always show and charge your own price. Per user plans ask the buyer for the number of users at checkout and multiply the price.