billing · version 0.1.0

Create a checkout session

POST /api/billing/checkout

Request

POST https://sourced.sh/api/billing/checkout

Request body

Required.

application/json

type: object
required: plan
properties:
  plan (required): string enum launch | scale
  successUrl: string
  cancelUrl: string

Responses

200

Hosted checkout URL.

application/json

type: object
required: url
properties:
  url (required): string

400

The requested plan or checkout request is invalid.

application/json

Error:
  type: object
  required: error
  properties:
    error (required): string
      Stable machine-readable error code.
    message: string
      Optional human-readable description.

401

403

409

The workspace already has a non-terminal Stripe subscription or is already on the requested active plan.

application/json

Error:
  type: object
  required: error
  properties:
    error (required): string
      Stable machine-readable error code.
    message: string
      Optional human-readable description.

423

Checkout is temporarily locked because live billing is not approved or live Stripe keys are not active in production.

application/json

Error:
  type: object
  required: error
  properties:
    error (required): string
      Stable machine-readable error code.
    message: string
      Optional human-readable description.

501

Stripe checkout is not configured for the selected plan.

application/json

Error:
  type: object
  required: error
  properties:
    error (required): string
      Stable machine-readable error code.
    message: string
      Optional human-readable description.

502

Stripe checkout could not be reached or returned an invalid response.

application/json

Error:
  type: object
  required: error
  properties:
    error (required): string
      Stable machine-readable error code.
    message: string
      Optional human-readable description.

Back to version index