Accounts

Create billing checkout

Creates a hosted checkout session for plan activation or balance top-up.

post/v1/billing/checkout

Request body

target_plan'unpaid' | 'plus' | 'pro' | 'max' | 'null' nullable

Target monthly plan for subscription checkout.

top_up_usd_centsinteger nullable

One-time USD top-up amount in cents.

reasonstring required

Example request

{
  "target_plan": "plus",
  "reason": "Open Tovuk plus checkout."
}

Response

Billing checkout created.

Example response

{
  "checkout": {
    "url": "https://billing.stripe.com/session/example",
    "reason": "Open Tovuk plus checkout."
  }
}

Changes

Changed in 2 of the 50 revisions of this API.22680

Jul 2, 2026024ff3141fd743See the full diff
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became required
  request-property-became-required
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the required property / to the response with the status
  response-required-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 5, 20263985c6090c9118677See the full diff
- ▲
  the request property's maxLength was decreased to 200
  request-property-max-length-decreased
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property's maxLength was unset from 1000 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 1000 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 1000 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 1000 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 240 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 240 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 240 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 240 for the response status
  response-property-max-length-unset
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ●
  the optional response header Retry-After removed for the status 200
  optional-response-header-removed
- ●
  the optional response header Retry-After removed for the status 400
  optional-response-header-removed
- ●
  the optional response header Retry-After removed for the status 401
  optional-response-header-removed
- ●
  the optional response header Retry-After removed for the status 500
  optional-response-header-removed
- ●
  changed the pattern of the request property from ^[\s\S]{1,512}$ to ^[\s\S]{0,8192}$
  request-property-pattern-changed
- ●
  removed the request property
  request-property-removed
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  the request property became optional
  request-property-became-optional
- ○
  the request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  removed the database_unavailable enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the database_unavailable enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the database_unavailable enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the database_unavailable enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_cpu_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_cpu_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_cpu_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_cpu_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_health_endpoint enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_health_endpoint enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_health_endpoint enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_health_endpoint enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_memory_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_memory_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_memory_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_memory_limit enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_port enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_port enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_port enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_port enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_service_name enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_service_name enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_service_name enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_service_name enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_toml enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_toml enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_toml enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_toml enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_command enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_command enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_command enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_command enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_config enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_config enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_config enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_config enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_source_archive enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_source_archive enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_source_archive enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the missing_source_archive enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the payment_required enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the payment_required enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the payment_required enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the payment_required enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the policy_rejected enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the policy_rejected enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the policy_rejected enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the policy_rejected enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 400
  response-property-list-of-types-narrowed
- ○
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 401
  response-property-list-of-types-narrowed
- ○
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 429
  response-property-list-of-types-narrowed
- ○
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 500
  response-property-list-of-types-narrowed
- ○
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 400
  response-property-list-of-types-narrowed
- ○
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 401
  response-property-list-of-types-narrowed
- ○
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 429
  response-property-list-of-types-narrowed
- ○
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 500
  response-property-list-of-types-narrowed
- ○
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
  response-property-pattern-added
- ○
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
  response-property-pattern-added
- ○
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
  response-property-pattern-added
- ○
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
  response-property-pattern-added
- ○
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
  response-property-pattern-changed
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 141 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history