How It Works
- You set a threshold: the credit balance that triggers a recharge
- You set a recharge amount: the balance a recharge brings you back up to
- When your balance drops below the threshold, Runcrate automatically charges your default payment method and adds credits
Setup
1
Go to Billing
Navigate to Dashboard → Billing.
2
Find the Auto-Recharge Section
Look for the auto-recharge banner at the top of the billing page.
3
Enable Auto-Recharge
Toggle auto-recharge on.
4
Set Threshold
Enter the credit balance that should trigger a recharge (minimum $20).
5
Set Recharge Amount
Enter the balance to recharge back up to (minimum $50).
6
Save
Click Save to activate.
You must have a default payment method set before enabling auto-recharge.
Keep Hours of Usage
Instead of fixed amounts, auto-recharge can follow what your running instances cost. Set it to keep 24 hours (or any number of hours from 4 to 168) with a monthly limit. In Dashboard → Billing, open auto-recharge and pick Keep N hours running: enter the hours and the monthly limit, which is required, then save. The threshold and recharge amount sit under Advanced. You can also set it by API.- A recharge starts when about a quarter of those hours is left on the balance: 6 hours with Keep 24 hours.
- Each recharge adds about that many hours of usage, so the card is charged about once a day while the usage stays the same.
- Both follow the usage as it changes, checked every few minutes, and never go below the threshold and recharge amount you saved.
- Auto-recharge never charges more than the monthly limit in a calendar month (UTC). When it is reached, nothing more is charged until the next month or until you raise it.
When fixed amounts are small for your usage
If one recharge lasts under 12 hours of what your instances cost, or the threshold lasts under 2 hours, the Billing page says so, with what you use an hour and how often the card is charged. The workspace owner also gets one email about it, with a link that opens Billing on Keep 24 hours. Nothing changes until you turn it on.Configuration Tips
Keep 24 hours does both for you.
Example Configurations
The minimum threshold is $20 and the minimum recharge amount is $50, which are also the defaults. Size both from your burn rate with the tips above, or use Keep 24 hours. When you turn on Keep my GPU running at checkout with a small top-up, the first threshold is set below your new balance (half of it, at least $5), so the first automatic top-up only comes after you have used some of it. After that first top-up, the threshold goes back to the machine's usual one. The checkout shows both amounts before you pay. While auto-recharge is on, that lower threshold is accepted when sent back unchanged; any new threshold needs $20.Disabling Auto-Recharge
To turn off auto-recharge:- Go to Dashboard → Billing
- Toggle auto-recharge off
- Click Save
Auto-Recharge by API
Your programs and agents can read and change auto-recharge too, withGET and PUT /api/v1/billing/auto-recharge, the get_auto_recharge and set_auto_recharge MCP tools, runcrate billing auto-recharge in the CLI, or the SDKs. The API also turns on Keep hours (mode, keep_hours, monthly_cap_usd). Changing it needs the billing permission on the API key or sign-in, and the recharge amount cannot exceed that key’s daily top-up cap. See Top up by API.
Troubleshooting
Auto-recharge did not trigger
Auto-recharge did not trigger
Check that your default payment method is valid and has sufficient funds. Also verify that the threshold is set correctly — the recharge triggers when your balance drops below the threshold, not at exactly the threshold.
Charged multiple times in a short period
Charged multiple times in a short period
If your usage rate is very high, your balance may drop below the threshold again shortly after a recharge. Increase your recharge amount to cover a longer period.
Payment failed
Payment failed
When the bank says to try again (for example the issuer is unavailable), auto-recharge stays on and tries once more 10 minutes later. Any other decline, or a second one, turns auto-recharge off and emails the owner: check your default payment method in the billing settings, update or replace the card, and turn auto-recharge on again. If your bank asks you to confirm the charge, the owner gets an email with a link to confirm it, and auto-recharge comes back on once you do.
Cannot enable auto-recharge
Cannot enable auto-recharge
Make sure you have at least one payment method saved and set as default. Add a payment method first, then enable auto-recharge.