Skip to content
How-toForVendor ownerVendor developer⏱ About 10 min
Before you start:
  • Owner or developer role

Add a product ​

A product starts as a draft. You fill in its first versionVersion One reviewed state of a product’s listing text, requirements and integration. A change means a new version, which BMA reviews again., add at least one 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., then send it to BMA for review.

  1. 1Send the version to BMA for review, or start a new version.
  2. 2The version: what buyers see and how the product connects.
  3. 3Plans: how the product is bought.

Create the product ​

  1. Open Vendor portal → Products and click New product.
  2. Fill in:
    • Name: what buyers see, up to 96 characters.
    • Address (slug): lower-case letters, digits and dashes, starting with a letter, such as acme-crm. It's part of the product's web address and can't be changed later.
    • Kind: what buyers do with it (see kinds of product).
  3. Click Create draft.

Fill in the version ​

  1. Open the product. The form shows Version (such as 1.0.0) and Name.

  2. Write a Tagline (one line, up to 160 characters) and a Description.

  3. Add your Privacy URL, Terms URL and Support URL. All three are needed before review.

  4. Fill in Integration (JSON) for the kind of product. The hint under the box shows what it needs:

    KindIntegration
    A link to your sitelaunch_url: your sign-up page (https). Buyers get there through Visit, and BMA counts the visits.
    Quote requestsoptional lead_form: extra questions for the buyer
    Hosted by youprovisioning_url (your API), sso_mode (none, vendor_sso or jwt), launch_url
    Hosted, with set-up questionsthe same, plus wizard: the steps and fields buyers fill in
  5. Note What changed for the reviewers, and click Save version.

json
{
  "provisioning_url": "https://api.example.com/bma/v1",
  "sso_mode": "jwt",
  "launch_url": "https://app.example.com/"
}

Icons, banners and highlights

The portal edits the text and links. Send your icon, banner, screenshots, highlights and FAQ to BMA staff with your first review; they add them to the listing.

Statuses ​

StatusMeaning
Draftyou're editing it
Waiting for reviewsent to BMA; Take back returns it to draft
In reviewBMA is reviewing it
Approvedpassed review; BMA puts it live
Liveon sale
Delistedtaken off sale; can be sent for review again

Change a live product ​

An approved version can't change. Click New version: it starts a draft copied from the latest version. Edit it and send it for review; the live version keeps selling until the new one goes live.

If something goes wrong ​

You seeIt meansDo this
"This vendor offers link and quote products only: BMA turns on ordering for a vendor"you can't sell hosted products yetask BMA to turn on ordering
"Version 1.0.0 is missing: listing.privacy_url, …"a required field is emptyfill in the fields it names
"Create a new draft version to submit"the latest version was already approvedclick New version