---
title: "Credits and top-ups"
description: "How managed calls reserve points, settle charges, and obtain more credit."
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tooluse.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits and top-ups

<p>Bring-your-own service connections are not billed by Tooluse.net. Platform-backed connections spend account-shared points and must reserve enough credit before any provider request.</p>
<h2 id="ledger-entries">Ledger entries</h2>
<table>
<thead>
<tr>
<th>Kind</th>
<th>Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>grant</code></td>
<td>Operator-issued credit lot</td>
</tr>
<tr>
<td><code>purchase</code></td>
<td>Verified self-service credit lot</td>
</tr>
<tr>
<td><code>reserve</code></td>
<td>Credit held before a managed invocation</td>
</tr>
<tr>
<td><code>settle</code></td>
<td>Successful invocation keeps the reserved allocation</td>
</tr>
<tr>
<td><code>release</code></td>
<td>Failed invocation restores eligible reserved credit</td>
</tr>
<tr>
<td><code>adjust</code></td>
<td>Reversal such as unused refunded credit</td>
</tr>
</tbody>
</table>
<p>The UI displays one point per 10,000 USD micros. Read <code>GET /v1/applications/{appId}/credits</code> for balance, reservations, expiry, and recent ledger entries.</p>
<h2 id="top-up-flow">Top-up flow</h2>
<ol>
<li><code>GET /v1/topups/applications/{appId}/quote</code> returns authoritative packs and <code>checkoutAvailable</code>.</li>
<li>A signed-in owner may open a Stripe checkout only when <code>checkoutAvailable</code> is true.</li>
<li>Credit is issued from a verified webhook fact, never from a browser redirect.</li>
</ol>
<p>Automatic top-up is owner-only, off by default, and requires separate payment-method authorization plus a threshold and monthly cap. Availability depends on server configuration.</p>
<h2 id="failure-behavior">Failure behavior</h2>
<p>Insufficient managed credit returns <code>402</code> before the provider call. An <code>UNKNOWN</code> outcome keeps its reservation until explicit reconciliation; it is not retried with a new call.</p>
<h2 id="see-also">See also</h2>
<ul>
<li><a href="/operate/limits">Limits and reconciliation</a></li>
<li><a href="/operate/errors">Errors and retries</a></li>
</ul>

Source: https://help.tooluse.net/operate/credits/index.mdx