billing

Billing and credits on Seenode

Present money to users from *Usd fields only (creditBalanceUsd, totalCostUsd, pricePerMonthUsd, totalAmountUsd, etc.). Treat *Cents as the exact ledger unit — do not present it as dollars. Never manually divide or quote ambiguous fields like totalCost, pricePerMonth, or amount as dollars.

Read-only overview (start here)

get_credit_balance()        # prepaid balance (not MTD spend)
get_team_usage()            # unbilled usage + month-end projection
get_spending(range="this_month")   # this_month | last_month | last_7_days | custom
list_billing_orders(page=1)
list_credit_ledger(page=1, kind=null, period_from=null, period_to=null)
get_billing_information()
get_bonus_credit_rate()

For get_spending with range="custom", pass period_start and period_end (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).

Use this skill before paid creates (create_database, paid packages, storage) when balance may be insufficient. Deployment LIMITS often pairs with get_team_limits (see projects) plus credit checks here.

Browser flows (preferred mutations)

Prefer sending the user a URL over handling Stripe secrets in chat:

get_billing_portal_url()                 # manage payment methods / address / tax
create_checkout_session(price=null)      # top up prepaid credits; price in dollars, min 10 when set

Show checkoutSessionUrl / portal URL as a markdown link. Links may be short-lived.

Money mutations (confirm first)

Always summarize what will happen and get explicit approval:

pay_now()                 # settle current unbilled usage against prepaid credits
create_setup_intent()     # returns clientSecret for Stripe.js — avoid unless portal/checkout cannot work

Before pay_now, show get_credit_balance + get_team_usage so the user knows the charge. Prefer get_billing_portal_url / create_checkout_session over create_setup_intent — do not paste or linger on clientSecret in chat; if returned, tell the user to complete setup in a proper Stripe UI rather than treating chat as a card form.