Skip to content
How-toForVendor ownerVendor developer⏱ About 6 min
Before you start:
  • Owner or developer role
  • a product hosted by you

Provisioning and webhooks ​

For a product you host, BMA calls your provisioning API to create, suspend, resume and remove customers' accounts. This page covers the portal side. Your developers will find the API itself in the developer guide.

Set up ​

  1. Open Vendor portal → Provisioning and click Create secret. Copy it at once: it isn't shown again. Every call from BMA is signed with it in the BMA-Signature header.
  2. Under Conformance check, enter Your sandbox URL and the Sign-in mode (Plain link, Your /sso or BMA token), then click Run checks.
  3. Fix anything marked ✕ and run again until you see Passed.
  4. Send the product version for review. BMA approves a hosted product only with a passing run against its provisioning address from the last 90 days.

Replace secret stops the old secret at once, so update your servers straight away.

BMA's calls to your API ​

Calls to your API lists each call: what it was (create, suspend, resume, remove), for which customer and product, its status, the number of attempts and the last error. Slow calls finish when your server posts to the callback address shown at the top of the tab.

  • Send again retries a call that's waiting, or a failed call other than create.
  • Overview counts Calls waiting and Calls failed.

Webhooks ​

BMA posts signed events (product reviews, listings, leads, provisioning results) to your endpoints.

  1. Open Vendor portal → Webhooks, enter the Endpoint URL (https) and click Add endpoint.
  2. Copy the signing secret it shows: it isn't shown again.
  3. Click Send test to queue a test event. Check the BMA-Signature header with the endpoint's secret (see Webhooks).

Remove deletes an endpoint.