Accounts

Create billing checkout

Changed on Jul 2, 2026

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

post/v1/billing/checkout

Request

Base URL
https://api.tovuk.com
Auth
HTTP bearer

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

Jul 2, 2026024ff3141fd7 Revision changes
- breaking
  the request property became not nullable
- breaking
  the request property became required
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the required property / to the response with the status
Jun 5, 20263985c6090c91 Revision changes
- breaking
  the request property's maxLength was decreased to 200
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 1000 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  the response property's maxLength was unset from 240 for the response status
- breaking
  removed the required property / from the response with the status
- warning
  the optional response header Retry-After removed for the status 200
- warning
  the optional response header Retry-After removed for the status 400
- warning
  the optional response header Retry-After removed for the status 401
- warning
  the optional response header Retry-After removed for the status 500
- warning
  changed the pattern of the request property from ^[\s\S]{1,512}$ to ^[\s\S]{0,8192}$
- warning
  removed the request property
- info
  the request property became nullable
- info
  the request property became optional
- info
  the request property's minLength was decreased from 1 to 0
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the database_unavailable enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_cpu_limit enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_health_endpoint enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_memory_limit enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_port enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_service_name enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the invalid_toml enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_command enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_config enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the missing_source_archive enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the payment_required enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the policy_rejected enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  removed the rate_limited enum value from the response property for the response status
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 400
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 401
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 429
- info
  response property checkout_url list-of-types was narrowed by removing types null from media type application/json of response 500
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 400
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 401
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 429
- info
  response property docs_url list-of-types was narrowed by removing types null from media type application/json of response 500
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern ^[\s\S]{0,8192}$ was added for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,1000}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  the response's property pattern was changed from ^[\s\S]{1,240}$ to ^[\s\S]{0,8192}$ for the status
- info
  added the required property / to the response with the status
- info
  added the required property to the response with the status

Operation history