Create Checkout Session

POST

api

public

checkout

curl -X POST "https://app.crovver.com/api/public/checkout" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "user_123",
    "planId": "7b79a62c-e82e-405f-9719-7314f3d6e7f2",
    "provider": "stripe",
    "successUrl": "https://app.com/welcome",
    "cancelUrl": "https://app.com/pricing"
  }'

curl -X POST "https://app.crovver.com/api/public/checkout" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalTenantId": "company_acme_123",
    "externalUserId": "user_admin_456",
    "planId": "7b79a62c-e82e-405f-9719-7314f3d6e7f2",
    "provider": "stripe",
    "successUrl": "https://app.com/welcome",
    "cancelUrl": "https://app.com/pricing"
  }'

{
  "success": true,
  "data": {
    "checkoutUrl": "https://checkout.stripe.com/pay/cs_test_...",
    "sessionId": "cs_test_...",
    "subscriptionId": "sub_crovver_abc"
  }
}

Creates a checkout session with the configured payment provider (Stripe, Khalti, eSewa) and returns a URL to redirect the user to.

Request Body

string

required

The Crovver plan ID to subscribe to

string

The user ID from your application. Required for D2C orgs — becomes the tenant identity.

string

The workspace/tenant ID. Required for B2B orgs.

string

Payment provider name (stripe, khalti, esewa). Defaults to the org’s configured provider.

string

3-letter ISO currency code (e.g. USD, NPR). Defaults to the plan’s first active price currency.

integer

Number of seats to purchase. Required for seat-based plans.

string

Pre-fills the payment provider’s checkout form with this email.

string

Pre-fills the payment provider’s checkout form with this name.

string

URL to redirect to after successful payment. Defaults to the org’s configured success URL.

string

URL to redirect to if the user cancels checkout. Defaults to the org’s configured cancel URL.

object

Arbitrary key-value pairs passed through to the payment provider.

Authentication

Requires a secret key (Authorization: Bearer sk_live_...) or service key (x-service-key + ?orgId=).

curl -X POST "https://app.crovver.com/api/public/checkout" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "user_123",
    "planId": "7b79a62c-e82e-405f-9719-7314f3d6e7f2",
    "provider": "stripe",
    "successUrl": "https://app.com/welcome",
    "cancelUrl": "https://app.com/pricing"
  }'

curl -X POST "https://app.crovver.com/api/public/checkout" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalTenantId": "company_acme_123",
    "externalUserId": "user_admin_456",
    "planId": "7b79a62c-e82e-405f-9719-7314f3d6e7f2",
    "provider": "stripe",
    "successUrl": "https://app.com/welcome",
    "cancelUrl": "https://app.com/pricing"
  }'

{
  "success": true,
  "data": {
    "checkoutUrl": "https://checkout.stripe.com/pay/cs_test_...",
    "sessionId": "cs_test_...",
    "subscriptionId": "sub_crovver_abc"
  }
}

Create Checkout TokenMint a short-lived JWT to initiate the checkout redirect flow.

curl -X POST "https://app.crovver.com/api/public/checkout" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "user_123",
    "planId": "7b79a62c-e82e-405f-9719-7314f3d6e7f2",
    "provider": "stripe",
    "successUrl": "https://app.com/welcome",
    "cancelUrl": "https://app.com/pricing"
  }'

curl -X POST "https://app.crovver.com/api/public/checkout" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalTenantId": "company_acme_123",
    "externalUserId": "user_admin_456",
    "planId": "7b79a62c-e82e-405f-9719-7314f3d6e7f2",
    "provider": "stripe",
    "successUrl": "https://app.com/welcome",
    "cancelUrl": "https://app.com/pricing"
  }'

{
  "success": true,
  "data": {
    "checkoutUrl": "https://checkout.stripe.com/pay/cs_test_...",
    "sessionId": "cs_test_...",
    "subscriptionId": "sub_crovver_abc"
  }
}

Overview

Subscriptions

Checkout

Credits

Add-ons

Capacity (Seats)

Features & Usage

Plans

Tenants

Deprecated

Create Checkout Session

Request Body

Authentication

​Request Body

​Authentication

Request Body

Authentication