Wallet and spending

Add funds, understand charges and control spending across your agents.

View Markdown

Add funds once and use them across Scrollport tools. Each run temporarily reserves an estimate; you pay the final cost when it succeeds.

Add funds

Connect your first agent to receive $1 trial credit. This is awarded once per user, in your personal workspace, after you authorise the connection.

Workspace owners and admins can choose Top up on the Wallet page. Top-ups start at $10, your balance never expires, and there are no monthly fees or ongoing minimum spend. Signing in or adding a payment card alone does not add funds.

Optional auto top-up

Auto top-up is off until a workspace owner or admin explicitly enables it in Top up → Auto top-up. Choose a saved card, a balance trigger and an amount to add (at least $10, in whole dollars), then authorise the recurring card charge. Agents cannot enable or change it.

A successful run charge can trigger a top-up when the settled balance falls below your chosen trigger. A reservation, failed run or balance check cannot trigger a card charge. Funds are added only after the payment succeeds. A payment failure pauses auto top-up until a human reviews the card and enables it again.

Auto top-up replenishes the wallet; it does not raise your daily spending cap or approve a run above your approval threshold. Leave it off when you want spending limited to the funds you add manually. The daily cap controls tool spending, not the size of a top-up payment.

Know what is available

  • Balance: the funds in your wallet.
  • Reserved: funds set aside for runs still in progress.
  • Available: your balance minus reserved funds; this is what you can spend now.

When a tool succeeds, Scrollport charges its final cost and releases any unused reservation. If it fails, the full reservation is released and you are not charged. Check Wallet activity for each run's final charge.

Set spending controls

Open Spending controls on the Wallet page:

  • Approval threshold: runs above this amount need your approval. It applies to each run, not a whole workflow with several tools.
  • Daily cap: caps spending across all agents, including successful charges and funds still reserved. It resets at midnight in your workspace owner's profile timezone.

Choose Ask for approval above $X or Never ask for the approval threshold, and $X per day or No daily cap for the daily cap. Only signed-in workspace owners and admins can change these controls; agents can read them but cannot change them or add funds.

Review an approval

Your agent shows the estimate and an approval link when a run exceeds the approval threshold. Review it in the browser and approve or decline. No funds are reserved while the request waits for your decision.

Approval checks the current balance and daily allowance before the same run starts. Declining leaves your wallet unchanged.

When a run cannot start

If available funds cannot cover the estimate, top up or reduce the request. If the daily allowance is too low, wait for the next reset or review your daily cap. No new run starts or charge occurs while either check fails.

Unused reservations restore daily allowance when released. Funds still reserved continue to count after midnight. The reset uses the workspace owner's saved timezone, with UTC as the fallback.

Read approvals for the decision flow or the wallet reference for API fields and exact values.

Wallet and spending — Scrollport