Skip to content

Auto-Recharge

Auto-recharge keeps a wallet topped up automatically. When the balance falls below a threshold you set, Stripe charges your payment method and adds a fixed amount to the wallet. Use it to keep agents, Tytus pods, and marketplace tools from stopping mid-task.

1. Open auto-recharge settings

  • Sidebar → Admin → Wallets → Auto-recharge (or /admin/wallets/auto-recharge).

You see every wallet in your active organization with its auto-recharge state: off, or on with threshold and recharge amount.

2. Prerequisites

Before you can enable auto-recharge on any wallet: - The owning organization must have a payment method on file (Stripe). Configure it under Organization settings → Billing. - You need Owner or Admin role on the organization.

If either is missing, the toggle is disabled and the row explains why.

3. Enable auto-recharge on a wallet

  1. Find the wallet's row.
  2. Toggle Auto-recharge to on.
  3. Set:
  4. Threshold — the balance below which a charge fires (e.g. 100 credits).
  5. Recharge amount — how much to add when triggered (e.g. 1,000 credits).
  6. Click Save.

The next time the balance drops below the threshold, Stripe charges the org's payment method and the wallet jumps by the recharge amount.

4. Tune threshold and amount

Re-open the row and edit either value: - Higher threshold = top up earlier, less risk of running out. - Larger amount = fewer charges per month, lower per-charge transaction overhead.

Changes take effect on the next balance check.

5. See what triggered

Each recharge appears in the wallet's transaction history with type auto-recharge, the trigger timestamp, and the amount. Open Admin → Wallets → {wallet} → Transactions to inspect.

6. Charge failures

If Stripe declines the charge: - The wallet is not topped up. - You receive an email at the org's billing address. - Auto-recharge stays enabled — Traylinx retries on the next balance dip.

To stop retries while you fix the card: 1. Toggle auto-recharge off for the wallet, or 2. Update the payment method under Organization settings → Billing.

7. Disable auto-recharge

  1. Toggle the wallet's auto-recharge to off.
  2. The next dip in balance no longer triggers a charge. Existing balance is untouched.

You can disable per-wallet or for the whole org by removing the payment method (which disables auto-recharge everywhere it's enabled).

8. Limits

  • Auto-recharge is per wallet, not global. Each wallet has its own threshold and amount.
  • Threshold and amount are fixed values — there's no percentage-based or rate-aware mode.
  • Frequency is bounded by Stripe's per-card rate limits; large bursts of recharges can be throttled.

For the broader wallets workflow, see Wallet system. For organization-level payment methods and billing setup, see Organization settings.

Mirrored from traylinx-web:docs/user-manuals/billing/auto_recharge.md. Edit the source in the traylinx-web repo — changes here are overwritten by the sync script.