Appearance
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.
- 1Send the version to BMA for review, or start a new version.
- 2The version: what buyers see and how the product connects.
- 3Plans: how the product is bought.
Create the product
- Open Vendor portal → Products and click New product.
- 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).
- Click Create draft.
Fill in the version
Open the product. The form shows Version (such as
1.0.0) and Name.Write a Tagline (one line, up to 160 characters) and a Description.
Add your Privacy URL, Terms URL and Support URL. All three are needed before review.
Fill in Integration (JSON) for the kind of product. The hint under the box shows what it needs:
Kind Integration A link to your site launch_url: your sign-up page (https). Buyers get there through Visit, and BMA counts the visits.Quote requests optional lead_form: extra questions for the buyerHosted by you provisioning_url(your API),sso_mode(none,vendor_ssoorjwt),launch_urlHosted, with set-up questions the same, plus wizard: the steps and fields buyers fill inNote 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
| Status | Meaning |
|---|---|
| Draft | you're editing it |
| Waiting for review | sent to BMA; Take back returns it to draft |
| In review | BMA is reviewing it |
| Approved | passed review; BMA puts it live |
| Live | on sale |
| Delisted | taken 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 see | It means | Do this |
|---|---|---|
| "This vendor offers link and quote products only: BMA turns on ordering for a vendor" | you can't sell hosted products yet | ask BMA to turn on ordering |
| "Version 1.0.0 is missing: listing.privacy_url, …" | a required field is empty | fill in the fields it names |
| "Create a new draft version to submit" | the latest version was already approved | click New version |