@leaflow/sdk 0.0.0-dev.230.g6609f68 → 0.0.0-dev.232.g18ca775

package/dist/billing/account/v1/schema.d.ts

@@ -395,7 +395,10 @@ export interface paths {
          *     Returns a checkout address when the gateway requires the cardholder to confirm the
          *     payment; the invoice is marked paid once the gateway confirms it.
          *
-         *     Calling this on an invoice that is already paid returns the invoice unchanged.
+         *     Calling this on an invoice that is already paid returns the invoice unchanged. A void invoice
+         *     is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an order that has failed or was
+         *     canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
+         *     payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
          */
         post: operations["pay-invoice"];
         delete?: never;
@@ -450,8 +453,10 @@ export interface paths {
          *     Either every invoice is paid or none is. When the credit grants and balance cannot cover
          *     them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
          *     Invoices that are already paid are not charged again. An invoice with an online payment
-         *     still in progress is refused with `BILLING_PAYMENT_PENDING`, and an order whose payment
-         *     deadline has passed with `BILLING_ORDER_EXPIRED`.
+         *     still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+         *     `BILLING_INVOICE_NOT_PAYABLE`, an order that has failed or was canceled with
+         *     `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
+         *     passed with `BILLING_ORDER_EXPIRED`.
          */
         post: operations["pay-together"];
         delete?: never;
@@ -798,7 +803,17 @@ export interface paths {
         put?: never;
         /**
          * Renew subscription
-         * @description Purchases prepaid periods from paid_until using the agreed recurring amount. A changed interval selects a current price and freezes new terms on the order, applied only after fulfillment. Existing paid periods keep their value. Save order_id before submitting and query the order after an unknown outcome; duplicate creation conflicts.
+         * @description Purchases prepaid periods from paid_until using the agreed recurring amount, and pays for them at
+         *     once. A changed interval selects a current price and freezes new terms on the order, applied
+         *     only after fulfillment. Existing paid periods keep their value.
+         *
+         *     Without `payment_method_id`, the renewal is paid from credit grants and the balance as
+         *     `use_credits` and `use_balance` allow; when they cannot pay it all, the renewal is refused with
+         *     `BILLING_INSUFFICIENT_FUNDS` and no order is left. To pay another way, create a renewal order
+         *     and pay its invoice instead.
+         *
+         *     Save order_id before submitting and query the order after an unknown outcome; duplicate
+         *     creation conflicts.
          */
         post: operations["renew-subscription"];
         delete?: never;
@@ -960,7 +975,8 @@ export interface paths {
          * @description Withdraws an order that is not paid in full, and tells the service that placed it, so that
          *     nothing is delivered. An order with nothing paid becomes `canceled` and its invoice is voided.
          *     What was already paid toward it, from credit grants or the balance, is returned the way it was
-         *     paid, and the order becomes `failed`. Either way `cancel_reason` is `requested_by_customer`.
+         *     paid, and the order becomes `failed`; its invoice is voided once everything paid has been
+         *     returned. Either way `cancel_reason` is `requested_by_customer`.
          *     Canceling an order that is already canceled or failed returns it unchanged.
          *
          *     Refused with 409 and `BILLING_PAID_ORDER_NOT_CANCELABLE` once the invoice is paid in full,
@@ -1646,6 +1662,10 @@ export interface components {
          *
          *     `refunded` means the invoice was paid and has since been refunded in full; a partial refund
          *     leaves it `paid`, with the refunded part in `amount_refunded`.
+         *
+         *     `void` means the invoice will not be paid and holds no money: nothing was paid, or its order
+         *     failed or was canceled and everything paid toward it has been returned, as `amount_paid` and
+         *     `amount_refunded` show.
          * @enum {string}
          */
         InvoiceStatus: "draft" | "open" | "paid" | "refunded" | "void" | "uncollectible";

package/dist/billing/project/v1/schema.d.ts

@@ -565,6 +565,9 @@ export interface components {
         /**
          * @description `refunded` means the invoice was paid and has since been refunded in full; a partial refund
          *     leaves it `paid`, with the refunded part in `amount_refunded`.
+         *
+         *     `void` means the invoice will not be paid and holds no money: nothing was paid, or its order
+         *     failed or was canceled and everything paid toward it has been returned.
          * @enum {string}
          */
         InvoiceStatus: "draft" | "open" | "paid" | "refunded" | "void" | "uncollectible";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.0.0-dev.230.g6609f68",
+  "version": "0.0.0-dev.232.g18ca775",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {