Skip to main content

Grants

Grants represent allocations of credits or funds to a billing account, typically used for:

  • trial credits
  • promotional credits
  • enterprise contract credits
  • subscription entitlements and top-up purchases

Exact grant management availability depends on distribution.

Integration considerations​

  • Treat grants as funding sources for wallet balance.
  • Set outstanding_application_policy explicitly on every grant program. Use apply_to_outstanding for subscription and top-up value that can pay accrued usage; use never for promotions that must not pay debt.
  • Plan, campaign, catalog-price, or assignment metadata can override the program policy. The resolved value is copied to the issued grant and does not change later.
  • Avoid building product logic that depends on individual grant lots unless required.
  • Keep operator tooling idempotent and auditable.

Verify​

  • Wallet balance responses include grant breakdown when applicable.

Next​