Create a checkout session

POST

/api/billing/create-checkout

Starts a hosted payment-provider checkout session for the authenticated tenant to subscribe to a paid plan. Returns a URL the tenant is redirected to in order to complete payment.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Checkout session created.

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/billing/create-checkout' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "plan_id": "starter",
    "currency": "nok"
}'

Response Example

200 - Example 1

{
    "url": "https://checkout.example.com/session/abc123",
    "session_id": "cs_test_abc123"
}

Modified at 2026-07-08 19:01:40

List subscription plans

Create a billing portal session