Manage billing and credits

OpenMetal uses prepaid organization credits for managed capacity. Provider usage is deducted from the organization balance. A platform fee applies when credits are purchased.

Welcome credits

Each new user receives a one time USD 500.00 credit grant in the first organization they create. The grant has no purchase fee and cannot be transferred. Additional organizations start with a zero balance.

Purchase credits

The purchase fee is 5.5 percent of the credit amount with a USD 0.80 minimum.

openmetal billing show --organization <organization-id>
openmetal billing quote --organization <organization-id> --amount-usd 20.00
openmetal billing checkout --organization <organization-id> --amount-usd 20.00 --open

You can also add credits from the OpenMetal dashboard. Credits appear after payment confirmation.

Automatic top ups

Owners and admins can save a payment method, then choose a balance threshold, refill amount, and monthly cap.

openmetal billing payment-method --organization <organization-id> --open
openmetal billing auto-topup \
  --organization <organization-id> \
  --enabled true \
  --threshold-usd 10.00 \
  --refill-usd 50.00 \
  --monthly-cap-usd 500.00

A declined payment or required customer action pauses the policy instead of retrying indefinitely. Update the payment method in the dashboard to recover.

Spend behavior

Managed sandbox creation requires a balance above zero. A request without sufficient credits returns insufficient_credits with HTTP 402.

Usage is applied when provider measurements are available. Delayed measurements can temporarily produce a negative balance. If the balance reaches zero and automatic top up cannot run, OpenMetal schedules managed sandboxes to stop.

Some providers report monetary usage directly. Others are calculated from provider runtime measurements and documented rates. The Usage page labels the source and confidence of each amount.

BYOK

BYOK capacity is billed by the provider and does not consume OpenMetal credits. A single explicitly selected BYOK provider without fallback can create capacity without a positive managed balance.

See the billing API reference for request and response schemas.