Skip to main content
POST
/
v2
/
billing
/
subscription
/
pay-with-balance
Subscribe with Balance
curl --request POST \
  --url https://api.tusky.io/v2/billing/subscription/pay-with-balance \
  --header 'Content-Type: application/json' \
  --data '
{
  "plan": "<string>"
}
'
{
  "plan": "<string>",
  "status": "<string>",
  "chargedAmount": "<string>",
  "newBalance": "<string>",
  "renewsAt": "<string>"
}
Subscribe to a plan using your prepaid SUI token balance. The subscription cost is deducted from your managed wallet. Renews automatically each period from the same balance.

​
Request Body

​
plan
string
required
Target plan: starter, growth, scale.

​
Response

​
plan
string
Activated plan.
​
status
string
Subscription status (active).
​
chargedAmount
string
SUI deducted for this period.
​
newBalance
string
Remaining SUI balance.
​
renewsAt
string
Next renewal date (ISO 8601).

​
Example

curl -X POST https://api.tusky.io/v2/billing/subscription/pay-with-balance \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan": "growth"}'

​
Response

{
  "plan": "growth",
  "status": "active",
  "chargedAmount": "25.0",
  "newBalance": "30.2",
  "renewsAt": "2026-04-07T14:00:00Z"
}
If your balance is insufficient at renewal time, the subscription transitions to past_due. Top up your balance to avoid service interruption.