GrantBalance

Create a standalone grant of a counted feature: the API behind Paykit.Balances(account).create.

Source: packages/paykit/src/Billing/GrantBalance.binding.ts Kind: Binding · Product: Usage · Provides: Paykit.GrantBalance

Create a standalone grant of a counted feature: the API behind Paykit.Balances(account).create. A grant belongs to the customer, not to a plan — the plan and rollover sources are spent first, and a lifetime grant survives every close and plan change (ADR 0037).

Granting 50 research runs

const grant = yield* Paykit.GrantBalance(account);
yield* grant({
  featureId: "research_runs",
  granted: 50,
  expiresAt: DateTime.add(DateTime.unsafeNow(), { months: 1 }),
});