@stigg/typescript 0.1.0-alpha.9 → 0.1.0-beta.1

package/src/resources/v1/customers/customers.ts

@@ -1,6 +1,17 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
+import * as IntegrationsAPI from './integrations';
+import {
+  IntegrationLinkParams,
+  IntegrationListParams,
+  IntegrationListResponse,
+  IntegrationListResponsesMyCursorIDPage,
+  IntegrationRetrieveParams,
+  IntegrationUnlinkParams,
+  IntegrationUpdateParams,
+  Integrations,
+} from './integrations';
 import * as PaymentMethodAPI from './payment-method';
 import { PaymentMethod, PaymentMethodAttachParams } from './payment-method';
 import * as PromotionalEntitlementsAPI from './promotional-entitlements';
@@ -23,6 +34,7 @@ export class Customers extends APIResource {
   paymentMethod: PaymentMethodAPI.PaymentMethod = new PaymentMethodAPI.PaymentMethod(this._client);
   promotionalEntitlements: PromotionalEntitlementsAPI.PromotionalEntitlements =
     new PromotionalEntitlementsAPI.PromotionalEntitlements(this._client);
+  integrations: IntegrationsAPI.Integrations = new IntegrationsAPI.Integrations(this._client);
 
   /**
    * Retrieves a customer by their unique identifier, including billing information
@@ -61,6 +73,24 @@ export class Customers extends APIResource {
     return this._client.post(path`/api/v1/customers/${id}/archive`, options);
   }
 
+  /**
+   * Checks a single entitlement (feature or credit) for a customer or resource.
+   * Supports `requestedUsage` and `requestedValues` to evaluate against limits or
+   * enum values.
+   *
+   * **Warning:** This REST API endpoint lacks built-in client-side caching, fallback
+   * mechanisms, and low-latency guarantees. It is not recommended for hot-path
+   * entitlement checks. For production use, consider using the Stigg Node Server SDK
+   * with caching or the Sidecar for low-latency cached responses.
+   */
+  checkEntitlement(
+    id: string,
+    query: CustomerCheckEntitlementParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerCheckEntitlementResponse> {
+    return this._client.get(path`/api/v1/customers/${id}/entitlements/check`, { query, ...options });
+  }
+
   /**
    * Imports multiple customers in bulk. Used for migrating customer data from
    * external systems.
@@ -70,7 +100,7 @@ export class Customers extends APIResource {
   }
 
   /**
-   * Get a list of customerresources
+   * Retrieves a paginated list of resources within the same customer.
    */
   listResources(
     id: string,
@@ -92,6 +122,23 @@ export class Customers extends APIResource {
     return this._client.post('/api/v1/customers', { body, ...options });
   }
 
+  /**
+   * Retrieves the effective entitlements for a customer or resource, including
+   * feature and credit entitlements.
+   *
+   * **Warning:** This REST API endpoint lacks built-in client-side caching, fallback
+   * mechanisms, and low-latency guarantees. It is not recommended for hot-path
+   * entitlement checks. For production use, consider using the Stigg Node Server SDK
+   * with caching or the Sidecar for low-latency cached responses.
+   */
+  retrieveEntitlements(
+    id: string,
+    query: CustomerRetrieveEntitlementsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerRetrieveEntitlementsResponse> {
+    return this._client.get(path`/api/v1/customers/${id}/entitlements`, { query, ...options });
+  }
+
   /**
    * Restores an archived customer, allowing them to create new subscriptions again.
    */
@@ -104,6 +151,106 @@ export type CustomerListResponsesMyCursorIDPage = MyCursorIDPage<CustomerListRes
 
 export type CustomerListResourcesResponsesMyCursorIDPage = MyCursorIDPage<CustomerListResourcesResponse>;
 
+/**
+ * Response object
+ */
+export interface CustomerIntegrationResponse {
+  /**
+   * External billing or CRM integration link
+   */
+  data: CustomerIntegrationResponse.Data;
+}
+
+export namespace CustomerIntegrationResponse {
+  /**
+   * External billing or CRM integration link
+   */
+  export interface Data {
+    /**
+     * Integration details
+     */
+    id: string;
+
+    /**
+     * Synced entity id
+     */
+    syncedEntityId: string | null;
+
+    /**
+     * The vendor identifier of integration
+     */
+    vendorIdentifier:
+      | 'AUTH0'
+      | 'ZUORA'
+      | 'STRIPE'
+      | 'HUBSPOT'
+      | 'AWS_MARKETPLACE'
+      | 'SNOWFLAKE'
+      | 'SALESFORCE'
+      | 'BIG_QUERY'
+      | 'OPEN_FGA'
+      | 'APP_STORE';
+
+    /**
+     * Price billing sync revision data containing billing ID, link URL, and price
+     * group package billing ID
+     */
+    syncData?:
+      | Data.SyncRevisionPriceBillingData
+      | Data.SyncRevisionBillingData
+      | Data.SyncRevisionMarketplaceData
+      | null;
+  }
+
+  export namespace Data {
+    /**
+     * Price billing sync revision data containing billing ID, link URL, and price
+     * group package billing ID
+     */
+    export interface SyncRevisionPriceBillingData {
+      /**
+       * Billing integration id
+       */
+      billingId: string;
+
+      /**
+       * Billing integration url
+       */
+      billingLinkUrl: string;
+
+      /**
+       * Price group package billing id
+       */
+      priceGroupPackageBillingId: string;
+    }
+
+    /**
+     * Billing sync revision data containing billing ID and link URL
+     */
+    export interface SyncRevisionBillingData {
+      /**
+       * Billing integration id
+       */
+      billingId: string;
+
+      /**
+       * Billing integration url
+       */
+      billingLinkUrl: string;
+    }
+
+    /**
+     * Marketplace sync revision data containing dimensions
+     */
+    export interface SyncRevisionMarketplaceData {
+      /**
+       * Dimensions of the marketplace sync revision
+       */
+      dimensions: string;
+    }
+  }
+}
+
 /**
  * Response object
  */
@@ -139,10 +286,137 @@ export namespace CustomerResponse {
      */
     updatedAt: string;
 
+    /**
+     * The billing currency of the customer
+     */
+    billingCurrency?:
+      | 'usd'
+      | 'aed'
+      | 'all'
+      | 'amd'
+      | 'ang'
+      | 'aud'
+      | 'awg'
+      | 'azn'
+      | 'bam'
+      | 'bbd'
+      | 'bdt'
+      | 'bgn'
+      | 'bif'
+      | 'bmd'
+      | 'bnd'
+      | 'bsd'
+      | 'bwp'
+      | 'byn'
+      | 'bzd'
+      | 'brl'
+      | 'cad'
+      | 'cdf'
+      | 'chf'
+      | 'cny'
+      | 'czk'
+      | 'dkk'
+      | 'dop'
+      | 'dzd'
+      | 'egp'
+      | 'etb'
+      | 'eur'
+      | 'fjd'
+      | 'gbp'
+      | 'gel'
+      | 'gip'
+      | 'gmd'
+      | 'gyd'
+      | 'hkd'
+      | 'hrk'
+      | 'htg'
+      | 'idr'
+      | 'ils'
+      | 'inr'
+      | 'isk'
+      | 'jmd'
+      | 'jpy'
+      | 'kes'
+      | 'kgs'
+      | 'khr'
+      | 'kmf'
+      | 'krw'
+      | 'kyd'
+      | 'kzt'
+      | 'lbp'
+      | 'lkr'
+      | 'lrd'
+      | 'lsl'
+      | 'mad'
+      | 'mdl'
+      | 'mga'
+      | 'mkd'
+      | 'mmk'
+      | 'mnt'
+      | 'mop'
+      | 'mro'
+      | 'mvr'
+      | 'mwk'
+      | 'mxn'
+      | 'myr'
+      | 'mzn'
+      | 'nad'
+      | 'ngn'
+      | 'nok'
+      | 'npr'
+      | 'nzd'
+      | 'pgk'
+      | 'php'
+      | 'pkr'
+      | 'pln'
+      | 'qar'
+      | 'ron'
+      | 'rsd'
+      | 'rub'
+      | 'rwf'
+      | 'sar'
+      | 'sbd'
+      | 'scr'
+      | 'sek'
+      | 'sgd'
+      | 'sle'
+      | 'sll'
+      | 'sos'
+      | 'szl'
+      | 'thb'
+      | 'tjs'
+      | 'top'
+      | 'try'
+      | 'ttd'
+      | 'tzs'
+      | 'uah'
+      | 'uzs'
+      | 'vnd'
+      | 'vuv'
+      | 'wst'
+      | 'xaf'
+      | 'xcd'
+      | 'yer'
+      | 'zar'
+      | 'zmw'
+      | 'clp'
+      | 'djf'
+      | 'gnf'
+      | 'ugx'
+      | 'pyg'
+      | 'xof'
+      | 'xpf'
+      | null;
+
+    /**
+     * The unique identifier for the entity in the billing provider
+     */
+    billingId?: string | null;
+
     /**
      * Customer level coupon
      */
-    couponId?: string | null;
+    couponId?: (string & {}) | '' | null;
 
     /**
      * The default payment method details
@@ -159,6 +433,11 @@ export namespace CustomerResponse {
      */
     integrations?: Array<Data.Integration>;
 
+    /**
+     * Language to use for this customer
+     */
+    language?: string | null;
+
     /**
      * Additional metadata
      */
@@ -168,6 +447,16 @@ export namespace CustomerResponse {
      * The name of the customer
      */
     name?: string | null;
+
+    /**
+     * Vendor-specific billing passthrough fields.
+     */
+    passthrough?: Data.Passthrough;
+
+    /**
+     * Timezone to use for this customer
+     */
+    timezone?: string | null;
   }
 
   export namespace Data {
@@ -230,6 +519,328 @@ export namespace CustomerResponse {
         | 'OPEN_FGA'
         | 'APP_STORE';
     }
+
+    /**
+     * Vendor-specific billing passthrough fields.
+     */
+    export interface Passthrough {
+      /**
+       * Stripe-specific billing fields for the customer.
+       */
+      stripe?: Passthrough.Stripe;
+
+      /**
+       * Zuora-specific billing fields for the customer.
+       */
+      zuora?: Passthrough.Zuora;
+    }
+
+    export namespace Passthrough {
+      /**
+       * Stripe-specific billing fields for the customer.
+       */
+      export interface Stripe {
+        /**
+         * Physical address
+         */
+        billingAddress?: Stripe.BillingAddress;
+
+        /**
+         * Customer name
+         */
+        customerName?: string;
+
+        /**
+         * Invoice custom fields
+         */
+        invoiceCustomFields?: { [key: string]: string };
+
+        /**
+         * Additional metadata
+         */
+        metadata?: { [key: string]: string };
+
+        /**
+         * Billing provider payment method id, attached to this customer
+         */
+        paymentMethodId?: string;
+
+        /**
+         * Physical address
+         */
+        shippingAddress?: Stripe.ShippingAddress;
+
+        /**
+         * Tax IDs
+         */
+        taxIds?: Array<Stripe.TaxID>;
+      }
+
+      export namespace Stripe {
+        /**
+         * Physical address
+         */
+        export interface BillingAddress {
+          /**
+           * City name
+           */
+          city?: string;
+
+          /**
+           * Country code or name
+           */
+          country?: string;
+
+          /**
+           * Street address line 1
+           */
+          line1?: string;
+
+          /**
+           * Street address line 2
+           */
+          line2?: string;
+
+          /**
+           * Postal or ZIP code
+           */
+          postalCode?: string;
+
+          /**
+           * State or province
+           */
+          state?: string;
+        }
+
+        /**
+         * Physical address
+         */
+        export interface ShippingAddress {
+          /**
+           * City name
+           */
+          city?: string;
+
+          /**
+           * Country code or name
+           */
+          country?: string;
+
+          /**
+           * Street address line 1
+           */
+          line1?: string;
+
+          /**
+           * Street address line 2
+           */
+          line2?: string;
+
+          /**
+           * Postal or ZIP code
+           */
+          postalCode?: string;
+
+          /**
+           * State or province
+           */
+          state?: string;
+        }
+
+        /**
+         * Tax identifier with type and value for customer tax exemptions.
+         */
+        export interface TaxID {
+          /**
+           * The type of tax exemption identifier, such as VAT.
+           */
+          type: string;
+
+          /**
+           * The actual tax identifier value
+           */
+          value: string;
+        }
+      }
+
+      /**
+       * Zuora-specific billing fields for the customer.
+       */
+      export interface Zuora {
+        /**
+         * Physical address
+         */
+        billingAddress?: Zuora.BillingAddress;
+
+        /**
+         * Customers selected currency
+         */
+        currency?:
+          | 'usd'
+          | 'aed'
+          | 'all'
+          | 'amd'
+          | 'ang'
+          | 'aud'
+          | 'awg'
+          | 'azn'
+          | 'bam'
+          | 'bbd'
+          | 'bdt'
+          | 'bgn'
+          | 'bif'
+          | 'bmd'
+          | 'bnd'
+          | 'bsd'
+          | 'bwp'
+          | 'byn'
+          | 'bzd'
+          | 'brl'
+          | 'cad'
+          | 'cdf'
+          | 'chf'
+          | 'cny'
+          | 'czk'
+          | 'dkk'
+          | 'dop'
+          | 'dzd'
+          | 'egp'
+          | 'etb'
+          | 'eur'
+          | 'fjd'
+          | 'gbp'
+          | 'gel'
+          | 'gip'
+          | 'gmd'
+          | 'gyd'
+          | 'hkd'
+          | 'hrk'
+          | 'htg'
+          | 'idr'
+          | 'ils'
+          | 'inr'
+          | 'isk'
+          | 'jmd'
+          | 'jpy'
+          | 'kes'
+          | 'kgs'
+          | 'khr'
+          | 'kmf'
+          | 'krw'
+          | 'kyd'
+          | 'kzt'
+          | 'lbp'
+          | 'lkr'
+          | 'lrd'
+          | 'lsl'
+          | 'mad'
+          | 'mdl'
+          | 'mga'
+          | 'mkd'
+          | 'mmk'
+          | 'mnt'
+          | 'mop'
+          | 'mro'
+          | 'mvr'
+          | 'mwk'
+          | 'mxn'
+          | 'myr'
+          | 'mzn'
+          | 'nad'
+          | 'ngn'
+          | 'nok'
+          | 'npr'
+          | 'nzd'
+          | 'pgk'
+          | 'php'
+          | 'pkr'
+          | 'pln'
+          | 'qar'
+          | 'ron'
+          | 'rsd'
+          | 'rub'
+          | 'rwf'
+          | 'sar'
+          | 'sbd'
+          | 'scr'
+          | 'sek'
+          | 'sgd'
+          | 'sle'
+          | 'sll'
+          | 'sos'
+          | 'szl'
+          | 'thb'
+          | 'tjs'
+          | 'top'
+          | 'try'
+          | 'ttd'
+          | 'tzs'
+          | 'uah'
+          | 'uzs'
+          | 'vnd'
+          | 'vuv'
+          | 'wst'
+          | 'xaf'
+          | 'xcd'
+          | 'yer'
+          | 'zar'
+          | 'zmw'
+          | 'clp'
+          | 'djf'
+          | 'gnf'
+          | 'ugx'
+          | 'pyg'
+          | 'xof'
+          | 'xpf';
+
+        /**
+         * Additional metadata
+         */
+        metadata?: { [key: string]: string };
+
+        /**
+         * Billing provider payment method id, attached to this customer
+         */
+        paymentMethodId?: string;
+      }
+
+      export namespace Zuora {
+        /**
+         * Physical address
+         */
+        export interface BillingAddress {
+          /**
+           * City name
+           */
+          city?: string;
+
+          /**
+           * Country code or name
+           */
+          country?: string;
+
+          /**
+           * Street address line 1
+           */
+          line1?: string;
+
+          /**
+           * Street address line 2
+           */
+          line2?: string;
+
+          /**
+           * Postal or ZIP code
+           */
+          postalCode?: string;
+
+          /**
+           * State or province
+           */
+          state?: string;
+        }
+      }
+    }
   }
 }
 
@@ -257,10 +868,137 @@ export interface CustomerListResponse {
    */
   updatedAt: string;
 
+  /**
+   * The billing currency of the customer
+   */
+  billingCurrency?:
+    | 'usd'
+    | 'aed'
+    | 'all'
+    | 'amd'
+    | 'ang'
+    | 'aud'
+    | 'awg'
+    | 'azn'
+    | 'bam'
+    | 'bbd'
+    | 'bdt'
+    | 'bgn'
+    | 'bif'
+    | 'bmd'
+    | 'bnd'
+    | 'bsd'
+    | 'bwp'
+    | 'byn'
+    | 'bzd'
+    | 'brl'
+    | 'cad'
+    | 'cdf'
+    | 'chf'
+    | 'cny'
+    | 'czk'
+    | 'dkk'
+    | 'dop'
+    | 'dzd'
+    | 'egp'
+    | 'etb'
+    | 'eur'
+    | 'fjd'
+    | 'gbp'
+    | 'gel'
+    | 'gip'
+    | 'gmd'
+    | 'gyd'
+    | 'hkd'
+    | 'hrk'
+    | 'htg'
+    | 'idr'
+    | 'ils'
+    | 'inr'
+    | 'isk'
+    | 'jmd'
+    | 'jpy'
+    | 'kes'
+    | 'kgs'
+    | 'khr'
+    | 'kmf'
+    | 'krw'
+    | 'kyd'
+    | 'kzt'
+    | 'lbp'
+    | 'lkr'
+    | 'lrd'
+    | 'lsl'
+    | 'mad'
+    | 'mdl'
+    | 'mga'
+    | 'mkd'
+    | 'mmk'
+    | 'mnt'
+    | 'mop'
+    | 'mro'
+    | 'mvr'
+    | 'mwk'
+    | 'mxn'
+    | 'myr'
+    | 'mzn'
+    | 'nad'
+    | 'ngn'
+    | 'nok'
+    | 'npr'
+    | 'nzd'
+    | 'pgk'
+    | 'php'
+    | 'pkr'
+    | 'pln'
+    | 'qar'
+    | 'ron'
+    | 'rsd'
+    | 'rub'
+    | 'rwf'
+    | 'sar'
+    | 'sbd'
+    | 'scr'
+    | 'sek'
+    | 'sgd'
+    | 'sle'
+    | 'sll'
+    | 'sos'
+    | 'szl'
+    | 'thb'
+    | 'tjs'
+    | 'top'
+    | 'try'
+    | 'ttd'
+    | 'tzs'
+    | 'uah'
+    | 'uzs'
+    | 'vnd'
+    | 'vuv'
+    | 'wst'
+    | 'xaf'
+    | 'xcd'
+    | 'yer'
+    | 'zar'
+    | 'zmw'
+    | 'clp'
+    | 'djf'
+    | 'gnf'
+    | 'ugx'
+    | 'pyg'
+    | 'xof'
+    | 'xpf'
+    | null;
+
+  /**
+   * The unique identifier for the entity in the billing provider
+   */
+  billingId?: string | null;
+
   /**
    * Customer level coupon
    */
-  couponId?: string | null;
+  couponId?: (string & {}) | '' | null;
 
   /**
    * The default payment method details
@@ -277,6 +1015,11 @@ export interface CustomerListResponse {
    */
   integrations?: Array<CustomerListResponse.Integration>;
 
+  /**
+   * Language to use for this customer
+   */
+  language?: string | null;
+
   /**
    * Additional metadata
    */
@@ -286,6 +1029,16 @@ export interface CustomerListResponse {
    * The name of the customer
    */
   name?: string | null;
+
+  /**
+   * Vendor-specific billing passthrough fields.
+   */
+  passthrough?: CustomerListResponse.Passthrough;
+
+  /**
+   * Timezone to use for this customer
+   */
+  timezone?: string | null;
 }
 
 export namespace CustomerListResponse {
@@ -348,98 +1101,948 @@ export namespace CustomerListResponse {
       | 'OPEN_FGA'
       | 'APP_STORE';
   }
-}
 
-/**
- * Response object
- */
-export interface CustomerImportResponse {
   /**
-   * List of newly created customer IDs from the import operation.
+   * Vendor-specific billing passthrough fields.
    */
-  data: CustomerImportResponse.Data;
-}
+  export interface Passthrough {
+    /**
+     * Stripe-specific billing fields for the customer.
+     */
+    stripe?: Passthrough.Stripe;
 
-export namespace CustomerImportResponse {
-  /**
-   * List of newly created customer IDs from the import operation.
-   */
-  export interface Data {
     /**
-     * Customer IDs created during import
+     * Zuora-specific billing fields for the customer.
      */
-    newCustomers: Array<string>;
+    zuora?: Passthrough.Zuora;
+  }
+
+  export namespace Passthrough {
+    /**
+     * Stripe-specific billing fields for the customer.
+     */
+    export interface Stripe {
+      /**
+       * Physical address
+       */
+      billingAddress?: Stripe.BillingAddress;
+
+      /**
+       * Customer name
+       */
+      customerName?: string;
+
+      /**
+       * Invoice custom fields
+       */
+      invoiceCustomFields?: { [key: string]: string };
+
+      /**
+       * Additional metadata
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Billing provider payment method id, attached to this customer
+       */
+      paymentMethodId?: string;
+
+      /**
+       * Physical address
+       */
+      shippingAddress?: Stripe.ShippingAddress;
+
+      /**
+       * Tax IDs
+       */
+      taxIds?: Array<Stripe.TaxID>;
+    }
+
+    export namespace Stripe {
+      /**
+       * Physical address
+       */
+      export interface BillingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+
+      /**
+       * Physical address
+       */
+      export interface ShippingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+
+      /**
+       * Tax identifier with type and value for customer tax exemptions.
+       */
+      export interface TaxID {
+        /**
+         * The type of tax exemption identifier, such as VAT.
+         */
+        type: string;
+
+        /**
+         * The actual tax identifier value
+         */
+        value: string;
+      }
+    }
+
+    /**
+     * Zuora-specific billing fields for the customer.
+     */
+    export interface Zuora {
+      /**
+       * Physical address
+       */
+      billingAddress?: Zuora.BillingAddress;
+
+      /**
+       * Customers selected currency
+       */
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
+
+      /**
+       * Additional metadata
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Billing provider payment method id, attached to this customer
+       */
+      paymentMethodId?: string;
+    }
+
+    export namespace Zuora {
+      /**
+       * Physical address
+       */
+      export interface BillingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+    }
   }
 }
 
 /**
- * Resource object that belongs to a customer
+ * Response object
  */
-export interface CustomerListResourcesResponse {
-  /**
-   * Resource slug
-   */
-  id: string;
+export interface CustomerCheckEntitlementResponse {
+  data: CustomerCheckEntitlementResponse.Feature | CustomerCheckEntitlementResponse.Credit;
+}
 
-  /**
-   * Timestamp of when the record was created
-   */
-  createdAt: string;
+export namespace CustomerCheckEntitlementResponse {
+  export interface Feature {
+    accessDeniedReason:
+      | 'FeatureNotFound'
+      | 'CustomerNotFound'
+      | 'CustomerIsArchived'
+      | 'CustomerResourceNotFound'
+      | 'NoActiveSubscription'
+      | 'NoFeatureEntitlementInSubscription'
+      | 'RequestedUsageExceedingLimit'
+      | 'RequestedValuesMismatch'
+      | 'BudgetExceeded'
+      | 'Unknown'
+      | 'FeatureTypeMismatch'
+      | 'Revoked'
+      | 'InsufficientCredits'
+      | 'EntitlementNotFound'
+      | null;
+
+    isGranted: boolean;
+
+    type: 'FEATURE';
+
+    currentUsage?: number;
 
-  /**
-   * Timestamp of when the record was last updated
-   */
-  updatedAt: string;
-}
+    /**
+     * Timestamp of the last update to the entitlement grant or configuration.
+     */
+    entitlementUpdatedAt?: string;
 
-export interface CustomerUpdateParams {
-  /**
-   * Customer level coupon
-   */
-  couponId?: string | null;
+    feature?: Feature.Feature;
 
-  /**
-   * The email of the customer
-   */
-  email?: string | null;
+    hasUnlimitedUsage?: boolean;
 
-  /**
-   * List of integrations
-   */
-  integrations?: Array<CustomerUpdateParams.Integration>;
+    resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
 
-  /**
-   * Additional metadata
-   */
-  metadata?: { [key: string]: string };
+    usageLimit?: number | null;
 
-  /**
-   * The name of the customer
-   */
-  name?: string | null;
-}
+    /**
+     * The anchor for calculating the usage period for metered entitlements with a
+     * reset period configured
+     */
+    usagePeriodAnchor?: string;
 
-export namespace CustomerUpdateParams {
-  /**
-   * External billing or CRM integration link
-   */
-  export interface Integration {
     /**
-     * Integration details
+     * The end date of the usage period for metered entitlements with a reset period
+     * configured
      */
-    id: string;
+    usagePeriodEnd?: string;
 
     /**
-     * Synced entity id
+     * The start date of the usage period for metered entitlements with a reset period
+     * configured
      */
-    syncedEntityId: string | null;
+    usagePeriodStart?: string;
 
     /**
-     * The vendor identifier of integration
+     * The next time the entitlement should be recalculated
      */
-    vendorIdentifier:
-      | 'AUTH0'
-      | 'ZUORA'
+    validUntil?: string;
+  }
+
+  export namespace Feature {
+    export interface Feature {
+      /**
+       * The unique reference ID of the entitlement.
+       */
+      id: string;
+
+      /**
+       * The human-readable name of the entitlement, shown in UI elements.
+       */
+      displayName: string;
+
+      /**
+       * The current status of the feature.
+       */
+      featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+
+      /**
+       * The type of feature associated with the entitlement.
+       */
+      featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+    }
+  }
+
+  export interface Credit {
+    accessDeniedReason:
+      | 'FeatureNotFound'
+      | 'CustomerNotFound'
+      | 'CustomerIsArchived'
+      | 'CustomerResourceNotFound'
+      | 'NoActiveSubscription'
+      | 'NoFeatureEntitlementInSubscription'
+      | 'RequestedUsageExceedingLimit'
+      | 'RequestedValuesMismatch'
+      | 'BudgetExceeded'
+      | 'Unknown'
+      | 'FeatureTypeMismatch'
+      | 'Revoked'
+      | 'InsufficientCredits'
+      | 'EntitlementNotFound'
+      | null;
+
+    /**
+     * The currency associated with a credit entitlement.
+     */
+    currency: Credit.Currency;
+
+    currentUsage: number;
+
+    isGranted: boolean;
+
+    type: 'CREDIT';
+
+    usageLimit: number;
+
+    /**
+     * Timestamp of the last update to the credit usage.
+     */
+    usageUpdatedAt: string;
+
+    /**
+     * Timestamp of the last update to the entitlement grant or configuration.
+     */
+    entitlementUpdatedAt?: string;
+
+    /**
+     * The end date of the current billing period for recurring credit grants.
+     */
+    usagePeriodEnd?: string;
+
+    /**
+     * The next time the entitlement should be recalculated
+     */
+    validUntil?: string;
+  }
+
+  export namespace Credit {
+    /**
+     * The currency associated with a credit entitlement.
+     */
+    export interface Currency {
+      /**
+       * The unique identifier of the custom currency.
+       */
+      currencyId: string;
+
+      /**
+       * The display name of the currency.
+       */
+      displayName: string;
+
+      /**
+       * A description of the currency.
+       */
+      description?: string | null;
+
+      /**
+       * Additional metadata associated with the currency.
+       */
+      metadata?: { [key: string]: string } | null;
+
+      /**
+       * The plural form of the currency unit.
+       */
+      unitPlural?: string | null;
+
+      /**
+       * The singular form of the currency unit.
+       */
+      unitSingular?: string | null;
+    }
+  }
+}
+
+/**
+ * Response object
+ */
+export interface CustomerImportResponse {
+  /**
+   * List of newly created customer IDs from the import operation.
+   */
+  data: CustomerImportResponse.Data;
+}
+
+export namespace CustomerImportResponse {
+  /**
+   * List of newly created customer IDs from the import operation.
+   */
+  export interface Data {
+    /**
+     * Customer IDs created during import
+     */
+    newCustomers: Array<string>;
+  }
+}
+
+/**
+ * Resource object that belongs to a customer
+ */
+export interface CustomerListResourcesResponse {
+  /**
+   * Resource slug
+   */
+  id: string;
+
+  /**
+   * Timestamp of when the record was created
+   */
+  createdAt: string;
+
+  /**
+   * Timestamp of when the record was last updated
+   */
+  updatedAt: string;
+}
+
+/**
+ * Response object
+ */
+export interface CustomerRetrieveEntitlementsResponse {
+  /**
+   * The effective entitlements state for a customer or resource.
+   */
+  data: CustomerRetrieveEntitlementsResponse.Data;
+}
+
+export namespace CustomerRetrieveEntitlementsResponse {
+  /**
+   * The effective entitlements state for a customer or resource.
+   */
+  export interface Data {
+    /**
+     * Reason why entitlements access was denied, if applicable
+     */
+    accessDeniedReason: 'CustomerNotFound' | 'NoActiveSubscription' | 'CustomerIsArchived' | null;
+
+    /**
+     * List of effective feature and credit entitlements
+     */
+    entitlements: Array<Data.Feature | Data.Credit>;
+  }
+
+  export namespace Data {
+    export interface Feature {
+      accessDeniedReason:
+        | 'FeatureNotFound'
+        | 'CustomerNotFound'
+        | 'CustomerIsArchived'
+        | 'CustomerResourceNotFound'
+        | 'NoActiveSubscription'
+        | 'NoFeatureEntitlementInSubscription'
+        | 'RequestedUsageExceedingLimit'
+        | 'RequestedValuesMismatch'
+        | 'BudgetExceeded'
+        | 'Unknown'
+        | 'FeatureTypeMismatch'
+        | 'Revoked'
+        | 'InsufficientCredits'
+        | 'EntitlementNotFound'
+        | null;
+
+      isGranted: boolean;
+
+      type: 'FEATURE';
+
+      currentUsage?: number;
+
+      /**
+       * Timestamp of the last update to the entitlement grant or configuration.
+       */
+      entitlementUpdatedAt?: string;
+
+      feature?: Feature.Feature;
+
+      hasUnlimitedUsage?: boolean;
+
+      resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+
+      usageLimit?: number | null;
+
+      /**
+       * The anchor for calculating the usage period for metered entitlements with a
+       * reset period configured
+       */
+      usagePeriodAnchor?: string;
+
+      /**
+       * The end date of the usage period for metered entitlements with a reset period
+       * configured
+       */
+      usagePeriodEnd?: string;
+
+      /**
+       * The start date of the usage period for metered entitlements with a reset period
+       * configured
+       */
+      usagePeriodStart?: string;
+
+      /**
+       * The next time the entitlement should be recalculated
+       */
+      validUntil?: string;
+    }
+
+    export namespace Feature {
+      export interface Feature {
+        /**
+         * The unique reference ID of the entitlement.
+         */
+        id: string;
+
+        /**
+         * The human-readable name of the entitlement, shown in UI elements.
+         */
+        displayName: string;
+
+        /**
+         * The current status of the feature.
+         */
+        featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+
+        /**
+         * The type of feature associated with the entitlement.
+         */
+        featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+      }
+    }
+
+    export interface Credit {
+      accessDeniedReason:
+        | 'FeatureNotFound'
+        | 'CustomerNotFound'
+        | 'CustomerIsArchived'
+        | 'CustomerResourceNotFound'
+        | 'NoActiveSubscription'
+        | 'NoFeatureEntitlementInSubscription'
+        | 'RequestedUsageExceedingLimit'
+        | 'RequestedValuesMismatch'
+        | 'BudgetExceeded'
+        | 'Unknown'
+        | 'FeatureTypeMismatch'
+        | 'Revoked'
+        | 'InsufficientCredits'
+        | 'EntitlementNotFound'
+        | null;
+
+      /**
+       * The currency associated with a credit entitlement.
+       */
+      currency: Credit.Currency;
+
+      currentUsage: number;
+
+      isGranted: boolean;
+
+      type: 'CREDIT';
+
+      usageLimit: number;
+
+      /**
+       * Timestamp of the last update to the credit usage.
+       */
+      usageUpdatedAt: string;
+
+      /**
+       * Timestamp of the last update to the entitlement grant or configuration.
+       */
+      entitlementUpdatedAt?: string;
+
+      /**
+       * The end date of the current billing period for recurring credit grants.
+       */
+      usagePeriodEnd?: string;
+
+      /**
+       * The next time the entitlement should be recalculated
+       */
+      validUntil?: string;
+    }
+
+    export namespace Credit {
+      /**
+       * The currency associated with a credit entitlement.
+       */
+      export interface Currency {
+        /**
+         * The unique identifier of the custom currency.
+         */
+        currencyId: string;
+
+        /**
+         * The display name of the currency.
+         */
+        displayName: string;
+
+        /**
+         * A description of the currency.
+         */
+        description?: string | null;
+
+        /**
+         * Additional metadata associated with the currency.
+         */
+        metadata?: { [key: string]: string } | null;
+
+        /**
+         * The plural form of the currency unit.
+         */
+        unitPlural?: string | null;
+
+        /**
+         * The singular form of the currency unit.
+         */
+        unitSingular?: string | null;
+      }
+    }
+  }
+}
+
+export interface CustomerUpdateParams {
+  /**
+   * The billing currency of the customer
+   */
+  billingCurrency?:
+    | 'usd'
+    | 'aed'
+    | 'all'
+    | 'amd'
+    | 'ang'
+    | 'aud'
+    | 'awg'
+    | 'azn'
+    | 'bam'
+    | 'bbd'
+    | 'bdt'
+    | 'bgn'
+    | 'bif'
+    | 'bmd'
+    | 'bnd'
+    | 'bsd'
+    | 'bwp'
+    | 'byn'
+    | 'bzd'
+    | 'brl'
+    | 'cad'
+    | 'cdf'
+    | 'chf'
+    | 'cny'
+    | 'czk'
+    | 'dkk'
+    | 'dop'
+    | 'dzd'
+    | 'egp'
+    | 'etb'
+    | 'eur'
+    | 'fjd'
+    | 'gbp'
+    | 'gel'
+    | 'gip'
+    | 'gmd'
+    | 'gyd'
+    | 'hkd'
+    | 'hrk'
+    | 'htg'
+    | 'idr'
+    | 'ils'
+    | 'inr'
+    | 'isk'
+    | 'jmd'
+    | 'jpy'
+    | 'kes'
+    | 'kgs'
+    | 'khr'
+    | 'kmf'
+    | 'krw'
+    | 'kyd'
+    | 'kzt'
+    | 'lbp'
+    | 'lkr'
+    | 'lrd'
+    | 'lsl'
+    | 'mad'
+    | 'mdl'
+    | 'mga'
+    | 'mkd'
+    | 'mmk'
+    | 'mnt'
+    | 'mop'
+    | 'mro'
+    | 'mvr'
+    | 'mwk'
+    | 'mxn'
+    | 'myr'
+    | 'mzn'
+    | 'nad'
+    | 'ngn'
+    | 'nok'
+    | 'npr'
+    | 'nzd'
+    | 'pgk'
+    | 'php'
+    | 'pkr'
+    | 'pln'
+    | 'qar'
+    | 'ron'
+    | 'rsd'
+    | 'rub'
+    | 'rwf'
+    | 'sar'
+    | 'sbd'
+    | 'scr'
+    | 'sek'
+    | 'sgd'
+    | 'sle'
+    | 'sll'
+    | 'sos'
+    | 'szl'
+    | 'thb'
+    | 'tjs'
+    | 'top'
+    | 'try'
+    | 'ttd'
+    | 'tzs'
+    | 'uah'
+    | 'uzs'
+    | 'vnd'
+    | 'vuv'
+    | 'wst'
+    | 'xaf'
+    | 'xcd'
+    | 'yer'
+    | 'zar'
+    | 'zmw'
+    | 'clp'
+    | 'djf'
+    | 'gnf'
+    | 'ugx'
+    | 'pyg'
+    | 'xof'
+    | 'xpf'
+    | null;
+
+  /**
+   * The unique identifier for the entity in the billing provider
+   */
+  billingId?: string | null;
+
+  /**
+   * Customer level coupon
+   */
+  couponId?: (string & {}) | '' | null;
+
+  /**
+   * The email of the customer
+   */
+  email?: string | null;
+
+  /**
+   * List of integrations
+   */
+  integrations?: Array<CustomerUpdateParams.Integration>;
+
+  /**
+   * Language to use for this customer
+   */
+  language?: string | null;
+
+  /**
+   * Additional metadata
+   */
+  metadata?: { [key: string]: string };
+
+  /**
+   * The name of the customer
+   */
+  name?: string | null;
+
+  /**
+   * Vendor-specific billing passthrough fields.
+   */
+  passthrough?: CustomerUpdateParams.Passthrough;
+
+  /**
+   * Timezone to use for this customer
+   */
+  timezone?: string | null;
+}
+
+export namespace CustomerUpdateParams {
+  /**
+   * External billing or CRM integration link
+   */
+  export interface Integration {
+    /**
+     * Integration details
+     */
+    id: string;
+
+    /**
+     * Synced entity id
+     */
+    syncedEntityId: string | null;
+
+    /**
+     * The vendor identifier of integration
+     */
+    vendorIdentifier:
+      | 'AUTH0'
+      | 'ZUORA'
       | 'STRIPE'
       | 'HUBSPOT'
       | 'AWS_MARKETPLACE'
@@ -449,6 +2052,328 @@ export namespace CustomerUpdateParams {
       | 'OPEN_FGA'
       | 'APP_STORE';
   }
+
+  /**
+   * Vendor-specific billing passthrough fields.
+   */
+  export interface Passthrough {
+    /**
+     * Stripe-specific billing fields for the customer.
+     */
+    stripe?: Passthrough.Stripe;
+
+    /**
+     * Zuora-specific billing fields for the customer.
+     */
+    zuora?: Passthrough.Zuora;
+  }
+
+  export namespace Passthrough {
+    /**
+     * Stripe-specific billing fields for the customer.
+     */
+    export interface Stripe {
+      /**
+       * Physical address
+       */
+      billingAddress?: Stripe.BillingAddress;
+
+      /**
+       * Customer name
+       */
+      customerName?: string;
+
+      /**
+       * Invoice custom fields
+       */
+      invoiceCustomFields?: { [key: string]: string };
+
+      /**
+       * Additional metadata
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Billing provider payment method id, attached to this customer
+       */
+      paymentMethodId?: string;
+
+      /**
+       * Physical address
+       */
+      shippingAddress?: Stripe.ShippingAddress;
+
+      /**
+       * Tax IDs
+       */
+      taxIds?: Array<Stripe.TaxID>;
+    }
+
+    export namespace Stripe {
+      /**
+       * Physical address
+       */
+      export interface BillingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+
+      /**
+       * Physical address
+       */
+      export interface ShippingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+
+      /**
+       * Tax identifier with type and value for customer tax exemptions.
+       */
+      export interface TaxID {
+        /**
+         * The type of tax exemption identifier, such as VAT.
+         */
+        type: string;
+
+        /**
+         * The actual tax identifier value
+         */
+        value: string;
+      }
+    }
+
+    /**
+     * Zuora-specific billing fields for the customer.
+     */
+    export interface Zuora {
+      /**
+       * Physical address
+       */
+      billingAddress?: Zuora.BillingAddress;
+
+      /**
+       * Customers selected currency
+       */
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
+
+      /**
+       * Additional metadata
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Billing provider payment method id, attached to this customer
+       */
+      paymentMethodId?: string;
+    }
+
+    export namespace Zuora {
+      /**
+       * Physical address
+       */
+      export interface BillingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+    }
+  }
 }
 
 export interface CustomerListParams extends MyCursorIDPageParams {
@@ -495,11 +2420,45 @@ export namespace CustomerListParams {
   }
 }
 
+export interface CustomerCheckEntitlementParams {
+  /**
+   * Currency ID (refId) to check for credit entitlements. Mutually exclusive with
+   * `featureId`.
+   */
+  currencyId?: string;
+
+  /**
+   * Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+   */
+  featureId?: string;
+
+  /**
+   * Requested usage amount to evaluate against the entitlement limit (numeric
+   * features only)
+   */
+  requestedUsage?: number;
+
+  /**
+   * Requested values to evaluate against allowed values (enum features only)
+   */
+  requestedValues?: Array<string>;
+
+  /**
+   * Resource ID to scope the entitlement check to a specific resource
+   */
+  resourceId?: string;
+}
+
 export interface CustomerImportParams {
   /**
    * List of customer objects to import
    */
   customers: Array<CustomerImportParams.Customer>;
+
+  /**
+   * Integration details
+   */
+  integrationId?: string;
 }
 
 export namespace CustomerImportParams {
@@ -519,6 +2478,11 @@ export namespace CustomerImportParams {
      */
     name: string | null;
 
+    /**
+     * Id in the billing provider
+     */
+    billingId?: string;
+
     /**
      * Additional metadata
      */
@@ -529,6 +2493,11 @@ export namespace CustomerImportParams {
      */
     paymentMethodId?: string;
 
+    /**
+     * The unique identifier for the customer in Salesforce integration
+     */
+    salesforceId?: string;
+
     /**
      * Timestamp of when the record was last updated
      */
@@ -544,10 +2513,137 @@ export interface CustomerProvisionParams {
    */
   id: string;
 
+  /**
+   * The billing currency of the customer
+   */
+  billingCurrency?:
+    | 'usd'
+    | 'aed'
+    | 'all'
+    | 'amd'
+    | 'ang'
+    | 'aud'
+    | 'awg'
+    | 'azn'
+    | 'bam'
+    | 'bbd'
+    | 'bdt'
+    | 'bgn'
+    | 'bif'
+    | 'bmd'
+    | 'bnd'
+    | 'bsd'
+    | 'bwp'
+    | 'byn'
+    | 'bzd'
+    | 'brl'
+    | 'cad'
+    | 'cdf'
+    | 'chf'
+    | 'cny'
+    | 'czk'
+    | 'dkk'
+    | 'dop'
+    | 'dzd'
+    | 'egp'
+    | 'etb'
+    | 'eur'
+    | 'fjd'
+    | 'gbp'
+    | 'gel'
+    | 'gip'
+    | 'gmd'
+    | 'gyd'
+    | 'hkd'
+    | 'hrk'
+    | 'htg'
+    | 'idr'
+    | 'ils'
+    | 'inr'
+    | 'isk'
+    | 'jmd'
+    | 'jpy'
+    | 'kes'
+    | 'kgs'
+    | 'khr'
+    | 'kmf'
+    | 'krw'
+    | 'kyd'
+    | 'kzt'
+    | 'lbp'
+    | 'lkr'
+    | 'lrd'
+    | 'lsl'
+    | 'mad'
+    | 'mdl'
+    | 'mga'
+    | 'mkd'
+    | 'mmk'
+    | 'mnt'
+    | 'mop'
+    | 'mro'
+    | 'mvr'
+    | 'mwk'
+    | 'mxn'
+    | 'myr'
+    | 'mzn'
+    | 'nad'
+    | 'ngn'
+    | 'nok'
+    | 'npr'
+    | 'nzd'
+    | 'pgk'
+    | 'php'
+    | 'pkr'
+    | 'pln'
+    | 'qar'
+    | 'ron'
+    | 'rsd'
+    | 'rub'
+    | 'rwf'
+    | 'sar'
+    | 'sbd'
+    | 'scr'
+    | 'sek'
+    | 'sgd'
+    | 'sle'
+    | 'sll'
+    | 'sos'
+    | 'szl'
+    | 'thb'
+    | 'tjs'
+    | 'top'
+    | 'try'
+    | 'ttd'
+    | 'tzs'
+    | 'uah'
+    | 'uzs'
+    | 'vnd'
+    | 'vuv'
+    | 'wst'
+    | 'xaf'
+    | 'xcd'
+    | 'yer'
+    | 'zar'
+    | 'zmw'
+    | 'clp'
+    | 'djf'
+    | 'gnf'
+    | 'ugx'
+    | 'pyg'
+    | 'xof'
+    | 'xpf'
+    | null;
+
+  /**
+   * The unique identifier for the entity in the billing provider
+   */
+  billingId?: string | null;
+
   /**
    * Customer level coupon
    */
-  couponId?: string | null;
+  couponId?: (string & {}) | '' | null;
 
   /**
    * The default payment method details
@@ -564,6 +2660,11 @@ export interface CustomerProvisionParams {
    */
   integrations?: Array<CustomerProvisionParams.Integration>;
 
+  /**
+   * Language to use for this customer
+   */
+  language?: string | null;
+
   /**
    * Additional metadata
    */
@@ -573,6 +2674,16 @@ export interface CustomerProvisionParams {
    * The name of the customer
    */
   name?: string | null;
+
+  /**
+   * Vendor-specific billing passthrough fields.
+   */
+  passthrough?: CustomerProvisionParams.Passthrough;
+
+  /**
+   * Timezone to use for this customer
+   */
+  timezone?: string | null;
 }
 
 export namespace CustomerProvisionParams {
@@ -635,24 +2746,359 @@ export namespace CustomerProvisionParams {
       | 'OPEN_FGA'
       | 'APP_STORE';
   }
+
+  /**
+   * Vendor-specific billing passthrough fields.
+   */
+  export interface Passthrough {
+    /**
+     * Stripe-specific billing fields for the customer.
+     */
+    stripe?: Passthrough.Stripe;
+
+    /**
+     * Zuora-specific billing fields for the customer.
+     */
+    zuora?: Passthrough.Zuora;
+  }
+
+  export namespace Passthrough {
+    /**
+     * Stripe-specific billing fields for the customer.
+     */
+    export interface Stripe {
+      /**
+       * Physical address
+       */
+      billingAddress?: Stripe.BillingAddress;
+
+      /**
+       * Customer name
+       */
+      customerName?: string;
+
+      /**
+       * Invoice custom fields
+       */
+      invoiceCustomFields?: { [key: string]: string };
+
+      /**
+       * Additional metadata
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Billing provider payment method id, attached to this customer
+       */
+      paymentMethodId?: string;
+
+      /**
+       * Physical address
+       */
+      shippingAddress?: Stripe.ShippingAddress;
+
+      /**
+       * Tax IDs
+       */
+      taxIds?: Array<Stripe.TaxID>;
+    }
+
+    export namespace Stripe {
+      /**
+       * Physical address
+       */
+      export interface BillingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+
+      /**
+       * Physical address
+       */
+      export interface ShippingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+
+      /**
+       * Tax identifier with type and value for customer tax exemptions.
+       */
+      export interface TaxID {
+        /**
+         * The type of tax exemption identifier, such as VAT.
+         */
+        type: string;
+
+        /**
+         * The actual tax identifier value
+         */
+        value: string;
+      }
+    }
+
+    /**
+     * Zuora-specific billing fields for the customer.
+     */
+    export interface Zuora {
+      /**
+       * Physical address
+       */
+      billingAddress?: Zuora.BillingAddress;
+
+      /**
+       * Customers selected currency
+       */
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
+
+      /**
+       * Additional metadata
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Billing provider payment method id, attached to this customer
+       */
+      paymentMethodId?: string;
+    }
+
+    export namespace Zuora {
+      /**
+       * Physical address
+       */
+      export interface BillingAddress {
+        /**
+         * City name
+         */
+        city?: string;
+
+        /**
+         * Country code or name
+         */
+        country?: string;
+
+        /**
+         * Street address line 1
+         */
+        line1?: string;
+
+        /**
+         * Street address line 2
+         */
+        line2?: string;
+
+        /**
+         * Postal or ZIP code
+         */
+        postalCode?: string;
+
+        /**
+         * State or province
+         */
+        state?: string;
+      }
+    }
+  }
+}
+
+export interface CustomerRetrieveEntitlementsParams {
+  /**
+   * Resource ID to scope entitlements to a specific resource
+   */
+  resourceId?: string;
 }
 
 Customers.PaymentMethod = PaymentMethod;
 Customers.PromotionalEntitlements = PromotionalEntitlements;
+Customers.Integrations = Integrations;
 
 export declare namespace Customers {
   export {
+    type CustomerIntegrationResponse as CustomerIntegrationResponse,
     type CustomerResponse as CustomerResponse,
     type CustomerListResponse as CustomerListResponse,
+    type CustomerCheckEntitlementResponse as CustomerCheckEntitlementResponse,
     type CustomerImportResponse as CustomerImportResponse,
     type CustomerListResourcesResponse as CustomerListResourcesResponse,
+    type CustomerRetrieveEntitlementsResponse as CustomerRetrieveEntitlementsResponse,
     type CustomerListResponsesMyCursorIDPage as CustomerListResponsesMyCursorIDPage,
     type CustomerListResourcesResponsesMyCursorIDPage as CustomerListResourcesResponsesMyCursorIDPage,
     type CustomerUpdateParams as CustomerUpdateParams,
     type CustomerListParams as CustomerListParams,
+    type CustomerCheckEntitlementParams as CustomerCheckEntitlementParams,
     type CustomerImportParams as CustomerImportParams,
     type CustomerListResourcesParams as CustomerListResourcesParams,
     type CustomerProvisionParams as CustomerProvisionParams,
+    type CustomerRetrieveEntitlementsParams as CustomerRetrieveEntitlementsParams,
   };
 
   export { PaymentMethod as PaymentMethod, type PaymentMethodAttachParams as PaymentMethodAttachParams };
@@ -667,4 +3113,15 @@ export declare namespace Customers {
     type PromotionalEntitlementListParams as PromotionalEntitlementListParams,
     type PromotionalEntitlementRevokeParams as PromotionalEntitlementRevokeParams,
   };
+
+  export {
+    Integrations as Integrations,
+    type IntegrationListResponse as IntegrationListResponse,
+    type IntegrationListResponsesMyCursorIDPage as IntegrationListResponsesMyCursorIDPage,
+    type IntegrationRetrieveParams as IntegrationRetrieveParams,
+    type IntegrationUpdateParams as IntegrationUpdateParams,
+    type IntegrationListParams as IntegrationListParams,
+    type IntegrationLinkParams as IntegrationLinkParams,
+    type IntegrationUnlinkParams as IntegrationUnlinkParams,
+  };
 }