Account

Billing and managed usage

ArenAPI uses Stripe for subscriptions, invoices, and customer self-service. Provider compute remains on your provider accounts.

Fixed platform fee plus overage

Every plan includes managed sandbox-hours. Additional time is billed at $0.02 per managed hour. A managed hour measures how long ArenAPI owns the lifecycle of a sandbox, regardless of provider.

Create a checkout session

curl https://arenapi.com/api/v1/billing/checkout \
  --request POST \
  --header "Authorization: Bearer $ARENAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{"plan": "team"}'

Open the returned Stripe URL to subscribe. Checkout includes the plan base price and its metered usage price.

Inspect and manage billing

Operation	Route	Agent tool
Billing status	`GET /api/v1/billing`	`get_billing`
Start checkout	`POST /api/v1/billing/checkout`	`create_billing_checkout`
Open customer portal	`POST /api/v1/billing/portal`	`create_billing_portal`

Stripe configuration

Configure one fixed recurring price and one metered recurring price per plan. The metered price should use the arenapi_managed_sandbox_seconds meter with a free first tier matching the plan allowance and a graduated overage tier.

STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_TEAM_BASE_PRICE_ID=price_...
STRIPE_TEAM_USAGE_PRICE_ID=price_...