@leaflow/sdk 0.154.0 → 0.156.0

package/dist/billing/v1/generated/schemas.zod.js

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Billing API
- * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token and ownership of the account. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, and, with project permissions granted in IAM, change its subscriptions (`billing:subscription.write`), change its billing account (`billing:project_assignment.write`) and read its costs (`billing:cost.read`). A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
@@ -11,6 +11,8 @@ import { BillingAccountCreate } from "./validators/billingAccountCreate.zod.js";
 import { BillingAccountUpdate } from "./validators/billingAccountUpdate.zod.js";
 import { CancelSubscriptionRequest } from "./validators/cancelSubscriptionRequest.zod.js";
 import { CancellationCreate } from "./validators/cancellationCreate.zod.js";
+import { CheckoutSessionConfirm } from "./validators/checkoutSessionConfirm.zod.js";
+import { CheckoutSessionCreate } from "./validators/checkoutSessionCreate.zod.js";
 import { ContactCreate } from "./validators/contactCreate.zod.js";
 import { ContactUpdate } from "./validators/contactUpdate.zod.js";
 import { OrderCancel } from "./validators/orderCancel.zod.js";
@@ -18,7 +20,6 @@ import { PayInvoiceRequest } from "./validators/payInvoiceRequest.zod.js";
 import { PayTogetherRequest } from "./validators/payTogetherRequest.zod.js";
 import { PaymentMethodSetup } from "./validators/paymentMethodSetup.zod.js";
 import { RenewRequest } from "./validators/renewRequest.zod.js";
-import { RenewalOrderRequest } from "./validators/renewalOrderRequest.zod.js";
 import { SetProjectAssignmentRequest } from "./validators/setProjectAssignmentRequest.zod.js";
 import { TopUpCreate } from "./validators/topUpCreate.zod.js";
 import { WithdrawalCreate } from "./validators/withdrawalCreate.zod.js";
@@ -231,7 +232,7 @@ export const GetAccountBalanceParams = zod.strictObject({
     accountId: zod.int(),
 });
 /**
- * The payment gateways and methods currently accepting the account's currency, preferred gateway first. Top-ups and invoice payments must use one listed here. An empty result means online payment is unavailable for the account.
+ * The payment gateways and methods currently accepting the account's currency, preferred gateway first. Top-ups and invoice payments must use one listed here. An empty result means online payment is unavailable for the account. Open to the owner of the account and, with `project_id`, to members of a project the account is currently assigned to.
  * @summary List payment options
  */
 export const ListPaymentOptionsParams = zod.strictObject({
@@ -242,6 +243,10 @@ export const listPaymentOptionsQueryPageMax = 2147483647;
 export const listPaymentOptionsQueryPageSizeDefault = 50;
 export const listPaymentOptionsQueryPageSizeMax = 200;
 export const ListPaymentOptionsQueryParams = zod.strictObject({
+    project_id: zod
+        .uuid()
+        .optional()
+        .describe("A project currently assigned to the account, for listing as a member of the project."),
     page: zod
         .int()
         .min(1)
@@ -283,17 +288,18 @@ export const ListProjectAssignmentsQueryParams = zod.strictObject({
         .min(1)
         .max(listProjectAssignmentsQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * The project's current assignment. Returns 404 when no billing account is assigned; the project cannot create resources until one is.
+ * The project's current assignment, readable by the owner of the assigned account and by members of the project. Returns 404 when no billing account is assigned; the project cannot create resources until one is.
  * @summary Get project assignment
  */
 export const GetProjectAssignmentParams = zod.strictObject({
     projectId: zod.uuid(),
 });
 /**
- * Links the project to a billing account. A project without one is linked directly. Moving it to another
+ * Links the project to a billing account you own; you need the project permission
+ * `billing:project_assignment.write`. A project without one is linked directly. Moving it to another
  * account has the same requirements as unlinking: you own both accounts, the project has no metered resources,
  * no subscriptions that have not ended and no orders in progress, and the current account has no unpaid
  * invoices. Nothing moves with the project; charges already incurred stay with the account linked when they
@@ -307,7 +313,7 @@ export const SetProjectAssignmentParams = zod.strictObject({
 });
 export const SetProjectAssignmentBody = SetProjectAssignmentRequest;
 /**
- * Ends the project's current assignment; the assignment history is kept. Allowed only when the project has no metered resources, no subscriptions that have not ended and no orders in progress, including period-end changes, and the billing account has no unpaid invoices; invoices of orders awaiting payment do not count. Orders are not modified, so wait for them to complete. Charges already incurred stay with the billing account and are invoiced as usual. The project cannot make purchases until a billing account is linked again.
+ * Ends the project's current assignment; the assignment history is kept. You need to own the account and hold the project permission `billing:project_assignment.write`. Allowed only when the project has no metered resources, no subscriptions that have not ended and no orders in progress, including period-end changes, and the billing account has no unpaid invoices; invoices of orders awaiting payment do not count. Orders are not modified, so wait for them to complete. Charges already incurred stay with the billing account and are invoiced as usual. The project cannot make purchases until a billing account is linked again.
  * @summary Unlink project billing account
  */
 export const UnlinkProjectBillingAccountParams = zod.strictObject({
@@ -337,7 +343,7 @@ export const ListTopUpsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
 });
 /**
  * Creates a top-up for an account of the authenticated user and returns its payment information. The balance increases when the gateway confirms receipt. Keep the supplied ID to read the attempt after a lost response; creating it again conflicts.
@@ -389,7 +395,7 @@ export const ListPaymentMethodsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
 });
 /**
  * Returns what the browser needs to open the payment gateway's card form. Nothing is charged; the method is listed once the gateway confirms it. Card numbers never reach this service.
@@ -412,15 +418,9 @@ export const DeletePaymentMethodParams = zod.strictObject({
 });
 /**
  * Pays the invoice from eligible credit grants and balance as requested, and collects the remainder through the
- * selected gateway and method. Without a gateway, insufficient funds fail and no online payment starts.
- *
- * The draft invoice of a deferred order is priced on its first payment: promotion_code, or otherwise the best
- * applicable account discount, is applied, the total is compared with expected_amount, and the invoice is issued
- * before collection. An invalid or inapplicable code fails, and a total other than expected_amount fails with
- * `BILLING_AMOUNT_CHANGED`; neither changes anything. Once fixed, the terms stay fixed even if collection does
- * not complete, and a different promotion_code is refused with `BILLING_ORDER_CHECKOUT_CONFLICT`. A deferred
- * period-end change can be paid only once its first period is due to be invoiced; earlier attempts fail with
- * `BILLING_CHANGE_NOT_INVOICED`.
+ * selected gateway and method. Without a gateway, insufficient funds fail and no online payment starts. The
+ * invoice's amounts and discount were fixed when it was issued and are not changed by paying; promotion codes
+ * are applied when completing a Checkout Session.
  *
  * Returns a payment action when the customer must act; requires_action and processing are not paid. An
  * unresolved online payment with the same gateway, method and saved payment method is reused, and retries never
@@ -436,6 +436,9 @@ export const DeletePaymentMethodParams = zod.strictObject({
  * `BILLING_INVOICE_NOT_PAYABLE` with `meta.reason` `fractional_amount` when the amount left for the gateway is
  * not a whole number of the currency's minor unit; such an invoice is collected from credit grants and balance
  * automatically, including right after a top-up.
+ *
+ * Open to the owner of the invoice's billing account and, for the invoice of an order of a project, to members
+ * of the project. Only the owner can pay with a saved `payment_method_id`.
  * @summary Pay an invoice
  */
 export const PayInvoiceParams = zod.strictObject({
@@ -448,25 +451,16 @@ export const PayInvoiceBody = PayInvoiceRequest;
  * straight afterwards takes exactly these amounts unless the account's funds change in between.
  * Nothing is charged, reserved or created.
  *
- * A draft order invoice is priced as paying it with the same promotion_code would price it.
- *
  * Refused with the same errors as paying, except that insufficient funds are not an error here:
- * they show as a `gateway_amount` above zero.
+ * they show as a `gateway_amount` above zero. Open to the same callers as paying.
  * @summary Preview invoice payment
  */
 export const PreviewInvoicePaymentParams = zod.strictObject({
     invoiceId: zod.uuid(),
 });
-export const previewInvoicePaymentQueryPromotionCodeMax = 64;
 export const previewInvoicePaymentQueryUseBalanceDefault = true;
 export const previewInvoicePaymentQueryUseCreditsDefault = true;
 export const PreviewInvoicePaymentQueryParams = zod.strictObject({
-    promotion_code: zod
-        .string()
-        .min(1)
-        .max(previewInvoicePaymentQueryPromotionCodeMax)
-        .optional()
-        .describe("As in paying; used only while the order's terms are not fixed."),
     use_balance: zod
         .boolean()
         .default(previewInvoicePaymentQueryUseBalanceDefault)
@@ -478,15 +472,13 @@ export const PreviewInvoicePaymentQueryParams = zod.strictObject({
 });
 /**
  * Pays outstanding invoices, including those of the listed orders, from eligible credit grants and then balance,
- * without a payment gateway. The draft invoice of a deferred order takes the best applicable account discount
- * and is issued first, staying issued if payment fails; pay it alone to use a promotion code.
+ * without a payment gateway.
  *
  * All invoices are paid or none: insufficient funds fail with `BILLING_INSUFFICIENT_FUNDS`, and a total other
  * than expected_amount fails with `BILLING_AMOUNT_CHANGED`, charging nothing. Paid invoices are not charged
  * again. An earlier online payment for one of the invoices is canceled first; one the gateway is still
  * processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`. Also refused with
- * `BILLING_INVOICE_NOT_PAYABLE` for a void invoice; `BILLING_CHANGE_NOT_INVOICED` for a period-end change not
- * yet due; `BILLING_ORDER_FAILED`, `BILLING_ORDER_CANCELED` or `BILLING_ORDER_EXPIRED` for an order in that
+ * `BILLING_INVOICE_NOT_PAYABLE` for a void invoice; `BILLING_ORDER_FAILED`, `BILLING_ORDER_CANCELED` or `BILLING_ORDER_EXPIRED` for an order in that
  * state; and `BILLING_INVOICE_NOT_PAYABLE` with `meta.reason` `subscription_canceling`,
  * `subscription_reclaiming` or `subscription_ended` for a renewal invoice of a subscription being canceled,
  * being reclaimed or ended.
@@ -494,7 +486,7 @@ export const PreviewInvoicePaymentQueryParams = zod.strictObject({
  */
 export const PayTogetherBody = PayTogetherRequest;
 /**
- * Issued invoices of your billing accounts. Drafts are not listed; an order's draft invoice is reached through its order. Top-ups have no invoices.
+ * Issued invoices of your billing accounts. Top-ups have no invoices.
  * @summary List invoices
  */
 export const listInvoicesQueryPageDefault = 1;
@@ -517,11 +509,11 @@ export const ListInvoicesQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     status: zod
-        .enum(["draft", "open", "paid", "void"])
+        .enum(["open", "paid", "void"])
         .optional()
-        .describe("`draft`: not yet issued; an order's draft invoice shows base prices until it is paid, when the discount is applied and it is issued. Other drafts are visible only to operators. `open`: issued and not yet settled; a zero-total invoice is paid at once. `paid` stays paid after a refund, with the refunded part in amount_refunded. `void`: collection has stopped and any funds received have been returned. Usage not yet invoiced is not on any invoice."),
+        .describe("`open`: issued and not yet settled; a zero-total invoice is paid at once. `paid` stays paid after a refund, with the refunded part in amount_refunded. `void`: collection has stopped and any funds received have been returned. Usage not yet invoiced is not on any invoice."),
     subscription_id: zod
         .uuid()
         .optional()
@@ -530,14 +522,14 @@ export const ListInvoicesQueryParams = zod.strictObject({
     to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
 });
 /**
- * An invoice of your billing account, issued or an order's draft, with its amounts, tax lines and payment state. A missing invoice or another draft returns 404; an invoice of another user's account returns 403.
+ * An issued invoice of your billing account, or the invoice of an order of a project you are a member of, with its amounts, tax lines and payment state. A missing or unissued invoice returns 404; any other invoice returns 403.
  * @summary Get invoice
  */
 export const GetInvoiceParams = zod.strictObject({
     invoiceId: zod.uuid(),
 });
 /**
- * Lines of an invoice of your billing account, issued or an order's draft, with their service periods and projects. A missing invoice or another draft returns 404; an invoice of another user's account returns 403.
+ * Lines of an invoice readable with get-invoice, with their service periods and projects. A missing or unissued invoice returns 404; any other invoice returns 403.
  * @summary List invoice items
  */
 export const ListInvoiceItemsParams = zod.strictObject({
@@ -585,7 +577,7 @@ export const ListTransactionsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     from: zod.iso.datetime({ offset: true }).optional(),
     to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
 });
@@ -613,7 +605,7 @@ export const ListAccountDiscountsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
 });
 /**
  * Credit grants with what remains and what each may pay for. Credit is spent before balance and cannot be withdrawn.
@@ -639,7 +631,7 @@ export const ListCreditGrantsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     status: zod.enum(["active", "depleted", "expired", "voided"]).optional(),
 });
 /**
@@ -666,7 +658,7 @@ export const ListCreditNotesQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     invoice_id: zod.uuid().optional().describe("Only the notes for this invoice."),
 });
 /**
@@ -725,7 +717,7 @@ export const ListRefundsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     invoice_id: zod.uuid().optional().describe("Only the refunds of this invoice."),
     order_id: zod
         .uuid()
@@ -733,7 +725,7 @@ export const ListRefundsQueryParams = zod.strictObject({
         .describe("Refunds of this order: those of its invoice, such as for an undeliverable purchase, and those it caused on an earlier invoice, such as a downgrade difference."),
 });
 /**
- * Priced usage charges in the requested scope. Usage that had no price when it occurred is never charged later.
+ * Priced usage charges in the requested scope; members with the project permission `billing:cost.read` list a project's charges with `project_ids`. Usage that had no price when it occurred is never charged later.
  * @summary List usage charges
  */
 export const listUsageChargesQueryPageDefault = 1;
@@ -759,7 +751,7 @@ export const ListUsageChargesQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     product_id: zod
         .string()
         .min(1)
@@ -779,12 +771,12 @@ export const ListUsageChargesQueryParams = zod.strictObject({
         .min(1)
         .max(listUsageChargesQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
     meter_id: zod.uuid().optional(),
     statement_id: zod.uuid().optional(),
 });
 /**
- * Subscriptions of the authorized billing account. Deleted subscriptions are not listed.
+ * Subscriptions paid by your billing accounts; members of a project list its subscriptions with `project_ids`. Deleted subscriptions are not listed.
  * @summary List subscriptions
  */
 export const listSubscriptionsQueryPageDefault = 1;
@@ -809,23 +801,23 @@ export const ListSubscriptionsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     project_ids: zod
         .array(zod.uuid())
         .min(1)
         .max(listSubscriptionsQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * A subscription of the authorized billing account. Deleted subscriptions are reported as not found.
+ * A subscription paid by your billing account or of a project you are a member of. Deleted subscriptions are reported as not found.
  * @summary Get subscription
  */
 export const GetSubscriptionParams = zod.strictObject({
     subscriptionId: zod.uuid(),
 });
 /**
- * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at and history are kept. The token must authorize the subscription's current billing account. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
+ * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at and history are kept. Only the owner of the subscription's current billing account can delete it. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
  * @summary Delete subscription
  */
 export const DeleteSubscriptionParams = zod.strictObject({
@@ -833,8 +825,9 @@ export const DeleteSubscriptionParams = zod.strictObject({
 });
 /**
  * Requests cancellation on the purchase's agreed terms, with the same rules as creating a cancellation. Give the
- * refund amount from a quote with this subscription in `cancellation.subscription_ids`. The token must authorize
- * the subscription's current billing account.
+ * refund amount from a quote with this subscription in `cancellation.subscription_ids`. Open to the owner of the
+ * subscription's current billing account and to members of its project with the project permission
+ * `billing:subscription.write`.
  *
  * Immediate cancellation asks the owning service to release the resources now; period-end cancellation keeps the
  * subscription active or suspended until the paid term ends. The subscription becomes canceled when the service
@@ -848,7 +841,7 @@ export const CancelSubscriptionParams = zod.strictObject({
 });
 export const CancelSubscriptionBody = CancelSubscriptionRequest;
 /**
- * Newest first. Filter by `subscription_id` and `status=open` to find a subscription's cancellation in progress.
+ * Newest first; members of a project list its cancellations with `project_ids`. Filter by `subscription_id` and `status=open` to find a subscription's cancellation in progress.
  * @summary List cancellations
  */
 export const listCancellationsQueryPageDefault = 1;
@@ -872,7 +865,7 @@ export const ListCancellationsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     subscription_id: zod
         .uuid()
         .optional()
@@ -886,11 +879,13 @@ export const ListCancellationsQueryParams = zod.strictObject({
         .min(1)
         .max(listCancellationsQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
  * Ends subscriptions of one service together. Deleting a resource is an `immediate` cancellation of every
- * subscription released with it, such as a server with its disks or an address with its bandwidth.
+ * subscription released with it, such as a server with its disks or an address with its bandwidth. Open to the
+ * owner of the subscriptions' current billing account and to members of their project with the project
+ * permission `billing:subscription.write`.
  *
  * The owning service releases the resources at once for `immediate`, or at `scheduled_at`, the end of the paid
  * term, for `period_end`. When release is confirmed, the unused value is returned to the original payment
@@ -923,21 +918,21 @@ export const ListCancellationsQueryParams = zod.strictObject({
  */
 export const CreateCancellationBody = CancellationCreate;
 /**
- * A cancellation of your billing account with its schedule, expected refundable amount and the outcome for each subscription, including partial success.
+ * A cancellation paid by your billing account or of a project you are a member of, with its schedule, expected refundable amount and the outcome for each subscription, including partial success.
  * @summary Get a cancellation
  */
 export const GetCancellationParams = zod.strictObject({
     cancellationId: zod.uuid(),
 });
 /**
- * Withdraws the whole cancellation while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The subscriptions continue, but automatic renewal, turned off when the cancellation was created, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged.
+ * Withdraws the whole cancellation while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The subscriptions continue, but automatic renewal, turned off when the cancellation was created, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged. Open to the owner of the subscriptions' current billing account and to members of their project with the project permission `billing:subscription.write`.
  * @summary Withdraw a cancellation
  */
 export const WithdrawCancellationParams = zod.strictObject({
     cancellationId: zod.uuid(),
 });
 /**
- * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax.
+ * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax. Open to the owner of the subscription's current billing account and to members of its project.
  * @summary List the terms this item can be renewed for
  */
 export const ListRenewalPricesParams = zod.strictObject({
@@ -968,7 +963,10 @@ export const ListRenewalPricesQueryParams = zod.strictObject({
  *
  * Without `payment_method_id`, the renewal is paid from credit grants and balance as `use_credits` and
  * `use_balance` allow; when they cannot cover it, the request fails with `BILLING_INSUFFICIENT_FUNDS` and no
- * order is left. To pay another way, create a renewal order and pay its invoice.
+ * order is left. To apply a promotion code or pay later, create a renewal Checkout Session.
+ *
+ * Open to the owner of the subscription's current billing account and to members of its project with the
+ * project permission `billing:subscription.write`. Only the owner can pay with `payment_method_id`.
  *
  * Keep order_id and read the order after an unknown outcome; creating it again conflicts.
  * @summary Renew subscription
@@ -978,22 +976,7 @@ export const RenewSubscriptionParams = zod.strictObject({
 });
 export const RenewSubscriptionBody = RenewRequest;
 /**
- * Places a renewal order with a draft invoice, without applying a new discount or charging anything. Pay its
- * invoice to renew; a promotion code can be applied when paying. Existing subscription discounts are kept.
- * Periods and price are chosen as for renewing. The order can be paid until the current paid period ends, and
- * never after the end of the first period it renews; unpaid by then, it is canceled. While auto-renew is on, the
- * renewal due at the end of the period pays this order instead of placing another, applying an applicable
- * account discount first if its terms are not fixed yet.
- *
- * Keep `order_id` and read the order after an unknown outcome; creating it again conflicts.
- * @summary Create renewal order
- */
-export const CreateRenewalOrderParams = zod.strictObject({
-    subscriptionId: zod.uuid(),
-});
-export const CreateRenewalOrderBody = RenewalOrderRequest;
-/**
- * Turns automatic renewal of an active or suspended licensed subscription on or off. Turning it off does not shorten current_term_end and still allows manual renewal. Refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a metered subscription, which continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id` while a cancellation is open: creating it turned renewal off, and withdrawing it does not turn renewal back on.
+ * Turns automatic renewal of an active or suspended licensed subscription on or off. Turning it off does not shorten current_term_end and still allows manual renewal. Refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a metered subscription, which continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id` while a cancellation is open: creating it turned renewal off, and withdrawing it does not turn renewal back on. Open to the owner of the subscription's current billing account and to members of its project with the project permission `billing:subscription.write`.
  * @summary Set auto renew
  */
 export const SetAutoRenewParams = zod.strictObject({
@@ -1001,7 +984,7 @@ export const SetAutoRenewParams = zod.strictObject({
 });
 export const SetAutoRenewBody = AutoRenewSet;
 /**
- * Remaining usage quantities, such as bytes, seconds or tokens. Applicable allowances are consumed before usage is charged: lower priority values first, then earlier expiry, then earlier issuance. Unused quantity expires without refund or carry-over. Promotional allowances apply to usage paid by their holding account; included allowances apply only to their subscription, also after its project moves to another billing account.
+ * Remaining usage quantities, such as bytes, seconds or tokens; members of a project list its allowances with `project_ids`. Applicable allowances are consumed before usage is charged: lower priority values first, then earlier expiry, then earlier issuance. Unused quantity expires without refund or carry-over. Promotional allowances apply to usage paid by their holding account; included allowances apply only to their subscription, also after its project moves to another billing account.
  * @summary List allowances
  */
 export const listAllowancesQueryPageDefault = 1;
@@ -1027,7 +1010,7 @@ export const ListAllowancesQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     meter_id: zod.uuid().optional().describe("Filter by the meter UUID."),
     status: zod.enum(["active", "depleted", "expired", "voided"]).optional(),
     product_id: zod
@@ -1042,10 +1025,137 @@ export const ListAllowancesQueryParams = zod.strictObject({
         .min(1)
         .max(listAllowancesQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
+});
+/**
+ * Checkout Sessions of your billing accounts, newest first; members of a project list its sessions with `project_ids`. An open session is a purchase waiting for checkout to be completed.
+ * @summary List Checkout Sessions
+ */
+export const listCheckoutSessionsQueryPageDefault = 1;
+export const listCheckoutSessionsQueryPageMax = 2147483647;
+export const listCheckoutSessionsQueryPageSizeDefault = 50;
+export const listCheckoutSessionsQueryPageSizeMax = 200;
+export const listCheckoutSessionsQueryProjectIdsMax = 100;
+export const ListCheckoutSessionsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCheckoutSessionsQueryPageMax)
+        .default(listCheckoutSessionsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCheckoutSessionsQueryPageSizeMax)
+        .default(listCheckoutSessionsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Only this account; all of yours when omitted."),
+    status: zod
+        .enum(["open", "complete", "expired"])
+        .optional()
+        .describe("`open`: waiting for you to complete checkout; nothing is ordered, invoiced or reserved. `complete`: the order and its issued invoice exist; read the order for payment and delivery. `expired`: ended without an order."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listCheckoutSessionsQueryProjectIdsMax)
+        .optional()
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * Orders with their status and invoice amounts. A pending order is not yet accepted and can expire at expires_at; its invoice shows whether payment is needed. Accepted does not mean delivered.
+ * Opens a Checkout Session renewing a licensed subscription, with periods and price chosen as in
+ * renewing. Nothing is charged until you complete it, when a promotion code can be applied; it then renews from
+ * the subscription's current_term_end at that time. To renew at once from credit grants, balance or a payment
+ * method, renew the subscription instead. Purchases and changes of a service's resources are created through
+ * that service.
+ *
+ * Open to the owner of the subscription's current billing account and to members of its project with the
+ * project permission `billing:subscription.write`. Keep `checkout_session_id` and read the session after an
+ * unknown outcome; creating it again conflicts.
+ * @summary Create a renewal Checkout Session
+ */
+export const CreateCheckoutSessionBody = CheckoutSessionCreate;
+/**
+ * A Checkout Session of your billing account or of a project you are a member of. Poll it to follow checkout; once it is complete, read its order for payment and delivery. An unknown session returns 404; any other session returns 403.
+ * @summary Get a Checkout Session
+ */
+export const GetCheckoutSessionParams = zod.strictObject({
+    checkoutSessionId: zod.uuid(),
+});
+/**
+ * What the session buys, by position. Prices and amounts are in its quote. Readable by whoever can read the session.
+ * @summary List Checkout Session items
+ */
+export const ListCheckoutSessionItemsParams = zod.strictObject({
+    checkoutSessionId: zod.uuid(),
+});
+export const listCheckoutSessionItemsQueryPageDefault = 1;
+export const listCheckoutSessionItemsQueryPageMax = 2147483647;
+export const listCheckoutSessionItemsQueryPageSizeDefault = 50;
+export const listCheckoutSessionItemsQueryPageSizeMax = 200;
+export const ListCheckoutSessionItemsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCheckoutSessionItemsQueryPageMax)
+        .default(listCheckoutSessionItemsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCheckoutSessionItemsQueryPageSizeMax)
+        .default(listCheckoutSessionItemsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * What completing this open session now would invoice, with `promotion_code` or otherwise the best applicable
+ * account discount, and the account funds available for it. Nothing is applied, reserved or redeemed. An invalid
+ * or inapplicable code fails the request without changing the session.
+ *
+ * Complete the session with the returned `total` as `expected_amount`, the same `promotion_code` and, for an
+ * immediate change, the returned `proration_date`. An expired session is refused with
+ * `BILLING_CHECKOUT_SESSION_EXPIRED`, and a complete one with `BILLING_CHECKOUT_SESSION_COMPLETE`; read its order
+ * instead.
+ *
+ * Open to the owner of the session's billing account and to members of its project.
+ * @summary Quote a Checkout Session
+ */
+export const GetCheckoutSessionQuoteParams = zod.strictObject({
+    checkoutSessionId: zod.uuid(),
+});
+export const getCheckoutSessionQuoteQueryPromotionCodeMax = 64;
+export const GetCheckoutSessionQuoteQueryParams = zod.strictObject({
+    promotion_code: zod.string().min(1).max(getCheckoutSessionQuoteQueryPromotionCodeMax).optional(),
+});
+/**
+ * Completes an open session: applies `promotion_code`, or otherwise the best applicable account discount, checks
+ * the total against `expected_amount` and creates the order with its invoice issued. A zero-total invoice is paid
+ * at once; otherwise pay the invoice next. A failed payment leaves the order and its terms as they are, and the
+ * invoice can be paid again until the order expires. Nothing is created when the code is invalid or
+ * inapplicable or the total differs, which fails with `BILLING_AMOUNT_CHANGED`.
+ *
+ * Confirming a complete session again with the same terms returns it with its order; different terms are refused
+ * with `BILLING_CHECKOUT_SESSION_COMPLETE`. An expired session is refused with `BILLING_CHECKOUT_SESSION_EXPIRED`.
+ * The order is delivered by the service that owns it once paid; confirmation alone does not mean delivery.
+ *
+ * Open to the owner of the session's billing account and to members of its project.
+ * @summary Confirm a Checkout Session
+ */
+export const ConfirmCheckoutSessionParams = zod.strictObject({
+    checkoutSessionId: zod.uuid(),
+});
+export const ConfirmCheckoutSessionBody = CheckoutSessionConfirm;
+/**
+ * Ends an open session without an order; the service that created it releases what it was holding for the purchase. An expired session is returned unchanged. Open to the owner of the session's billing account and to members of its project.
+ * @summary Expire a Checkout Session
+ */
+export const ExpireCheckoutSessionParams = zod.strictObject({
+    checkoutSessionId: zod.uuid(),
+});
+/**
+ * Orders of your billing accounts with their status and invoice amounts; members of a project list its orders with `project_ids`. A pending order is not yet accepted and can expire at expires_at; its invoice shows whether payment is needed. Accepted does not mean delivered.
  * @summary List orders
  */
 export const listOrdersQueryPageDefault = 1;
@@ -1069,7 +1179,7 @@ export const ListOrdersQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     status: zod
         .enum(["pending", "accepted", "completed", "partially_completed", "failed", "canceled"])
         .optional()
@@ -1081,29 +1191,44 @@ export const ListOrdersQueryParams = zod.strictObject({
         .min(1)
         .max(listOrdersQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * An order of your billing account with its status and invoice. An unknown order returns 404; another user's order returns 403.
+ * An order of your billing account or of a project you are a member of, with its status and invoice. An unknown order returns 404; any other order returns 403.
  * @summary Get order
  */
 export const GetOrderParams = zod.strictObject({
     orderId: zod.uuid(),
 });
+/**
+ * What canceling the listed items, or the whole order, would refund to the original payment sources. Nothing is canceled or refunded. Open to the owner of the order's billing account and to members of its project.
+ * @summary Preview an order refund
+ */
+export const PreviewOrderRefundParams = zod.strictObject({
+    orderId: zod.uuid(),
+});
+export const previewOrderRefundQueryOrderItemIdsMax = 100;
+export const PreviewOrderRefundQueryParams = zod.strictObject({
+    order_item_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(previewOrderRefundQueryOrderItemIdsMax)
+        .optional()
+        .describe("Only these items of the order. Omit for the whole order."),
+});
 /**
  * Cancels the selected undelivered items of an order that has not been accepted, without recording a delivery
  * failure. Omit order_item_ids to select every pending item. Delivered items stay delivered and are not
  * refunded; failed items keep their outcome. The order stays pending while any item is pending, and its final
  * status follows its items.
  *
- * Once the order's terms are fixed, the canceled items keep their agreed amounts and discounts: credit notes
- * reduce the issued invoice, and collected amounts return to their original payment sources, possibly
- * asynchronously. While a deferred order's terms are not fixed, the remaining items are priced again. An online
+ * The canceled items keep their agreed amounts and discounts: credit notes reduce the issued invoice, and
+ * collected amounts return to their original payment sources, possibly asynchronously. An online
  * payment waiting for the payer is canceled with the order; one the gateway is processing is refused with
  * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`. Repeating the cancellation does not refund twice.
  *
  * An accepted order is canceled by its owning service, and delivered items through subscription cancellation.
- * Refunds are quoted with the quote operation's `refund` target.
+ * Refunds are previewed with `preview-order-refund`. Open to the owner of the order's billing account and to members of its project.
  * @summary Cancel order
  */
 export const CancelOrderParams = zod.strictObject({
@@ -1111,7 +1236,7 @@ export const CancelOrderParams = zod.strictObject({
 });
 export const CancelOrderBody = OrderCancel;
 /**
- * One entry per item bought, with the price charged and the period it covers.
+ * One entry per item bought, with the price charged and the period it covers. Readable by whoever can read the order.
  * @summary List order items
  */
 export const ListOrderItemsParams = zod.strictObject({
@@ -1136,7 +1261,7 @@ export const ListOrderItemsQueryParams = zod.strictObject({
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
- * Capabilities granted by live subscriptions and active feature grants. A capability not held is not listed, and one stops being listed when the subscription or grant providing it ends.
+ * Capabilities granted by live subscriptions and active feature grants; members of a project list its entitlements with `project_ids`. A capability not held is not listed, and one stops being listed when the subscription or grant providing it ends.
  * @summary List entitlements
  */
 export const listEntitlementsQueryPageDefault = 1;
@@ -1162,13 +1287,13 @@ export const ListEntitlementsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     project_ids: zod
         .array(zod.uuid())
         .min(1)
         .max(listEntitlementsQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
     product_id: zod
         .string()
         .min(1)
@@ -1203,7 +1328,7 @@ export const ListFeatureGrantsQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     product_id: zod
         .string()
         .min(1)
@@ -1441,7 +1566,7 @@ export const ListRatesHeader = zod.strictObject({
         .describe("The `ETag` of an earlier response. When the catalogue has not changed since, the response is `304` with no body."),
 });
 /**
- * Continuous metering registrations paid for by your billing accounts. Their state does not describe the resource's runtime. Project filters only narrow the result.
+ * Continuous metering registrations paid for by your billing accounts; members of a project list its registrations with `project_ids`. Their state does not describe the resource's runtime.
  * @summary List active resources
  */
 export const listActiveResourcesQueryPageDefault = 1;
@@ -1468,13 +1593,13 @@ export const ListActiveResourcesQueryParams = zod.strictObject({
     billing_account_id: zod
         .int()
         .optional()
-        .describe("Only this account of yours; all when omitted."),
+        .describe("Only this account; all of yours when omitted."),
     project_ids: zod
         .array(zod.uuid())
         .min(1)
         .max(listActiveResourcesQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
     meter_id: zod.uuid().optional(),
     product_id: zod
         .string()
@@ -1491,6 +1616,9 @@ export const ListActiveResourcesQueryParams = zod.strictObject({
  * closing are included. `from` and `to` must fall on UTC day boundaries and span at most 92 days.
  * Project filters use the account recorded on each charge, including charges for projects later
  * assigned to another account. The total covers all matching groups, not just the returned page.
+ *
+ * Open to the owner of the account and to members with the project permission `billing:cost.read` of each
+ * project in `project_ids`, which must then be given and currently assigned to the account.
  * @summary List account spend
  */
 export const listSpendQueryGroupByDefault = `product`;
@@ -1537,7 +1665,7 @@ export const ListSpendQueryParams = zod.strictObject({
         .min(1)
         .max(listSpendQueryProjectIdsMax)
         .optional()
-        .describe("Only records of these projects. Omit for all projects and account-level records. It does not grant access to other billing accounts."),
+        .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
  * Usage billing per UTC calendar month for your billing accounts, newest first. Each month combines its statements, the invoices they issued and how those were paid.
@@ -1598,7 +1726,7 @@ export const GetStatementParams = zod.strictObject({
     statementId: zod.uuid(),
 });
 /**
- * The statement's consumption, grouped by project, product or meter and filtered within the statement. Quantities are given only for meter groups; grouping by meter also splits by the meter's presentation dimensions.
+ * The statement's consumption, grouped by project, product or meter and filtered within the statement. Quantities are given only for meter groups; grouping by meter also splits by the meter's presentation dimensions. Open to the owner of the statement's account and to members with the project permission `billing:cost.read` of each project in `project_ids`, which must then be given and currently assigned to that account.
  * @summary Get grouped consumption
  */
 export const GetStatementUsageParams = zod.strictObject({