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"
}