Billing API

CLIMeter handles all billing via Stripe Connect. Builders receive automatic payouts; consumers are invoiced based on their usage. Use the Billing API to manage your Stripe connection and query payouts.

GET /v1/billing/account

Get your billing account status, including Stripe Connect connection state.

Bash

curl https://api.climeter.ai/v1/billing/account \
  -H "Authorization: Bearer <jwt>"

# Response
{
  "stripe_connected": true,
  "stripe_account_id": "acct_1P...",
  "payout_enabled": true,
  "pending_balance_usd": 284.50
}

POST /v1/billing/connect

Generate a Stripe Connect onboarding link. Redirect yourself to this URL to connect your Stripe account.

Bash

curl -X POST https://api.climeter.ai/v1/billing/connect \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"return_url": "https://climeter.ai/dashboard/billing"}'

# Response
{
  "connect_url": "https://connect.stripe.com/oauth/authorize?...",
  "expires_at": "2025-03-07T14:00:00Z"
}

Note

CLIMeter uses Stripe Connect Express. You retain full ownership of your Stripe account and can disconnect at any time. The platform fee (0% on first $1,000, then 4%) is deducted automatically before payouts are transferred.

GET /v1/billing/payouts

List all payouts received.

Bash

curl https://api.climeter.ai/v1/billing/payouts \
  -H "Authorization: Bearer <jwt>"

# Response
{
  "payouts": [
    {
      "id": "pyo_01HXZ",
      "amount_usd": 284.50,
      "net_usd": 273.12,
      "fee_usd": 11.38,
      "status": "paid",
      "period": "2025-02",
      "paid_at": "2025-03-01T06:00:00Z"
    }
  ],
  "total": 1
}

Status	Description
pending	Payout is being calculated for the current period
scheduled	Payout is queued for transfer
paid	Transfer complete — funds in your Stripe account
failed	Transfer failed — will retry automatically

For a full walkthrough of how payments work, see the Payments guide.