Skip to main content

setAutoBilling

Enables or disables off-session auto-billing for an org and updates its thresholds. When enabled and the wallet falls to lowWaterThresholdCents, the saved payment method is charged rechargeAmountCents (requires setupSharedPaymentMethod first). Pass limitCents=null for no per-period cap. Requires the 'manage_billing' org permission.

setAutoBilling(
orgId: BigInt!
enabled: Boolean!
limitCents: BigInt
rechargeAmountCents: BigInt
lowWaterThresholdCents: BigInt
idempotencyKey: String
): OrgAutoBilling!

Arguments

setAutoBilling.orgId ● BigInt! non-null scalar

Organization id (BigInt) to configure auto-billing for.

setAutoBilling.enabled ● Boolean! non-null scalar

Whether to enable off-session auto-billing.

setAutoBilling.limitCents ● BigInt scalar

Max auto-billed per period, in cents. Null = no limit.

setAutoBilling.rechargeAmountCents ● BigInt scalar

Amount to top up the wallet by on each auto-recharge, in cents.

setAutoBilling.lowWaterThresholdCents ● BigInt scalar

Wallet balance at or below which an auto-recharge triggers, in cents.

setAutoBilling.idempotencyKey ● String scalar

Optional idempotency key. Recommended for retries: replaying with the same key and identical arguments returns the first result instead of re-applying; the same key with different arguments returns IDEMPOTENCY_CONFLICT. Keys expire after 24h.

Type

OrgAutoBilling object

Org off-session auto-billing configuration.