Hermos API

Ensure Hosted Checkout Key

Ensure a catalog:read publishable key for the selected company and mode. Live issuance requires HERMOS_LIVE_HOSTED_CHECKOUT=enabled and HERMOS_ENV=production; staging never issues live keys. HERM-73 may enable the flag only after both PR 1b (submission readiness admission) and PR 3 (Migration B) are deployed. Test and live keys coexist for the same company. The flag gates issuance and discovery only: revoke an issued key to stop its use. Product readiness is checked when opening a new checkout.

POST/hosted_checkout_keys/ensure

Ensure a catalog:read publishable key for the selected company and mode. Live issuance requires HERMOS_LIVE_HOSTED_CHECKOUT=enabled and HERMOS_ENV=production; staging never issues live keys. HERM-73 may enable the flag only after both PR 1b (submission readiness admission) and PR 3 (Migration B) are deployed. Test and live keys coexist for the same company. The flag gates issuance and discovery only: revoke an issued key to stop its use. Product readiness is checked when opening a new checkout.

Authorization

cookieAuth
__Host-hms_session<token>

In: cookie

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/hosted_checkout_keys/ensure" \  -H "Content-Type: application/json" \  -d '{}'
{  "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",  "publishable_key": "string"}