Hermos API

Get Hosted Checkout Key

Discover an active hosted publishable key in the requested mode (default test). Live discovery requires HERMOS_LIVE_HOSTED_CHECKOUT=enabled and HERMOS_ENV=production; unavailable live discovery returns the same 404 as a missing key. HERM-73 may enable the flag only after both PR 1b (submission readiness admission) and PR 3 (Migration B) are deployed. Disabling discovery does not revoke an issued key. Returning buyers cannot rediscover their key while discovery is disabled. If you completed payment, you'll get a receipt by email.

GET/hosted_checkout_keys/{reference}

Discover an active hosted publishable key in the requested mode (default test). Live discovery requires HERMOS_LIVE_HOSTED_CHECKOUT=enabled and HERMOS_ENV=production; unavailable live discovery returns the same 404 as a missing key. HERM-73 may enable the flag only after both PR 1b (submission readiness admission) and PR 3 (Migration B) are deployed. Disabling discovery does not revoke an issued key. Returning buyers cannot rediscover their key while discovery is disabled. If you completed payment, you'll get a receipt by email.

Path Parameters

reference*string
Match^[a-z0-9_-]{1,80}$

Query Parameters

by?string
Default"reference"

Value in

  • "reference"
  • "company_id"
mode?string
Default"test"

Value in

  • "test"
  • "live"

Response Body

application/json

application/json

curl -X GET "https://example.com/hosted_checkout_keys/string"
{  "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",  "publishable_key": "string"}