Create or resume an owner's hosted Stripe Checkout

Returns a human payment URL, never charges a saved card. Paid is USD 10/month; each top-up pack is USD 10 before tax; a purchase grants 100 credits per dollar up to USD 100 and 125 credits per dollar for the part above, so 10 packs grant 10000 and 20 packs grant 22500 credits. Top-ups require active Paid access and have no time limit during uninterrupted Paid membership; remaining top-ups expire when the workspace returns to Free. Monthly Paid credits expire at billing-period end without rollover. Retry the same offer, packs and Idempotency-Key after uncertainty. Browser return is not payment proof; read this checkout and the organization balance. A conflicting or existing subscription returns billing_purchase_conflict (409); read the original checkout or request an owner billing portal URL instead of another purchase. Works at zero credits.

post/v1/organizations/{organization_id}/billing/checkouts

Request

  • Base URL: https://app.ohmyho.st
  • URL: https://app.ohmyho.st/v1/organizations/{organization_id}/billing/checkouts
  • Auth: HTTP bearer

Path parameters

organization_idstring required

Headers

X-Request-Idstring

Optional caller-provided correlation identifier.

Idempotency-Keystring required

Identifies one mutation and its canonical request payload.

Request body

offer'topup' | 'paid' required
packsinteger required

Paid requires exactly one pack.

Response

Original checkout and its current provider-observed status.

organization_idstring required
checkout_idstring required
offer'topup' | 'paid' required
state'open' | 'complete' | 'expired' required
payment_confirmedboolean required
urlstring uri nullable required
expires_atstring date-time required
packsinteger required
credited_microsstring required
revoked_microsstring required
paid_untilstring date-time nullable required
required_action'none' | 'complete_checkout' | 'open_billing_portal' | 'contact_support' required

Human payment handoff. Complete the returned Checkout URL, request a fresh billing portal URL to correct billing details, or contact ohmyho.st when tax configuration requires review. none includes a draft invoice awaiting automatic processing; it is not a claim of current Paid coverage. Never infer renewal success from the historical payment_confirmed flag.

Changes

No recorded changes to this operation across all 1 revision of this API.