Skip to content
How-toForDeveloperHost owner⏱ About 15 min
Before you start:
  • A draft marketplace from BMA staff

Testing your integration ​

BMA staff can give you your marketplace as a draft first. A draft is visible only to BMA staff and to sessions your own host signs, so you can test everything with real screens and no customers.

Steps ​

  1. Embed on a test page that is one of your embed origins (ask BMA staff to add a test origin if needed).
  2. Sign in as three kinds of user and check what each sees:
    • someone with no mp_roles: can browse, can't buy;
    • a buyer: sees Billing and can buy;
    • a host_admin: sees Manage.
  3. Break the token on purpose (wrong secret, old exp, reused jti) and check your page handles mp:session with signed_in: false. The reason tells you which check failed (table).
  4. Call the host API with your key: GET /me, then PUT /customers/<id> for a test customer, then GET /customers/<id>/entitlements.
  5. Add a webhook endpoint, click Send test, and check your server verifies the signature.
  6. Place a test order as the test customer, on a free or invoiced plan BMA staff point you to, and check you get entitlement.granted and that active is true in the entitlements answer.
  7. Ask BMA staff to cancel the test subscription, and check you get entitlement.revoked.

Before you go live ​

0 of 8 done · ·