Update sub-account direct billing
Turn direct billing on or off for a sub-account: your client pays us directly for its minutes, from its own card saved with us, at exactly the rate we charge you. Your wallet is never charged or credited for this sub-account, and no Stripe Connect account is needed. Charges show as TFU AI on your client’s statement.
On makes the sub-account’s wallet visible and is refused while rebilling is on (DIRECT_BILLING_REBILLING_ON, 409): a sub-account is billed one way at a time. Next, save your client’s card on the sub-account’s card form in the dashboard. autoRecharge.enabled then permits automatic charges to that card: a balance below thresholdUSD is charged rechargeAmountUSD within 5 minutes, one already below included. Switching auto-recharge on needs that card, so on a sub-account with no card yet, send it after the card is saved. A refusal part-way puts back everything the call changed, Credit Guard included.
Calls use the prepaid minutes first. A call that runs past them is your client’s to pay, recorded as debt in minutes that its next top-up clears, never your wallet’s. Credit Guard stops its calls at empty instead, so turning direct billing on for a sub-account also turns its Credit Guard on, unless you send creditGuard. Switch it off only on purpose: with it off, a card that keeps failing leaves calls running on debt.
Off turns auto-recharge off. Minutes your client already paid for stay on the sub-account and keep being used by its calls until they are gone; after that your wallet pays, as for any sub-account you do not rebill. The card stays saved, so switching back on reuses it.
Needs a plan that includes rebilling, like every sub-account billing change, but not Stripe Connect: the card is saved with us, not on your Stripe account. Without the plan the call changes nothing and answers CAPABILITY_NOT_AVAILABLE (403).
Allowed customer roles: agency_admin. The agency is the one the credential belongs to.
Required API key scope: billing:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Headers
Optional. A retry with the same key returns the first answer with idempotentReplay: true.
8 - 255Path Parameters
The sub-account's Location ID.
1Body
On, optionally with auto-recharge and Credit Guard; or off.
On, optionally with auto-recharge and Credit Guard; or off.
true to turn direct billing on, false to turn it off.
Only with enabled: true. Set the sub-account's auto-recharge in the same step. On needs your client's card saved first.
Only with enabled: true. Leave out to turn Credit Guard on for a sub-account that was not on direct billing, and to keep it as it is for one that was.
