Skip to main content
POST
/
v2
/
billing
/
subscription
/
checkout
Generate Subscription Payment URL
curl --request POST \
  --url https://api.tusky.io/v2/billing/subscription/checkout \
  --header 'Content-Type: application/json' \
  --data '
{
  "plan": "<string>",
  "returnUrl": "<string>"
}
'
{
  "checkoutUrl": "<string>",
  "sessionId": "<string>",
  "plan": "<string>",
  "expiresAt": "<string>"
}
Generate a checkout URL to subscribe using a credit card. The user is redirected to a payment page. On success, the subscription is activated.

Request Body

plan
string
required
Target plan: starter, growth, scale.
returnUrl
string
URL to redirect to after payment completes.

Response

checkoutUrl
string
Redirect URL for payment.
sessionId
string
Payment session ID.
plan
string
Selected plan.
expiresAt
string
Checkout URL expiration (ISO 8601).

Example

curl -X POST https://api.tusky.io/v2/billing/subscription/checkout \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan": "growth", "returnUrl": "https://app.tusky.io/billing/success"}'

Response

{
  "checkoutUrl": "https://checkout.tusky.io/subscribe/session_xyz789",
  "sessionId": "session_xyz789",
  "plan": "growth",
  "expiresAt": "2026-03-07T15:30:00Z"
}