Skip to main content

Funding and grants overview

Funding and grants are the account-level value layer and accounting surface.

Prereqs​

Core endpoints (authoritative)​

See OpenAPI for request and response shapes:

Common endpoints include:

  • GET /api/v1/wallet/balance

Direct balance mutation endpoints exist for operator workflows, but are not part of the recommended public integration path.

Preferred ways to add value to an account​

In most products, treat balance increases as the result of explicit commercial flows:

  • Plan-issued credits (for example, periodic credits as part of a billing plan).
  • Grant programs (trials, promotions, enterprise credits).
  • Checkout purchases (for example, one-time credit topups).

Manual adjustments exist as an operational escape hatch. Avoid using them as a normal way to fund customers.

Integration patterns​

  • Read balances to display remaining credits and to preflight spend.
  • Record consumption through your runtime billing path and keep operator actions auditable.

Verify​

  • Balance responds for a known account context.

Next​