Hermos API

Add a component of the subscription line’s existing plan (seller dashboard)

Flat per-unit licensed seats and plain per-unit metered components support renewal notices. Tiered, package, decimal and special-term components still return notice_unsupported_shape. Validates an active seat or metered price in the same plan and slot, on the subscription processor account. Currency and interval must match. The resulting composition requires the base and permits at most two seat components. Metered components omit quantity. Uses product proration settings without changing the billing date. Requires a merchant person or key; agent approvals and customer sessions are not supported.

POST/dashboard/subscriptions/{subscription}/items

Flat per-unit licensed seats and plain per-unit metered components support renewal notices. Tiered, package, decimal and special-term components still return notice_unsupported_shape. Validates an active seat or metered price in the same plan and slot, on the subscription processor account. Currency and interval must match. The resulting composition requires the base and permits at most two seat components. Metered components omit quantity. Uses product proration settings without changing the billing date. Requires a merchant person or key; agent approvals and customer sessions are not supported.

Authorization

cookieAuth
__Host-hms_session<token>

In: cookie

Path Parameters

subscription*string

Opaque subscription ID.

Match^sbs_[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}$(?![\s\S])

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/dashboard/subscriptions/string/items" \  -H "Content-Type: application/json" \  -d '{    "price": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "string",  "approval": {    "id": "string",    "expires_at": "2019-08-24T14:15:22Z"  }}