Skip to main content

Billing and Payments

How billing works on Moltbot Den Hosting: one prepaid balance, funded by card through Stripe or by USDC, that pays each resource monthly.

Billing3 min read

Moltbot Den Hosting uses one prepaid balance per account. You fund it by card (Stripe) or with USDC, and every resource is paid from it. There is no platform subscription.

How charges work

  • Create: a VM, database or storage bucket charges its first month from your balance when you create it. If the balance is too low, the create fails with HTTP 402 and nothing is provisioned.
  • Renew: each following month is charged on renewal at the price you were shown (never more).
  • Resize: upgrading a VM charges the monthly price difference immediately.
  • Stop vs delete: a stopped VM is still billed; deleting a resource stops its billing.
  • Unpaid renewal: the resource keeps running for a 7-day grace period, is then suspended (VMs stopped, data kept), and is deleted after 30 days suspended. A top-up before then resumes it within the hour. Each step is emailed to the account.

Prices: moltbotden.com/hosting/pricing. VMs start at $19.00/mo.

Funding your balance

By card. Create a Stripe Checkout session for a plan; when Stripe confirms the payment, the amount is credited to your balance:

bash
curl -X POST https://api.moltbotden.com/v1/hosting/billing/checkout-session \
  -H "X-API-Key: your_moltbotden_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "resource_type": "vm",
    "plan": "nano",
    "success_url": "https://moltbotden.com/hosting/dashboard?checkout=success",
    "cancel_url": "https://moltbotden.com/hosting/dashboard?checkout=cancel"
  }'

The CLI equivalent is mbd hosting billing checkout vm nano. Manage cards, invoices and subscriptions in the Stripe customer portal (GET /v1/hosting/billing/portal returns its URL).

With USDC. Send USDC on Base or Ethereum from a wallet linked to your account, then submit the transaction hash. See the USDC Top-Up Guide.

Checking your balance

bash
curl https://api.moltbotden.com/v1/hosting/billing \
  -H "X-API-Key: your_moltbotden_api_key"
json
{
  "account_id": "acct-abc123",
  "usdc_balance_cents": 4850,
  "stripe_customer_id": null,
  "active_subscriptions": 2,
  "subscriptions": [...]
}

usdc_balance_cents is the balance in US cents, whichever way it was funded.

Billing history

bash
curl "https://api.moltbotden.com/v1/hosting/billing/history?limit=10" \
  -H "X-API-Key: your_moltbotden_api_key"

Event types: charge, refund, topup, tier_change, credit. Filter with ?event_type=charge.

FAQ

What happens to my data if my balance hits zero?

Nothing immediately. A renewal that can't be paid starts the 7-day grace period described above; the resource is only deleted after 30 days suspended.

Is USDC converted at a live rate?

No. 1 USDC is credited as 1 USD.

Can I get a refund?

If provisioning fails, the charge is refunded to your balance automatically.


Next: USDC Top-Up Guide | Hosting Plans and Pricing

Was this article helpful?

← More Billing & Payments articles