@usethrottle/api-client 4.2.1 → 4.4.0

package/dist/generated/services/OrdersService.d.ts

@@ -116,6 +116,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -129,12 +139,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -177,7 +192,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -190,10 +213,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -211,17 +264,17 @@ export declare class OrdersService {
      * @param status
      * @param paymentStatus
      * @param type
-     * @param delivery Where the goods are. Derived from shipment and return records, not an order column: `in_transit` = something shipped and something has not arrived, `delivered` = every shipment arrived, `returned` = any items came back (a partial return included).
+     * @param delivery Where the goods are. Derived from shipment and return records, not an order column: `not_shipped` = nothing has left yet on an order that still owes goods (status `processing` or `partially_fulfilled`, no returns), `in_transit` = something shipped and something has not arrived, `delivered` = every shipment arrived, `returned` = any items came back (a partial return included).
      * @param source
      * @param q Search order id, number, source, status, or metadata.
      * @param customerId
-     * @param subscriptionId Return only the orders this subscription billed (exact match on the order metadata `subscription_id` pointer). Covers renewals, plan-change charges and the signup order.
+     * @param subscriptionId Return only the orders this subscription billed (exact match on `subscriptionId`, or on the legacy `metadata.subscription_id` pointer). Covers renewals, plan-change charges and the signup order.
      * @param createdAfter ISO 8601 lower bound on creation time, EXCLUSIVE (created_at > value).
      * @param createdBefore ISO 8601 upper bound on creation time, EXCLUSIVE (created_at < value).
      * @returns any Default Response
      * @throws ApiError
      */
-    static getApiV1Orders(xThrottleEnvironmentId?: string, cursor?: string, limit?: number, status?: 'draft' | 'pending' | 'processing' | 'partially_fulfilled' | 'fulfilled' | 'cancelled' | 'closed', paymentStatus?: 'pending' | 'authorized' | 'captured' | 'partially_paid' | 'partially_refunded' | 'refunded' | 'failed' | 'voided' | 'processing' | 'disputed' | 'expired', type?: 'one_time' | 'recurring' | 'mixed', delivery?: 'in_transit' | 'delivered' | 'returned', source?: 'web' | 'mobile' | 'pos' | 'api' | 'subscription_engine', q?: string, customerId?: string, subscriptionId?: string, createdAfter?: string, createdBefore?: string): CancelablePromise<{
+    static getApiV1Orders(xThrottleEnvironmentId?: string, cursor?: string, limit?: number, status?: 'draft' | 'pending' | 'processing' | 'partially_fulfilled' | 'fulfilled' | 'cancelled' | 'closed', paymentStatus?: 'pending' | 'authorized' | 'captured' | 'partially_paid' | 'partially_refunded' | 'refunded' | 'failed' | 'voided' | 'processing' | 'disputed' | 'expired', type?: 'one_time' | 'recurring' | 'mixed', delivery?: 'not_shipped' | 'in_transit' | 'delivered' | 'returned', source?: 'web' | 'mobile' | 'pos' | 'api' | 'subscription_engine', q?: string, customerId?: string, subscriptionId?: string, createdAfter?: string, createdBefore?: string): CancelablePromise<{
         data?: Array<{
             id?: string;
             workspaceId?: string;
@@ -249,6 +302,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -262,12 +325,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -310,7 +378,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -323,10 +399,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         }>;
         meta?: {
             requestId?: string;
@@ -344,19 +450,19 @@ export declare class OrdersService {
      * @param status
      * @param paymentStatus
      * @param type
-     * @param delivery Where the goods are. Derived from shipment and return records, not an order column: `in_transit` = something shipped and something has not arrived, `delivered` = every shipment arrived, `returned` = any items came back (a partial return included).
+     * @param delivery Where the goods are. Derived from shipment and return records, not an order column: `not_shipped` = nothing has left yet on an order that still owes goods (status `processing` or `partially_fulfilled`, no returns), `in_transit` = something shipped and something has not arrived, `delivered` = every shipment arrived, `returned` = any items came back (a partial return included).
      * @param source
      * @param q Search order id, number, source, status, or metadata.
      * @param customerId
-     * @param subscriptionId Return only the orders this subscription billed (exact match on the order metadata `subscription_id` pointer). Covers renewals, plan-change charges and the signup order.
+     * @param subscriptionId Return only the orders this subscription billed (exact match on `subscriptionId`, or on the legacy `metadata.subscription_id` pointer). Covers renewals, plan-change charges and the signup order.
      * @param createdAfter ISO 8601 lower bound on creation time, EXCLUSIVE (created_at > value).
      * @param createdBefore ISO 8601 upper bound on creation time, EXCLUSIVE (created_at < value).
      * @returns any Default Response
      * @throws ApiError
      */
-    static getApiV1OrdersExportCsv(xThrottleEnvironmentId?: string, cursor?: string, limit?: number, status?: 'draft' | 'pending' | 'processing' | 'partially_fulfilled' | 'fulfilled' | 'cancelled' | 'closed', paymentStatus?: 'pending' | 'authorized' | 'captured' | 'partially_paid' | 'partially_refunded' | 'refunded' | 'failed' | 'voided' | 'processing' | 'disputed' | 'expired', type?: 'one_time' | 'recurring' | 'mixed', delivery?: 'in_transit' | 'delivered' | 'returned', source?: 'web' | 'mobile' | 'pos' | 'api' | 'subscription_engine', q?: string, customerId?: string, subscriptionId?: string, createdAfter?: string, createdBefore?: string): CancelablePromise<any>;
+    static getApiV1OrdersExportCsv(xThrottleEnvironmentId?: string, cursor?: string, limit?: number, status?: 'draft' | 'pending' | 'processing' | 'partially_fulfilled' | 'fulfilled' | 'cancelled' | 'closed', paymentStatus?: 'pending' | 'authorized' | 'captured' | 'partially_paid' | 'partially_refunded' | 'refunded' | 'failed' | 'voided' | 'processing' | 'disputed' | 'expired', type?: 'one_time' | 'recurring' | 'mixed', delivery?: 'not_shipped' | 'in_transit' | 'delivered' | 'returned', source?: 'web' | 'mobile' | 'pos' | 'api' | 'subscription_engine', q?: string, customerId?: string, subscriptionId?: string, createdAfter?: string, createdBefore?: string): CancelablePromise<any>;
     /**
-     * Get an order by ID (includes line items)
+     * Get an order by ID (includes line items, plus `capturedAmount` and `refundedAmount`)
      * @param id
      * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
      * @returns any Default Response
@@ -390,6 +496,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -403,12 +519,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -451,7 +572,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -464,10 +593,48 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
+            /**
+             * What this order actually collected, before refunds. Not the same as `total` on a partially-paid order.
+             */
+            capturedAmount?: number;
+            /**
+             * How much of the captured money went back. `paymentStatus: "refunded"` says a full refund happened; this says how much it was.
+             */
+            refundedAmount?: number;
         };
         meta?: {
             requestId?: string;
@@ -557,6 +724,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -570,12 +747,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -618,7 +800,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -631,10 +821,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -679,6 +899,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -692,12 +922,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -740,7 +975,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -753,10 +996,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -804,6 +1077,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -817,12 +1100,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -865,7 +1153,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -878,10 +1174,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -929,6 +1255,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -942,12 +1278,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -990,7 +1331,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1003,10 +1352,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -1055,6 +1434,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1068,12 +1457,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -1116,7 +1510,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1129,6 +1531,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
             /**
              * Payment settlement performed by the cancel: voids of open authorizations (always) and refunds of captured payments (opt-in). Failures never undo the cancel.
              */
@@ -1138,10 +1574,6 @@ export declare class OrdersService {
                 status?: 'succeeded' | 'failed';
                 error?: string;
             }>;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
         };
         meta?: {
             requestId?: string;
@@ -1190,6 +1622,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1203,12 +1645,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -1251,7 +1698,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1264,10 +1719,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -1278,7 +1763,7 @@ export declare class OrdersService {
         };
     }>;
     /**
-     * Write off the order's remaining balance. Money already captured stays captured; the buyer is never charged and no processor is contacted. `compAmount` is set to the balance outstanding and `total` drops by the same amount, so `paymentStatus` settles at `captured` and `displayStatus` reads "… · Comped".
+     * Write off the order's remaining balance. Money already captured stays captured; the buyer is never charged and no processor is contacted. `compAmount` is set to the balance outstanding; `total` is NOT reduced, because the order is still a sale of that size — the comp is a credit recorded against it. What the buyer owes is `total - compAmount`, so `paymentStatus` settles at `captured` and `displayStatus` reads "… · Comped".
      * @param id
      * @param requestBody
      * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
@@ -1315,6 +1800,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1328,12 +1823,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -1376,7 +1876,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1389,6 +1897,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
             /**
              * Payment settlement performed by the comp: voids of anything still claiming the waived balance — open authorizations, and unpaid Net-N invoices, whose buyers are also emailed. Captured money is never touched. Failures never undo the comp.
              */
@@ -1398,10 +1940,6 @@ export declare class OrdersService {
                 status?: 'succeeded' | 'failed';
                 error?: string;
             }>;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
         };
         meta?: {
             requestId?: string;
@@ -1412,7 +1950,7 @@ export declare class OrdersService {
         };
     }>;
     /**
-     * Undo a comp. The order owes what it owed again: `compAmount` returns to 0, `total` is restored, and `paymentStatus` falls back out of `captured` on its own. Side effects of the comp are NOT rewound: an authorization voided at the processor cannot be un-voided, so collecting the restored balance needs a new payment, and a tax document voided or returned at the provider needs a manual re-file (`POST /v1/tax-documents/{id}/retry`).
+     * Undo a comp. The order owes what it owed again: `compAmount` returns to 0 (`total` never moved) and `paymentStatus` falls back out of `captured` on its own. Side effects of the comp are NOT rewound: an authorization voided at the processor cannot be un-voided, so collecting the restored balance needs a new payment, and a tax document voided or returned at the provider needs a manual re-file (`POST /v1/tax-documents/{id}/retry`).
      * @param id
      * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
      * @returns any Default Response
@@ -1446,6 +1984,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1459,12 +2007,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -1507,7 +2060,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1520,68 +2081,41 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
-        };
-        meta?: {
-            requestId?: string;
-            pagination?: {
-                cursor?: string | null;
-                hasMore?: boolean;
-            };
-        };
-    }>;
-    /**
-     * Append-only record of every status change on this order, oldest first.
-     * @param id
-     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
-     * @returns any Default Response
-     * @throws ApiError
-     */
-    static getApiV1OrdersStatusHistory(id: string, xThrottleEnvironmentId?: string): CancelablePromise<{
-        data?: Array<{
-            id?: string;
-            fromStatus?: string | null;
-            toStatus?: string;
-            actorType?: 'user' | 'system' | 'integration';
-            actorId?: string | null;
-            reason?: string | null;
-            source?: 'manual' | 'state_machine' | 'fulfillment' | 'payment' | 'migration';
-            createdAt?: string;
-        }>;
-        meta?: {
-            requestId?: string;
-            pagination?: {
-                cursor?: string | null;
-                hasMore?: boolean;
-            };
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
-    }>;
-    /**
-     * Everything that happened to this order, newest first: status changes, payment attempts (including declines, which write no status-history row), and fulfillment events. One row shape for every source.
-     * @param id
-     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
-     * @param limit
-     * @param cursor
-     * @returns any Default Response
-     * @throws ApiError
-     */
-    static getApiV1OrdersTimeline(id: string, xThrottleEnvironmentId?: string, limit?: number, cursor?: string): CancelablePromise<{
-        data?: Array<{
-            id: string;
-            at: string;
-            kind: 'status' | 'payment' | 'fulfillment' | 'hold';
-            title: string;
-            detail?: string;
-            amount?: number;
-            currency?: string;
-            source: 'manual' | 'state_machine' | 'fulfillment' | 'payment' | 'migration' | 'provider';
-            actorType?: 'user' | 'system' | 'integration' | 'api_key';
-            actorName?: string;
-            reason?: string;
-        }>;
         meta?: {
             requestId?: string;
             pagination?: {
@@ -1591,13 +2125,16 @@ export declare class OrdersService {
         };
     }>;
     /**
-     * Close a fulfilled order (archive it from active views)
+     * Freeze an order operationally. A hold is a flag, not a stage: `status`, `paymentStatus` and `displayStatus` are unchanged, and nothing about money or delivery moves. Holdable while the order is still live (`pending`, `processing`, `partially_fulfilled`, `fulfilled`); a draft, cancelled or closed order answers 422 `order_not_holdable`. Re-holding with the same reason is a no-op and does not restart `heldAt`; a new reason overwrites it. `heldBy` comes from the caller's credentials and cannot be supplied.
      * @param id
+     * @param requestBody
      * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
      * @returns any Default Response
      * @throws ApiError
      */
-    static postApiV1OrdersClose(id: string, xThrottleEnvironmentId?: string): CancelablePromise<{
+    static postApiV1OrdersHold(id: string, requestBody: {
+        reason: string;
+    }, xThrottleEnvironmentId?: string): CancelablePromise<{
         data?: {
             id?: string;
             workspaceId?: string;
@@ -1625,6 +2162,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1638,12 +2185,17 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
             compedAt?: string | null;
             compedBy?: string | null;
+            onHold?: boolean;
+            holdReason?: string | null;
+            heldAt?: string | null;
+            heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -1686,7 +2238,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1699,69 +2259,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
-            onHold?: boolean;
-            holdReason?: string | null;
-            heldAt?: string | null;
-            heldBy?: string | null;
-        };
-        meta?: {
-            requestId?: string;
-            pagination?: {
-                cursor?: string | null;
-                hasMore?: boolean;
-            };
-        };
-    }>;
-    /**
-     * Refund the captured payment on an order
-     * @param id
-     * @param requestBody
-     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
-     * @returns any Default Response
-     * @throws ApiError
-     */
-    static postApiV1OrdersRefund(id: string, requestBody: {
-        /**
-         * Partial refund amount (defaults to full amount)
-         */
-        amount?: number;
-        reason?: string;
-    }, xThrottleEnvironmentId?: string): CancelablePromise<{
-        data?: {
-            id?: string;
-            orderId?: string;
-            processor?: string;
-            processorTransactionId?: string | null;
-            processorResponse?: any | null;
-            /**
-             * Amount in cents (e.g. 1999 = $19.99)
-             */
-            amount?: number;
-            /**
-             * Amount actually captured. May be less than `amount` on a partial capture; null until captured.
-             */
-            capturedAmount?: number | null;
-            currency?: string;
-            status?: 'pending' | 'authorized' | 'processing' | 'captured' | 'failed' | 'voided' | 'expired' | 'refunded' | 'partially_refunded';
-            errorCode?: string | null;
-            /**
-             * Why the payment failed. For a manually-marked failure this is the reason the merchant gave.
-             */
-            errorMessage?: string | null;
-            method?: 'card' | 'bank_transfer' | 'wallet' | 'cash' | 'cheque' | 'external' | 'manual' | 'net30';
-            netN?: number;
-            netNSource?: 'customer_override' | 'cart_override' | 'global_default';
-            authorizedAt?: string | null;
-            capturedAt?: string | null;
-            voidedAt?: string | null;
-            disputed?: boolean;
-            disputeReason?: string | null;
-            disputeOpenedAt?: string | null;
-            /**
-             * Arbitrary key-value metadata
-             */
-            metadata?: Record<string, any>;
-            createdAt?: string;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -1772,47 +2303,13 @@ export declare class OrdersService {
         };
     }>;
     /**
-     * Add, update, or remove line items on an order. On a captured order the total delta is charged (increase) or refunded (decrease) automatically.
-     * @param id
-     * @param requestBody
-     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
-     * @returns any Default Response
-     * @throws ApiError
-     */
-    static patchApiV1OrdersLineItems(id: string, requestBody: {
-        add?: Array<{
-            referenceId?: string;
-            name: string;
-            unitPrice: number;
-            quantity: number;
-            type?: string;
-            /**
-             * What this item needs before it counts as delivered. Omit to resolve from `type` and `metadata`. `digital` and `access_grant` are delivered automatically on payment capture; `none` means there is nothing to deliver.
-             */
-            deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
-            /**
-             * Arbitrary key-value metadata
-             */
-            metadata?: Record<string, any>;
-        }>;
-        update?: Array<{
-            lineItemId: string;
-            quantity?: number;
-            unitPrice?: number;
-        }>;
-        remove?: Array<string>;
-    }, xThrottleEnvironmentId?: string): CancelablePromise<any>;
-    /**
-     * Freeze an order operationally. A hold is a flag, not a stage: `status`, `paymentStatus` and `displayStatus` are unchanged, and nothing about money or delivery moves. Holdable while the order is still live (`pending`, `processing`, `partially_fulfilled`, `fulfilled`); a draft, cancelled or closed order answers 422 `order_not_holdable`. Re-holding with the same reason is a no-op and does not restart `heldAt`; a new reason overwrites it. `heldBy` comes from the caller's credentials and cannot be supplied.
+     * Lift a hold. All four hold columns are cleared together. An order that is not held answers 422 `order_not_on_hold`.
      * @param id
-     * @param requestBody
      * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
      * @returns any Default Response
      * @throws ApiError
      */
-    static postApiV1OrdersHold(id: string, requestBody: {
-        reason: string;
-    }, xThrottleEnvironmentId?: string): CancelablePromise<{
+    static postApiV1OrdersHoldRelease(id: string, xThrottleEnvironmentId?: string): CancelablePromise<{
         data?: {
             id?: string;
             workspaceId?: string;
@@ -1840,6 +2337,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1853,7 +2360,7 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
@@ -1863,6 +2370,7 @@ export declare class OrdersService {
             holdReason?: string | null;
             heldAt?: string | null;
             heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -1905,7 +2413,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -1918,6 +2434,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -1928,13 +2478,71 @@ export declare class OrdersService {
         };
     }>;
     /**
-     * Lift a hold. All four hold columns are cleared together. An order that is not held answers 422 `order_not_on_hold`.
+     * Append-only record of every status change on this order, oldest first.
      * @param id
      * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
      * @returns any Default Response
      * @throws ApiError
      */
-    static postApiV1OrdersHoldRelease(id: string, xThrottleEnvironmentId?: string): CancelablePromise<{
+    static getApiV1OrdersStatusHistory(id: string, xThrottleEnvironmentId?: string): CancelablePromise<{
+        data?: Array<{
+            id?: string;
+            fromStatus?: string | null;
+            toStatus?: string;
+            actorType?: 'user' | 'system' | 'integration';
+            actorId?: string | null;
+            reason?: string | null;
+            source?: 'manual' | 'state_machine' | 'fulfillment' | 'payment' | 'migration';
+            createdAt?: string;
+        }>;
+        meta?: {
+            requestId?: string;
+            pagination?: {
+                cursor?: string | null;
+                hasMore?: boolean;
+            };
+        };
+    }>;
+    /**
+     * Everything that happened to this order, newest first: status changes, payment attempts (including declines, which write no status-history row), and fulfillment events. One row shape for every source.
+     * @param id
+     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
+     * @param limit
+     * @param cursor
+     * @returns any Default Response
+     * @throws ApiError
+     */
+    static getApiV1OrdersTimeline(id: string, xThrottleEnvironmentId?: string, limit?: number, cursor?: string): CancelablePromise<{
+        data?: Array<{
+            id: string;
+            at: string;
+            kind: 'status' | 'payment' | 'fulfillment' | 'hold';
+            title: string;
+            detail?: string;
+            amount?: number;
+            currency?: string;
+            source: 'manual' | 'state_machine' | 'fulfillment' | 'payment' | 'migration' | 'provider';
+            actorType?: 'user' | 'system' | 'integration' | 'api_key';
+            actorName?: string;
+            reason?: string;
+            subscriptionId?: string;
+        }>;
+        meta?: {
+            requestId?: string;
+            pagination?: {
+                cursor?: string | null;
+                hasMore?: boolean;
+            };
+        };
+    }>;
+    /**
+     * Close a fulfilled order (archive it from active views)
+     * @param id
+     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
+     * @returns any Default Response
+     * @throws ApiError
+     */
+    static postApiV1OrdersClose(id: string, xThrottleEnvironmentId?: string): CancelablePromise<{
         data?: {
             id?: string;
             workspaceId?: string;
@@ -1962,6 +2570,16 @@ export declare class OrdersService {
             taxTotal?: number;
             buyerVatNumber?: string | null;
             taxReverseCharge?: boolean;
+            taxProviderMessages?: Array<{
+                summary?: string;
+                details?: string;
+                citationCode?: string;
+                refersTo?: string;
+                severity?: string;
+                source?: string;
+                lineNumbers?: Array<string>;
+                lineItemIds?: Array<string>;
+            }>;
             /**
              * Amount in cents (e.g. 1999 = $19.99)
              */
@@ -1975,7 +2593,7 @@ export declare class OrdersService {
              */
             total?: number;
             /**
-             * Amount in cents (e.g. 1999 = $19.99)
+             * Balance written off. A credit against the order, not a re-pricing of it: `total` is unchanged, and what the buyer owes is `total - compAmount`.
              */
             compAmount?: number;
             compReason?: string | null;
@@ -1985,6 +2603,7 @@ export declare class OrdersService {
             holdReason?: string | null;
             heldAt?: string | null;
             heldBy?: string | null;
+            notes?: string | null;
             /**
              * Arbitrary key-value metadata
              */
@@ -2027,7 +2646,15 @@ export declare class OrdersService {
                 phone?: string;
                 email?: string;
             } | null;
+            shippingMethod?: {
+                methodId?: string;
+                displayName?: string;
+                carrier?: string | null;
+                serviceCode?: string | null;
+                amount?: number;
+            } | null;
             customerId?: string | null;
+            subscriptionId?: string | null;
             customer?: {
                 id?: string;
                 email?: string;
@@ -2040,6 +2667,40 @@ export declare class OrdersService {
             closedAt?: string | null;
             createdAt?: string;
             updatedAt?: string;
+            lineItems?: Array<{
+                id?: string;
+                type?: 'product' | 'subscription' | 'service' | 'ticket' | 'donation' | 'custom';
+                referenceId?: string | null;
+                name?: string;
+                description?: string | null;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                unitPrice?: number;
+                quantity?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                subtotal?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                taxAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                discountAmount?: number;
+                /**
+                 * Amount in cents (e.g. 1999 = $19.99)
+                 */
+                total?: number;
+                imageUrl?: string | null;
+                deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+                /**
+                 * Arbitrary key-value metadata
+                 */
+                metadata?: Record<string, any>;
+            }>;
         };
         meta?: {
             requestId?: string;
@@ -2049,5 +2710,95 @@ export declare class OrdersService {
             };
         };
     }>;
+    /**
+     * Refund an order. Spread across its captured payments, newest capture first, when the order was paid in instalments.
+     * @param id
+     * @param requestBody
+     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
+     * @returns any Default Response
+     * @throws ApiError
+     */
+    static postApiV1OrdersRefund(id: string, requestBody: {
+        /**
+         * Partial refund amount (defaults to everything still refundable on the order)
+         */
+        amount?: number;
+        reason?: string;
+    }, xThrottleEnvironmentId?: string): CancelablePromise<{
+        data?: {
+            id?: string;
+            orderId?: string;
+            processor?: string;
+            processorTransactionId?: string | null;
+            processorResponse?: any | null;
+            /**
+             * Amount in cents (e.g. 1999 = $19.99)
+             */
+            amount?: number;
+            /**
+             * Amount actually captured. May be less than `amount` on a partial capture; null until captured.
+             */
+            capturedAmount?: number | null;
+            currency?: string;
+            status?: 'pending' | 'authorized' | 'processing' | 'captured' | 'failed' | 'voided' | 'expired' | 'refunded' | 'partially_refunded';
+            errorCode?: string | null;
+            /**
+             * Why the payment failed. For a manually-marked failure this is the reason the merchant gave.
+             */
+            errorMessage?: string | null;
+            method?: 'card' | 'bank_transfer' | 'wallet' | 'cash' | 'cheque' | 'external' | 'manual' | 'net30';
+            netN?: number;
+            netNSource?: 'customer_override' | 'cart_override' | 'global_default';
+            authorizedAt?: string | null;
+            capturedAt?: string | null;
+            voidedAt?: string | null;
+            disputed?: boolean;
+            disputeReason?: string | null;
+            disputeOpenedAt?: string | null;
+            /**
+             * Arbitrary key-value metadata
+             */
+            metadata?: Record<string, any>;
+            createdAt?: string;
+        };
+        meta?: {
+            requestId?: string;
+            pagination?: {
+                cursor?: string | null;
+                hasMore?: boolean;
+            };
+        };
+    }>;
+    /**
+     * Add, update, or remove line items on an order. On a captured order the total delta is charged (increase) or refunded (decrease) automatically.
+     * @param id
+     * @param requestBody
+     * @param xThrottleEnvironmentId Optional workspace environment id for dashboard-session, Clerk JWT, and extension-session requests. API keys are already pinned to one workspace environment.
+     * @returns any Default Response
+     * @throws ApiError
+     */
+    static patchApiV1OrdersLineItems(id: string, requestBody: {
+        add?: Array<{
+            referenceId?: string;
+            name: string;
+            unitPrice: number;
+            quantity: number;
+            type?: string;
+            /**
+             * What this item needs before it counts as delivered. Omit to resolve from `type` and `metadata`. `digital` and `access_grant` are delivered automatically on payment capture; `none` means there is nothing to deliver.
+             */
+            deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
+            /**
+             * Arbitrary key-value metadata
+             */
+            metadata?: Record<string, any>;
+        }>;
+        update?: Array<{
+            lineItemId: string;
+            quantity?: number;
+            unitPrice?: number;
+        }>;
+        remove?: Array<string>;
+    }, xThrottleEnvironmentId?: string): CancelablePromise<any>;
 }
 //# sourceMappingURL=OrdersService.d.ts.map