Billing
Subscriptions, payment methods, billing contacts, and Stripe billing portal sessions.
List billing contacts for this organization.
Returns the users designated to receive billing-related notifications (e.g. payment failures, upcoming renewals) for this organization.
Add a billing contact.
Designates an existing user as a billing contact for this organization. The user must already hold the organization's billing management role. Requires manage-billing.
Remove a billing contact.
Removes a user's billing-contact designation for this organization. Requires manage-billing.
List payment methods for this organization.
Returns the saved card payment methods on this organization's Stripe customer. Each entry indicates whether it is the customer's default and whether it is currently in use by an active subscription (a payment method in use cannot be removed). Empty if the organization has no Stripe customer yet.
Create a Stripe Checkout link to add a payment method.
Creates a Stripe Checkout session in setup mode, which collects and saves a card against this organization's Stripe customer without charging it. Redirect the browser to the returned link; Stripe returns the user to your `redirect_uri` with a `payment_method_setup=success` or `payment_method_setup=cancelled` query parameter appended. Requires manage-billing.
Remove a payment method.
Detaches a saved card from this organization's Stripe customer. Fails with a 409 if the payment method is in use by an active subscription — switch that subscription to another card first. Requires manage-billing.
Set this organization's default payment method.
Makes the given payment method the default for this organization's future invoices. The payment method must already belong to this organization. Requires manage-billing.
Create a Stripe billing portal session link.
Creates a one-time link to the organization's Stripe billing portal, where the organization's billing contacts can update payment methods, view invoices, and manage subscriptions. The link is single-use and expires shortly after creation. Requires manage-billing.
List subscriptions for this organization.
Returns the Stripe subscriptions billed to this organization. Empty if the organization has no Stripe customer yet.