chargebee 2.35.1 → 2.37.0

package/types/resources/Customer.d.ts

@@ -30,749 +30,180 @@ declare module 'chargebee' {
     
     email?:string;
     
-    /**
-      * @description Phone number of the customer
-
-      */
-    
     phone?:string;
     
-    /**
-      * @description Company name of the customer.
-
-      */
-    
     company?:string;
     
-    /**
-      * @description The VAT/tax registration number for the customer. For customers with [billing_address](customers#customer_billing_address) `country` as `XI` (which is **United Kingdom - Northern Ireland** ), the first two characters of the [full VAT
-number](https://en.wikipedia.org/wiki/VAT_identification_number) can be overridden by setting [vat_number_prefix](customers#customer_vat_number_prefix).
-
-      */
-    
     vat_number?:string;
     
-    /**
-      * @description When the customer has a [payment_method](customers#customer_payment_method) of `type` `card`, this attribute determines whether to automatically charge the card whenever an invoice [status](invoices#invoice_status) is `payment_due`.  
-**Note**
-
-This setting can be [overridden](subscriptions#create_subscription_for_items_auto_collection) for individual subscriptions of the customer.
-\* on - Chargebee automatically charges the card for invoices that enter `payment_due` `status`. \* off - Automatic charging is disabled; manual payment is required for due invoices.
-
-      */
-    
     auto_collection:AutoCollection;
     
-    /**
-      * @description The preferred offline payment method for the customer. \* sepa_credit - SEPA Credit \* cash - Cash \* no_preference - No Preference \* bank_transfer - Bank Transfer \* check - Check \* boleto - Boleto \* ach_credit - ACH Credit
-
-      */
-    
     offline_payment_method?:OfflinePaymentMethod;
     
-    /**
-      * @description The number of days within which the customer has to make payment for the invoice.
-
-      */
-    
     net_term_days:number;
     
-    /**
-      * @description Returns the recent VAT number validation time.
-
-      */
-    
     vat_number_validated_time?:number;
     
-    /**
-      * @description Represents the VAT validation status. This is applicable if you have configured EU, UK or Australian taxes and the [VAT number validation](https://www.chargebee.com/docs/2.0/uk-vat.html#uk-vat-validation) is enabled. \* not_validated - This status is only applicable for countries in European Zone. This is applicable when both the customer's billing address and the organization's address should be of the same European Zone and EU tax should be configured with the "'Also validate VAT Number for Country of Business'" option in the disabled status. \* undetermined - When Chargebee is not able to validate the VAT number it is stored as 'undetermined'. This can occur due to reasons like service outage etc. VAT numbers with 'undetermined' status will be in queue for validation on daily basis. \* valid - If the given VAT number is valid. \* invalid - If the given VAT number is invalid.
-
-      */
-    
-    vat_number_status?:'valid' | 'undetermined' | 'invalid' | 'not_validated';
-    
-    /**
-      * @description Whether the customer can pay via Direct Debit
-
-      */
+    vat_number_status?:'valid' | 'invalid' | 'not_validated' | 'undetermined';
     
     allow_direct_debit:boolean;
     
-    /**
-      * @description **Note**
-
-Applicable only when the customer's `billing_address.country` is New Zealand, Australia, or in the EU.
-
-When the customer uses a [card](https://apidocs.chargebee.com/docs/api/payment_sources#payment_source_type) [payment source](https://apidocs.chargebee.com/docs/api/customers#customer_primary_payment_source_id), this attribute specifies whether the country of the customer and the card issuer are the same.
-
-The following three location indicators are compared:
-
-* The card issuer's country.
-* The `billing_address.country`.
-* The country to which `created_from_ip` belongs.
-* When all three are the same, this attribute is set to true, otherwise it is set to false.
-
-When all three are the same, this attribute is set to `true`, otherwise it is set to `false`.
-
-      */
-    
     is_location_valid?:boolean;
     
-    /**
-      * @description Timestamp indicating when this customer resource is created.
-
-      */
-    
     created_at:number;
     
-    /**
-      * @description The IP address of the customer when this customer record was created. It's mainly used for [referral integrations](https://www.chargebee.com/docs/marketing-integration-index.html) and validating VAT if the customer is in the EU or UK.
-
-Depending on the method used to create the customer record, the field is set as follows:
-
-* **API** : When creating the `customer` resource through the API, you must include the customer's IP address in a [custom HTTP request header](https://apidocs.chargebee.com/docs/api/advanced-features#user_details) (`chargebee-request-origin-ip`) for Chargebee to capture it.
-* **Checkout** : For `customer` resources created through [Chargebee Checkout](https://www.chargebee.com/docs/2.0/hosted-checkout.html), Chargebee automatically captures the IP address of the customer.
-* **UI** : When [creating a `customer`](https://www.chargebee.com/docs/2.0/customers.html#creating-a-new-customer) resource via the Chargebee Billing UI, this field is not relevant and the value must be ignored.
-
-      */
-    
     created_from_ip?:string;
     
-    /**
-      * @description Indicates the exemption information. You can customize customer exemption based on specific Location, Tax level (Federal, State, County and Local), Category of Tax or specific Tax Name. This is applicable only if you use [Chargebee's AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.  
-To know more about what values you need to provide, refer to this [Avalara's API document](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/sample-transactions/exemption/).
-
-      */
-    
     exemption_details?:any[];
     
-    /**
-      * @description Specifies if the customer is liable for tax \* taxable - Computes tax for the customer based on the [site configuration](https://www.chargebee.com/docs/tax.html). In some cases, depending on the region, shipping_address is needed. If not provided, then billing_address is used to compute tax. If that's not available either, the tax is taken as zero. \* exempt -
-
-* Customer is exempted from tax. When using Chargebee's native [Taxes](https://www.chargebee.com/docs/tax.html) feature or when using the [TaxJar integration](https://www.chargebee.com/docs/taxjar.html), no other action is needed.
-* However, when using our [Avalara integration](https://www.chargebee.com/docs/avalara.html), optionally, specify `entity_code` or `exempt_number` attributes if you use Chargebee's [AvaTax for Sales](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption) or specify `exemption_details` attribute if you use [Chargebee's AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. Tax may still be applied by Avalara for certain values of `entity_code`/`exempt_number`/`exemption_details` based on the state/region/province of the taxable address.
-
-      */
-    
     taxability?:Taxability;
     
-    /**
-      * @description The exemption category of the customer, for USA and Canada. Applicable if you use Chargebee's [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption). \* l - Other or custom \* m - Educational organization \* n - Local government \* h - Commercial agricultural production \* i - Industrial production/manufacturer \* j - Direct pay permit \* k - Direct mail \* p - Commercial aquaculture \* q - Commercial Fishery \* r - Non-resident \* d - Foreign diplomat \* e - Charitable or benevolent organization \* f - Religious organization \* g - Resale \* a - Federal government \* b - State government \* c - Tribe/Status Indian/Indian Band \* med2 - US Medical Device Excise Tax with taxable sales tax \* med1 - US Medical Device Excise Tax with exempt sales tax
-
-      */
-    
     entity_code?:EntityCode;
     
-    /**
-      * @description Any string value that will cause the sale to be exempted. Use this if your finance team manually verifies and tracks exemption certificates. Applicable if you use Chargebee's [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption).
-
-      */
-    
     exempt_number?:string;
     
-    /**
-      * @description Version number of this resource. The `resource_version` is updated with a new timestamp in milliseconds for every change made to the resource. This attribute will be present only if the resource has been updated after 2016-09-28.
-
-      */
-    
     resource_version?:number;
     
-    /**
-      * @description Timestamp indicating when this customer was last updated. This attribute will be present only if the resource has been updated after 2016-09-28.
-
-      */
-    
     updated_at?:number;
     
-    /**
-      * @description Determines which region-specific language Chargebee uses to communicate with the customer. In the absence of the locale attribute, Chargebee will use your site's default language for customer communication.
-
-      */
-    
     locale?:string;
     
-    /**
-      * @description **Note**
-
-Applicable only when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.html) with support for customer-specific billing date is enabled and `billing_date_mode` is `manually_set`.
-Specifies the day of the month for subscription renewals on month-based or year-based plans. Month-based and year-based plans are `item_price` resources where the `item_type` is set to `plan` and `period_unit` is set to `month` and `year` respectively.  
-**Example**
-
-* **Month-based subscriptions** : If `billing_date` is set to `15`, month-based renewals occur on the 15th of the month. It's important to note that if the value is set to `31`, renewals align with the last day of the month. Additionally, in February, a `billing_date` of `29`, `30`, or `31` aligns renewals for the last day of February.
-* **Year-based subscriptions** : A `billing_date` of `15` and a `billing_month` of `7` schedules the renewal on the 15th of July.
-
-      */
-    
     billing_date?:number;
     
-    /**
-      * @description **Note**
-
-Applicable only when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.htm) with support for customer-specific billing date is enabled and `billing_date_mode` is `manually_set`.
-Specifies the renewal month for subscriptions on year-based plans. Year-based plans are `item_price` resources where `item_type` is set to `plan` and `period_unit` is set to `year`.  
-**Example**
-
-The renewal date is 15th July when `billing_date` is `15` and `billing_month` is `7`.
-
-      */
-    
     billing_month?:number;
     
-    /**
-      * @description **Note**
-
-Applicable only when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.html) with support for customer-specific billing date is enabled and `billing_date_mode` is `manually_set`.
-Indicates whether this customer's `billing_date` and `billing_month` values can be changed via the [Change billing date API](customers#change_billing_date). \* manually_set - `billing_date` and `billing_month` can be adjusted via API. \* using_defaults - `billing_date` and `billing_month` are fixed as per Chargebee [site settings](https://www.chargebee.com/docs/2.0/calendar-billing-config.html#configuring-calendar-billing_configuring-site-wide-billing) and not modifiable via API.
-
-      */
-    
     billing_date_mode?:BillingDateMode;
     
-    /**
-      * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. When set, renewals of all the weekly subscriptions of this customer will be aligned to this week day. \* saturday - Saturday \* monday - Monday \* friday - Friday \* sunday - Sunday \* wednesday - Wednesday \* thursday - Thursday \* tuesday - Tuesday
-
-      */
-    
     billing_day_of_week?:'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
     
-    /**
-      * @description Indicates whether this customer's *billing_day_of_week* value is derived as per configurations or its specifically set (overriden). When specifically set, the *billing_day_of_week* will not be reset even when all of the weekly subscriptions are cancelled. \* using_defaults - Billing date is set based on defaults configured. \* manually_set - Billing date is specifically set (default configuration is overridden)
-
-      */
-    
     billing_day_of_week_mode?:BillingDayOfWeekMode;
     
-    /**
-      * @description Indicates whether this customer's personal information has been cleared \* cleared - Cleared \* scheduled_for_clear - Scheduled For Clear \* active - Active
-
-      */
-    
     pii_cleared?:'active' | 'scheduled_for_clear' | 'cleared';
     
-    /**
-      * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver=2#subscription_auto_close_invoices) which takes precedence.
-
-      */
-    
     auto_close_invoices?:boolean;
     
-    /**
-      * @description The subscription channel this object originated from and is maintained in. \* play_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.  
-
-In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](mailto:eap@chargebee.com) for more information.
-\* web - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. \* app_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed.
-
-      */
-    
     channel?:Channel;
     
-    /**
-      * @description This attribute represents the identifier of the most recent version of the [customers](/docs/api/customers) resource. When interacting with our API, the `active_id` ensures you're always referencing the current and most up-to-date version of the [customers](/docs/api/customers) resource. This mechanism is in place to maintain consistent external references and data integrity across business entity changes and updates. `active_id` is present on the resource after the resource is transferred to the destination business entity and it will refer to the most recent version of the resource. Learn more about the [customer transfer feature](https://www.chargebee.com/docs/2.0/mbe-customer-transfer-overview.html) and [setup](https://www.chargebee.com/docs/2.0/mbe-getting-started-with-customer-transfer.html).  
-**Note:**
-
-* If `active_id` and `id` of the customer are the same, then it is the most recent version of the resource.
-* If `active_id` and `id` of the customer are different, then it is a transferred resource.
-* If `active_id` is not present, then the resource is not transferred and there are no business entity-related changes.
-
-      */
-    
     active_id?:string;
     
-    /**
-      * @description Indicates whether or not the customer has been identified as fraudulent. \* suspicious - The customer has been identified as potentially fraudulent by the gateway \* safe - The customer has been marked as safe \* fraudulent - The customer has been marked as fraudulent
-
-      */
+    card_status?:'no_card' | 'valid' | 'expiring' | 'expired' | 'pending_verification' | 'invalid';
     
     fraud_flag?:'safe' | 'suspicious' | 'fraudulent';
     
-    /**
-      * @description The [identifier](payment_sources#payment_source_id) of the customer's [primary payment source](https://www.chargebee.com/docs/2.0/payment-method-overview.html#primary-and-backup-payment-methods)
-
-      */
-    
     primary_payment_source_id?:string;
     
-    /**
-      * @description The [identifier](payment_sources#payment_source_id) of the customer's [backup payment source](https://www.chargebee.com/docs/2.0/payment-method-overview.html#primary-and-backup-payment-methods).
-
-      */
-    
     backup_payment_source_id?:string;
     
-    /**
-      * @description A note for the customer that appears on all their invoice PDFs. This is one of [several notes](https://apidocs.chargebee.com/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
-
-      */
+    billing_address?:Customer.BillingAddress;
     
-    invoice_notes?:string;
+    referral_urls?:Customer.ReferralUrl[];
     
-    /**
-      * @description The unique ID of the [business entity](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver=2#mbe) of this subscription. This is always the same as the [business entity](/docs/api/subscriptions?prod_cat_ver=2#subscription_customer_id) of the customer.
-
-      */
+    contacts?:Customer.Contact[];
     
-    business_entity_id?:string;
+    payment_method?:Customer.PaymentMethod;
     
-    /**
-      * @description **Note**
-
-Applicable only when the [Multi-Currency](https://www.chargebee.com/docs/2.0/multi-currency-pricing.html) feature is enabled.
-Specifies the customer's preferred currency in [ISO 4217](https://www.chargebee.com/docs/supported-currencies.html) format.
-
-      */
+    invoice_notes?:string;
     
-    preferred_currency_code?:string;
+    business_entity_id?:string;
     
-    /**
-      * @description The balance of [promotional credits](promotional_credits) available to the customer.
-
-      */
+    preferred_currency_code?:string;
     
     promotional_credits:number;
     
-    /**
-      * @description Total unbilled charges for this customer
-
-      */
-    
     unbilled_charges:number;
     
-    /**
-      * @description Refundable credits balance of this customer
-
-      */
-    
     refundable_credits:number;
     
-    /**
-      * @description Total unused payments associated with the customer
-
-      */
-    
     excess_payments:number;
     
-    /**
-      * @description Determines whether the customer is e-invoiced. When set to `true` or not set to any value, the customer is e-invoiced so long as e-invoicing is enabled for their country (`billing_address.country`). When set to `false`, the customer is not e-invoiced even if e-invoicing is enabled for their country.  
-**Tip:**
-
-
-It is possible to set a value for this flag even when E-Invoicing is disabled. However, it comes into effect only when E-Invoicing is enabled.
-
-      */
+    balances?:Customer.CustomerBalance[];
     
-    is_einvoice_enabled?:boolean;
+    entity_identifiers?:Customer.EntityIdentifier[];
     
-    /**
-      * @description Determines whether to send e-invoice manually or automatic. \* automatic - Use this value to send e-invoice every time an invoice or credit note is created. \* manual - When manual is selected the automatic e-invoice sending is disabled. Use this value to send e-invoice manually through UI or API. \* site_default - The default value of the site which can be overridden at the customer level.
-
-      */
+    tax_providers_fields?:Customer.TaxProvidersField[];
+    
+    is_einvoice_enabled?:boolean;
     
     einvoicing_method?:EinvoicingMethod;
     
-    /**
-      * @description Indicates that this resource has been deleted.
-
-      */
+    meta_data?:object;
     
     deleted:boolean;
     
-    /**
-      * @description Confirms that a customer is registered under GST. If set to `true` then the [Reverse Charge Mechanism](https://www.chargebee.com/docs/australian-gst.html#reverse-charge-mechanism) is applicable. This field is applicable only when Australian GST is configured for your site.
-
-      */
-    
     registered_for_gst?:boolean;
     
-    /**
-      * @description Indicates whether invoices raised on the same day for the `customer` are consolidated. When present, this value overrides the default configuration at the [site-level](https://www.chargebee.com/docs/consolidated-invoicing.html#configuring-consolidated-invoicing). This attribute is applicable only when [Consolidated Invoicing](https://www.chargebee.com/docs/consolidated-invoicing.html) is enabled.  
-**Note:**
-
-
-Any invoices raised when a subscription activates from `in_trial` or `future` `status`, are not consolidated by default. [Contact Support](https://chargebee.freshdesk.com/support/home) to enable consolidation for such invoices.
-
-      */
-    
     consolidated_invoicing?:boolean;
     
-    /**
-      * @description **Note**
-
-Applicable only when the [Chargebee's AvaTax for Communications integration](https://www.chargebee.com/docs/avatax-for-communication.html) is enabled.
-Indicates the [Avalara customer type](https://developer.avalara.com/communications-integration/design-considerations/customer-type/). \* industrial - The customer is an industrial business. \* residential - The customer is an individual user. \* senior_citizen - The customer is an individual that meets the jurisdiction requirements to be considered a senior citizen and qualifies for tax breaks. \* business - The customer represents a business.
-
-      */
-    
     customer_type?:CustomerType;
     
-    /**
-      * @description Confirms that a customer is a valid business without an EU/UK VAT number.
-
-      */
-    
     business_customer_without_vat_number?:boolean;
     
-    /**
-      * @description **Note**
-
-Applicable only when the [Chargebee's AvaTax for Communications integration](https://www.chargebee.com/docs/avatax-for-communication.html) is enabled.
-The [Avalara client profile ID](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/client-profiles/) assigned to the customer.
-
-      */
-    
     client_profile_id?:string;
     
-    /**
-      * @description Indicates whether the site-default settings are being used for controlling access to the customer's information.
-The level of access is for data falling into two categories:
-
-* **Self-Serve Portal data:** subscriptions and invoices of the customer.
-* **Email Notifications:** subscription-, invoice- and payment-related notifications for the customer.
-
-      */
+    relationship?:Customer.Relationship;
     
     use_default_hierarchy_settings?:boolean;
     
-    /**
-      * @description An overridden value for the first two characters of the [full VAT
-number](https://en.wikipedia.org/wiki/VAT_identification_number). Only applicable specifically for customers with [billing_address](customers#customer_billing_address) `country` as `XI` (which is **United Kingdom - Northern Ireland** ).  
-
-When you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or have [manually
-enabled](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, you have the option of setting [billing_address](customers#customer_billing_address) `country` as `XI`. That's the code for **United Kingdom - Northern
-Ireland** . The first two characters of the VAT number in such a case is `XI` by default. However, if the VAT number was registered in UK, the value should be `GB`. Set `vat_number_prefix` to `GB` for such cases.
-
-      */
+    parent_account_access?:Customer.ParentAccountAccess;
     
-    vat_number_prefix?:string;
+    child_account_access?:Customer.ChildAccountAccess;
     
-    /**
-      * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, `DE:VAT` is used for a German business entity while `DE:LWID45` is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under `billing_address.country`. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).  
-**Tip:**
-
-
-If there are additional entity identifiers for the customer not associated with the `vat_number`, they can be provided as the `entity_identifiers[]` array.
-
-      */
+    vat_number_prefix?:string;
     
     entity_identifier_scheme?:string;
     
-    /**
-      * @description The standard used for specifying the `entity_identifier_scheme`. Currently only `iso6523-actorid-upis` is supported and is used by default when not provided.  
-**Tip:**
-
-
-If there are additional entity identifiers for the customer not associated with the `vat_number`, they can be provided as the `entity_identifiers[]` array.
-
-      */
-    
     entity_identifier_standard?:string;
-    
-    /**
-      * @description Billing address for a customer.
-
-      */
-    
-    billing_address?:Customer.BillingAddress;
-    
-    /**
-      * @description List of referral urls for the customer (if applicable)
-
-      */
-    
-    referral_urls?:Customer.ReferralUrl[];
-    
-    /**
-      * @description contacts
-
-      */
-    
-    contacts?:Customer.Contact[];
-    
-    /**
-      * @description Primary Payment Source of the customer.
-
-      */
-    
-    payment_method?:Customer.PaymentMethod;
-    
-    /**
-      * @description The list of balances for this customer
-
-      */
-    
-    balances?:Customer.CustomerBalance[];
-    
-    /**
-      * @description Each element of the `entity_identifiers[]` array identifies a specific customer entity with the e-invoicing system. If the customer has only one entity identifier whose `value` is the `vat_number`, then this array is not needed as the `scheme` can be provided via `entity_identifier_scheme`. This array holds any additional entity identifiers that the customer may have.
-
-      */
-    
-    entity_identifiers?:Customer.EntityIdentifier[];
-    
-    tax_providers_fields?:Customer.TaxProvidersField[];
-    
-    /**
-      * @description The [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html) relationship that the customer is part of.
-
-      */
-    
-    relationship?:Customer.Relationship;
-    
-    /**
-      * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this attribute defines the level of access that the parent account has to the customer's information.
-**Note:** the 'parent' is the customer whose id is [payment_owner_id](customers#customer_relationship_payment_owner_id). However, if the `payment_owner_id` is the customer itself, then the parent is [parent_id](customers#customer_relationship_parent_id).
-
-      */
-    
-    parent_account_access?:Customer.ParentAccountAccess;
-    
-    /**
-      * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this attribute defines the level of access that the customer has to its own information.
-
-      */
-    
-    child_account_access?:Customer.ChildAccountAccess;
   }
   export namespace Customer {
     export class CustomerResource {  
-      /**
-        * @description **Note:** This operation optionally supports 3DS verification flow. To achieve the same, create the [Payment Intent](/docs/api/3ds_card_payments?prod_cat_ver=1) and pass it as input parameter to this API.
-
-Creates a customer. You can create a customer and then create subscriptions for the customer when required. When creating a customer, you can pass along the billing address and card details.
-
-Passing raw card data via API involves PCI liability at your end due to the sensitivity of the data. Instead, you can use one of the following integration options as applicable:
-
-Here's some resources you can use to collect card information within your checkout form based on the payment gateway you use:
-
-* [Stripe.js](https://stripe.com/docs/js) for Stripe users.
-* [Braintree.js](https://developer.paypal.com/braintree/docs/guides/client-sdk/setup/javascript/v2) for Braintree users.
-* [Accept.js](https://developer.authorize.net/api/reference/features/acceptjs.html), if you use [Authorize.Net](https://www.authorize.net/).
-* If you are using the Adyen gateway, you will have to use the Adyen's [Client-Side Encryption](https://docs.adyen.com/online-payments/classic-integrations/api-integration-ecommerce/cse-integration-ecommerce) to encrypt sensitive cardholder data. Once the cardholder data is encrypted, pass the value in `adyen.encrypted.data`as temp token in this API.
-* You can also use our [Hosted Pages](https://www.chargebee.com/docs/1.0/hosted_pages.html) based integration.
-
-When billing address is not passed (say, for customers making offline payments), you can always provide it later using the [Update billing info for a customer API](/docs/api/customers#update_billing_info_for_a_customer).
-
-**Note:**When an invoice is generated for a customer, the billing address provided for the customer is stored with the invoice. If the First Name, Last Name, and Company fields of the billing address do not contain any information, they're picked up from the customer details.
-
-        */
-      
       create(input?:CreateInputParam):ChargebeeRequest<CreateResponse>;
        
-      /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
-
-        */
-      
       list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
        
-      /**
-        * @description Retrieves the details of the desired customer. You can use the unique identifier for a particular customer to retrieve the desired details.
-
-        */
-      
       retrieve(customer_id:string):ChargebeeRequest<RetrieveResponse>;
        
-      /**
-        * @description Updates the customer resource. However, this method cannot be used for updating the &#x27;Billing Info&#x27; - the Billing Address and &#x27;vat_number&#x27; attributes - of the customer. To update the same, use our [Update Billing Info](/docs/api/customers#update_billing_info_for_a_customer) API.
-
-        */
-      
       update(customer_id:string, input?:UpdateInputParam):ChargebeeRequest<UpdateResponse>;
        
-      /**
-        * @description We recently released [Payment Sources](/docs/api/payment_sources), which comes with additional options and improvements to the [Card APIs](/docs/api/cards). For this operation, use the [Create using temporary token](/docs/api/payment_sources#create_using_temporary_token) API or [Create using permanent token](/docs/api/payment_sources#create_using_permanent_token) API under Payment Sources to update payment method for the customer.
-
-Updates payment method details for a customer.
-
-**Note:** If you wish to pass the card number, CVV, or the single-use card tokens provided by gateways like Stripe, then use the [Update card for a customer](cards#update_card_for_a_customer) API under Cards resource. This API is not supported for Chargebee Test Gateway, it is provided to help you understand the billing workflow in Chargebee.
-
-**PayPal Express Checkout**   
-You can use this API if you are directly integrating PayPal Express Checkout in your website instead of using Chargebee&#x27;s hosted pages. When your customer updates his payment method using PayPal Express Checkout, you will be provided with the *Billing Agreement ID* by PayPal. You can update the payment method for that customer in Chargebee by passing &#x60;type&#x60; as &#x60;paypal_express_checkout&#x60; and &#x60;reference_id&#x60; with the *Billing Agreement ID*.
-
-**Login and Pay with Amazon**   
-You can use this API if you are directly integrating *Login and Pay with Amazon* in your website instead of using Chargebee&#x27;s hosted pages. When your customer updates Amazon as a payment method, you will be provided with the *Billing Agreement ID* by Amazon. You can update the payment method for that customer in Chargebee by passing &#x60;type&#x60; as &#x60;amazon_payments&#x60; and &#x60;reference_id&#x60; with the *Billing Agreement ID*.
-
-**Card Payments**   
-When the card details of your customer are stored in the vault of gateways such as Stripe or Braintree, you can use this API to update the *reference id* provided by them in Chargebee. To use this API, pass   
-
-* &#x60;type&#x60; as &#x60;card&#x60;.
-* &#x60;gateway&#x60; with the gateway associated with the card. If the gateway is not specified, the default gateway will be used.
-* &#x60;reference_id&#x60; with the identifier provided by the gateway/Spreedly to reference that specific card.
-
-**Reference id format for Card Payments**   
-The format of reference_id will differ based on where the card is stored.  
-**Stripe:** In case of Stripe, the reference_id consists of combination of Stripe Customer ID and Stripe Card ID separated by forward slash (e.g. *cus_63MnDn0t6kfDW7/card_6WjCF20vT9WN1G*). If you are passing Stripe Customer ID alone, then Chargebee will store the card marked as active for that customer in Stripe.
-
-**Braintree:** In case of Braintree, the reference_id consists of combination of Braintree Customer ID and Braintree Payment Method Token separated by forward slash   
-(e.g. *cus_63MnDn0t6kfDW7/card_6WjCF20vT9WN1G* ). If you are passing Braintree Customer ID alone, then Chargebee will store the card marked as default for that customer in Braintree.
-
-**Spreedly Card vault:** If the card details are stored in Spreedly vault, then you need to provide the Spreedly token as &#x60;reference_id&#x60;.
-
-**Direct Debit Payments**   
-When the bank account details of your customer are stored in the gateway vault, you can use this API to update the reference id provided by them in Chargebee. To use this API, pass   
-
-* &#x60;type&#x60; as &#x60;direct_debit&#x60;.
-* &#x60;gateway&#x60; with the gateway where the bank account details are stored (e.g. *authorize_net*). If the gateway is not specified, the gateway supporting the direct debit will be used.
-* &#x60;reference_id&#x60; with the identifier provided by the gateway to reference the customer&#x27;s bank account details.
-* &#x60;tmp_token&#x60; with the single use token provided by the gateway ( Should be passed only if reference_id is not passed ).
-
-**Reference id format for Direct Debit Payments**   
-The format of reference_id will differ based on where the bank account is stored.  
-**Stripe:** In case of Stripe, the reference_id consists of combination of Stripe Customer ID and Stripe Bank Account ID separated by forward slash   
-(e.g. *cus_8suoHaLQH4G5AW/ba_18b8z2KmcbENlhgU03RznRYW*). If you are passing Stripe Customer ID alone, then Chargebee will store the first bank account details present in payment profile list of that customer in Stripe.
-
-**Authorize.Net:** The reference_id consists of combination of Authorize.Net&#x27;s Customer Profile ID and Payment Profile ID separated by forward slash (e.g. *2384383/34834382*). If you are passing Authorize.Net&#x27;s Customer Profile ID alone, then Chargebee will store the first bank account details present in payment profile list of that customer in Authorize.Net.
-
-**GoCardless:** The reference_id is the GoCardless Customer Mandate ID (e.g. *MD0077Z99TTQXK*).
-
-**Note:** While using this API to update payment method details, [Card Verification](https://www.chargebee.com/docs/cards.html#card-verification) will not happen even if it is enabled for that particular gateway.
-
-        */
-      
-      update_payment_method(customer_id:string, input?:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
+      update_payment_method(customer_id:string, input:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
        
-      /**
-        * @description This method is used for updating the &#x60;billing_address&#x60; and &#x60;vat_number&#x60; attributes of the &#x60;customer&#x60;. For updating the other customer attributes use [Update Customer API](customers#update_a_customer).
-
-During this operation, if &#x60;billing_address&#x60; and &#x60;vat_number&#x60; are not already present, they&#x27;re added. Whereas if present, the existing values are replaced with the new values passed. The only exception here is for &#x60;entity_identifiers[i]&#x60; when &#x60;entity_identifiers[operation][i]&#x60; is passed as &#x60;delete&#x60;.
-
-**Note:**When an invoice is generated for a customer, the billing address provided for the customer will be stored with the invoice. If the First Name, Last Name, and Company fields do not contain any information under Billing Info, the same will be picked from Customer Details if the same is available there.Please ensure that the VAT number is provided whenever the billing address is updated, as failing to do so will override any existing VAT numbers if new values are not provided.
-
-        */
-      
       update_billing_info(customer_id:string, input?:UpdateBillingInfoInputParam):ChargebeeRequest<UpdateBillingInfoResponse>;
        
-      /**
-        * @description This API retrieves all the contacts for a customer.
-
-        */
-      
       contacts_for_customer(customer_id:string, input?:ContactsForCustomerInputParam):ChargebeeRequest<ContactsForCustomerResponse>;
        
-      /**
-        * @description Assign Primary or Backup payment role or unassign role for the payment source based on the preference for the payment collection.
-
-        */
-      
       assign_payment_role(customer_id:string, input:AssignPaymentRoleInputParam):ChargebeeRequest<AssignPaymentRoleResponse>;
        
-      /**
-        * @description Adds the required contact to a customer. You can give the First Name, Last Name, Email ID and more details as input parameters to add them under the desired customer.
-
-        */
-      
-      add_contact(customer_id:string, input?:AddContactInputParam):ChargebeeRequest<AddContactResponse>;
+      add_contact(customer_id:string, input:AddContactInputParam):ChargebeeRequest<AddContactResponse>;
        
-      /**
-        * @description Updates the details of a contact for a customer. You can give the field data to be updated as input parameters along with the Contact ID to update it.
-
-        */
-      
-      update_contact(customer_id:string, input?:UpdateContactInputParam):ChargebeeRequest<UpdateContactResponse>;
+      update_contact(customer_id:string, input:UpdateContactInputParam):ChargebeeRequest<UpdateContactResponse>;
        
-      /**
-        * @description Deletes a particular contact for a customer. You can delete a contact by giving the Contact ID as the input parameter.
-
-        */
-      
-      delete_contact(customer_id:string, input?:DeleteContactInputParam):ChargebeeRequest<DeleteContactResponse>;
+      delete_contact(customer_id:string, input:DeleteContactInputParam):ChargebeeRequest<DeleteContactResponse>;
+       
+      add_promotional_credits(customer_id:string, input:AddPromotionalCreditsInputParam):ChargebeeRequest<AddPromotionalCreditsResponse>;
+       
+      deduct_promotional_credits(customer_id:string, input:DeductPromotionalCreditsInputParam):ChargebeeRequest<DeductPromotionalCreditsResponse>;
+       
+      set_promotional_credits(customer_id:string, input:SetPromotionalCreditsInputParam):ChargebeeRequest<SetPromotionalCreditsResponse>;
        
-      /**
-        * @description Use this API to record any [excess payments](//www.chargebee.com/docs/customers.html#excess-payments) made by the customer, such as advance payments. Such payments will be automatically applied to the future invoices. It can also be [manually applied](//www.chargebee.com/docs/invoice-operations.html#apply-excess-payments) to the existing *Not Paid* or *Payment Due* invoices.
-
-        */
-      
       record_excess_payment(customer_id:string, input:RecordExcessPaymentInputParam):ChargebeeRequest<RecordExcessPaymentResponse>;
        
-      /**
-        * @description **Note:** This operation optionally supports 3DS verification flow. To achieve the same, create the [Payment Intent](/docs/api/#3ds_card_payments) and pass it as input parameter to this API.
-
-This API can be used to collect the payments for customer&#x27;s **payment_due** and **not_paid** invoices. You can either choose to collect the payment from an existing payment source or a new payment source. You can choose to either retain or discard the new payment source, which is being used for payment. If the amount collected exceeds the invoice amount, the surplus will be counted in as excess payments.
-
-        */
-      
-      collect_payment(customer_id:string, input?:CollectPaymentInputParam):ChargebeeRequest<CollectPaymentResponse>;
+      collect_payment(customer_id:string, input:CollectPaymentInputParam):ChargebeeRequest<CollectPaymentResponse>;
        
-      /**
-        * @description Deletes a particular customer identified by the a unique identifier.
-
-        */
-      
       delete(customer_id:string, input?:DeleteInputParam):ChargebeeRequest<DeleteResponse>;
        
-      /**
-        * @description This API copies a customer object from one site to another. The destination site (the site to which the customer is copied) is specified by the path parameter &#x60;{site}&#x60;; whereas, the source site (the site from which the customer is copied) is specified by the query parameter &#x60;from_site&#x60;.
-
-        */
-      
       move(input:MoveInputParam):ChargebeeRequest<MoveResponse>;
        
-      /**
-        * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. Changes the customer&#x27;s *billing_date* and/or *billing_day_of_week*.
-
-        */
-      
       change_billing_date(customer_id:string, input?:ChangeBillingDateInputParam):ChargebeeRequest<ChangeBillingDateResponse>;
        
-      /**
-        * @description This API moves a customer&#x27;s payment methods, subscriptions, invoices, credit notes, transactions, unbilled charges, and orders to another customer. Events and email logs will not be moved. The API execution is asynchronous.  
-**Note**
-
-* Moving virtual bank accounts from one customer to another is not supported in this API.
-* Merging customers from different [business entities](/docs/api?prod_cat_ver&#x3D;2#mbe) is not permitted.
-
-        */
-      
       merge(input:MergeInputParam):ChargebeeRequest<MergeResponse>;
        
-      /**
-        * @description Clear personal details of a customer using this API.
-
-        */
-      
       clear_personal_data(customer_id:string):ChargebeeRequest<ClearPersonalDataResponse>;
        
-      /**
-        * @description Establish a [hierarchical relationship](https://www.chargebee.com/docs/account-hierarchy.html) between customers. The path parameter &#x60;customer_id&#x60; identifies the child in this relationship.  
-**Prerequisite**
-
-Both parent and child customers must be part of the same [business entity](advanced-features#mbe).  
-**Note**
-
-* A customer can have a maximum of 250 direct children.
-* The hierarchy allows a maximum of 5 levels from the root node to the lowest child node.  
-**Note**
-
-For the &#x60;use_default_hierarchy_settings&#x60;, &#x60;parent_account_access&#x60;, and &#x60;child_account_access&#x60; parameters below, the term &quot;parent&quot; usually refers to the customer with the ID [payment_owner_id](customers#link_a_customer_payment_owner_id). However, if the &#x60;payment_owner_id&#x60; is the same as the child&#x27;s ID (&#x60;{customer_id}&#x60;), the &quot;parent&quot; is identified by [parent_id](customers#link_a_customer_parent_id).
-
-        */
-      
       relationships(customer_id:string, input?:RelationshipsInputParam):ChargebeeRequest<RelationshipsResponse>;
        
-      /**
-        * @description When a customer belongs to an [account hierarchy](https://www.chargebee.com/docs/2.0/account-hierarchy.html), this operation detaches the customer from its parent. The hierarchy, if any, beneath the customer remains unchanged.
-
-        */
-      
       delete_relationship(customer_id:string):ChargebeeRequest<DeleteRelationshipResponse>;
        
-      /**
-        * @description Retrieves the full or partial [account hierarchy](/docs/api/hierarchies) for a customer.
-
-        */
-      
       hierarchy(customer_id:string, input:HierarchyInputParam):ChargebeeRequest<HierarchyResponse>;
        
-      /**
-        * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this operation updates the access privileges that both the customer and its parent have to the customer&#x27;s data.  
-**Terminology**
-
-The term &quot;parent&quot; usually refers to the customer with the ID [payment_owner_id](customers#customer_relationship_payment_owner_id). However, if the &#x60;payment_owner_id&#x60; is the same as the child&#x27;s ID (given by the path parameter), the &quot;parent&quot; is identified by [parent_id](customers#customer_relationship_parent_id).  
-**Tip**
-
-You cannot use this endpoint to change the &#x60;parent_id&#x60;, &#x60;invoice_owner_id&#x60; or &#x60;payment_owner_id&#x60; for the customer. To change them, [unlink the customer](customers#delink_a_customer) and then call [Link a customer](customers?prod_cat_ver&#x3D;2#link_a_customer) with the updated values.
-
-        */
-      
       update_hierarchy_settings(customer_id:string, input?:UpdateHierarchySettingsInputParam):ChargebeeRequest<UpdateHierarchySettingsResponse>;
     }
     export interface CreateResponse {  
@@ -782,463 +213,228 @@ You cannot use this endpoint to change the &#x60;parent_id&#x60;, &#x60;invoice_
     }
     export interface CreateInputParam {
       [key : string] : any;  
-      /**
-        * @description Id for the new customer. If not given, this will be auto-generated.
-
-        */
+      card?:{additional_information?:object,billing_addr1?:string,billing_addr2?:string,billing_city?:string,billing_country?:string,billing_state?:string,billing_state_code?:string,billing_zip?:string,cvv?:string,expiry_month?:number,expiry_year?:number,first_name?:string,gateway?:Gateway,gateway_account_id?:string,ip_address?:string,last_name?:string,number?:string,tmp_token?:string};
        
-      id?:string;
+      bank_account?:{account_holder_type?:AccountHolderType,account_number?:string,account_type?:AccountType,bank_code?:string,bank_name?:string,billing_address?:object,company?:string,echeck_type?:EcheckType,email?:string,first_name?:string,gateway_account_id?:string,iban?:string,issuing_country?:string,last_name?:string,phone?:string,routing_number?:string,swedish_identity_number?:string};
        
-      /**
-        * @description First name of the customer.
-
-        */
+      payment_method?:{additional_information?:object,gateway?:Gateway,gateway_account_id?:string,issuing_country?:string,reference_id?:string,tmp_token?:string,type?:Type};
        
-      first_name?:string;
+      payment_intent?:{additional_information?:object,gateway_account_id?:string,gw_payment_method_id?:string,gw_token?:string,id?:string,payment_method_type?:'card' | 'ideal' | 'sofort' | 'bancontact' | 'google_pay' | 'dotpay' | 'giropay' | 'apple_pay' | 'upi' | 'netbanking_emandates' | 'paypal_express_checkout' | 'direct_debit' | 'boleto' | 'venmo' | 'amazon_payments' | 'pay_to' | 'faster_payments' | 'sepa_instant_transfer' | 'klarna_pay_now' | 'online_banking_poland',reference_id?:string};
        
-      /**
-        * @description Last name of the customer.
-
-        */
+      billing_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
        
-      last_name?:string;
+      entity_identifiers?:{id?:string,scheme?:string,standard?:string,value?:string}[];
        
-      /**
-        * @description Email of the customer. Configured email notifications will be sent to this email.
-
-        */
+      tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
        
-      email?:string;
+      id?:string;
        
-      /**
-        * @description The currency code (ISO 4217 format) of the customer. Applicable if Multicurrency is enabled.
-
-        */
+      first_name?:string;
        
-      preferred_currency_code?:string;
+      last_name?:string;
        
-      /**
-        * @description Phone number of the customer.
-
-        */
+      email?:string;
        
-      phone?:string;
+      preferred_currency_code?:string;
        
-      /**
-        * @description Company name of the customer.
-
-        */
+      phone?:string;
        
       company?:string;
        
-      /**
-        * @description Whether payments needs to be collected automatically for this customer. \* on - Whenever an invoice is created, an automatic attempt to charge the customer&#x27;s payment method is made. \* off - Automatic collection of charges will not be made. All payments must be recorded offline.
-
-        */
-       
       auto_collection?:AutoCollection;
        
-      /**
-        * @description The number of days within which the customer has to make payment for the invoice. .
-
-        */
-       
       net_term_days?:number;
        
-      /**
-        * @description Whether the customer can pay via Direct Debit.
-
-        */
-       
       allow_direct_debit?:boolean;
        
-      /**
-        * @description The VAT/tax registration number for the customer. For customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ), the first two characters of the [full VAT
-number](https://en.wikipedia.org/wiki/VAT_identification_number) can be overridden by setting [vat_number_prefix](customers#customer_vat_number_prefix).
-
-        */
-       
       vat_number?:string;
        
-      /**
-        * @description An overridden value for the first two characters of the [full VAT
-number](https://en.wikipedia.org/wiki/VAT_identification_number). Only applicable specifically for customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ).  
-
-When you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or have [manually
-enabled](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, you have the option of setting [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60;. That&#x27;s the code for **United Kingdom - Northern
-Ireland** . The first two characters of the VAT number in such a case is &#x60;XI&#x60; by default. However, if the VAT number was registered in UK, the value should be &#x60;GB&#x60;. Set &#x60;vat_number_prefix&#x60; to &#x60;GB&#x60; for such cases.
-
-        */
-       
       vat_number_prefix?:string;
        
-      /**
-        * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, &#x60;DE:VAT&#x60; is used for a German business entity while &#x60;DE:LWID45&#x60; is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under &#x60;billing_address.country&#x60;. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).  
-**Tip:**
-
-
-If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
-.
-
-        */
-       
       entity_identifier_scheme?:string;
        
-      /**
-        * @description The standard used for specifying the &#x60;entity_identifier_scheme&#x60;. Currently only &#x60;iso6523-actorid-upis&#x60; is supported and is used by default when not provided.  
-**Tip:**
-
-
-If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
-.
-
-        */
-       
       entity_identifier_standard?:string;
        
-      /**
-        * @description Confirms that a customer is registered under GST. If set to &#x60;true&#x60; then the [Reverse Charge Mechanism](https://www.chargebee.com/docs/australian-gst.html#reverse-charge-mechanism) is applicable. This field is applicable only when Australian GST is configured for your site.
-
-        */
-       
       registered_for_gst?:boolean;
        
-      /**
-        * @description Determines whether the customer is e-invoiced. When set to &#x60;true&#x60; or not set to any value, the customer is e-invoiced so long as e-invoicing is enabled for their country (&#x60;billing_address.country&#x60;). When set to &#x60;false&#x60;, the customer is not e-invoiced even if e-invoicing is enabled for their country.  
-**Tip:**
-
-
-It is possible to set a value for this flag even when E-Invoicing is disabled. However, it comes into effect only when E-Invoicing is enabled.
-.
-
-        */
-       
       is_einvoice_enabled?:boolean;
        
-      /**
-        * @description Determines whether to send an e-invoice manually or automatic. \* automatic - Use this value to send e-invoice every time an invoice or credit note is created. \* manual - When manual is selected the automatic e-invoice sending is disabled. Use this value to send e-invoice manually through UI or API. \* site_default - The default value of the site which can be overridden at the customer level.
-
-        */
-       
       einvoicing_method?:EinvoicingMethod;
        
-      /**
-        * @description Specifies if the customer is liable for tax. \* taxable - Computes tax for the customer based on the [site configuration](https://www.chargebee.com/docs/tax.html). In some cases, depending on the region, shipping_address is needed. If not provided, then billing_address is used to compute tax. If that&#x27;s not available either, the tax is taken as zero. \* exempt -
-
-* Customer is exempted from tax. When using Chargebee&#x27;s native [Taxes](https://www.chargebee.com/docs/tax.html) feature or when using the [TaxJar integration](https://www.chargebee.com/docs/taxjar.html), no other action is needed.
-* However, when using our [Avalara integration](https://www.chargebee.com/docs/avalara.html), optionally, specify &#x60;entity_code&#x60; or &#x60;exempt_number&#x60; attributes if you use Chargebee&#x27;s [AvaTax for Sales](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption) or specify &#x60;exemption_details&#x60; attribute if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. Tax may still be applied by Avalara for certain values of &#x60;entity_code&#x60;/&#x60;exempt_number&#x60;/&#x60;exemption_details&#x60; based on the state/region/province of the taxable address.
-
-        */
-       
       taxability?:Taxability;
        
-      /**
-        * @description Indicates the exemption information. You can customize customer exemption based on specific Location, Tax level (Federal, State, County and Local), Category of Tax or specific Tax Name. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.  
-To know more about what values you need to provide, refer to this [Avalara&#x27;s API document](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/sample-transactions/exemption/).
-
-        */
-       
       exemption_details?:any[];
        
-      /**
-        * @description Indicates the type of the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. \* industrial - When the purchase is made by an industrial business \* senior_citizen - When the purchase is made by a customer who meets the jurisdiction requirements to be considered a senior citizen and qualifies for senior citizen tax breaks \* business - When the purchase is made at a place of business \* residential - When the purchase is made by a customer for home use
-
-        */
-       
       customer_type?:CustomerType;
        
-      /**
-        * @description Indicates the Client profile id for the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
-
-        */
-       
       client_profile_id?:string;
        
-      /**
-        * @description Indicates the exemption type of the customer. This is applicable only if you use Chargebee&#x27;s TaxJar integration. \* other - Other \* government - Government \* wholesale - Whole-sale
-
-        */
-       
       taxjar_exemption_category?:TaxjarExemptionCategory;
        
-      /**
-        * @description Confirms that a customer is a valid business without an EU/UK VAT number.
-
-        */
-       
       business_customer_without_vat_number?:boolean;
        
-      /**
-        * @description Determines which region-specific language Chargebee uses to communicate with the customer. In the absence of the locale attribute, Chargebee will use your site&#x27;s default language for customer communication.
-
-        */
-       
       locale?:string;
        
-      /**
-        * @description The exemption category of the customer, for USA and Canada. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption). \* l - Other or custom \* m - Educational organization \* n - Local government \* h - Commercial agricultural production \* i - Industrial production/manufacturer \* j - Direct pay permit \* k - Direct mail \* p - Commercial aquaculture \* q - Commercial Fishery \* r - Non-resident \* med2 - US Medical Device Excise Tax with taxable sales tax \* med1 - US Medical Device Excise Tax with exempt sales tax \* d - Foreign diplomat \* e - Charitable or benevolent organization \* f - Religious organization \* g - Resale \* a - Federal government \* b - State government \* c - Tribe/Status Indian/Indian Band
-
-        */
-       
       entity_code?:EntityCode;
        
-      /**
-        * @description Any string value that will cause the sale to be exempted. Use this if your finance team manually verifies and tracks exemption certificates. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption).
-
-        */
-       
       exempt_number?:string;
        
-      /**
-        * @description A collection of key-value pairs that provides extra information about the customer.  
-**Note:** There&#x27;s a character limit of 65,535.
-[Learn more](advanced-features?prod_cat_ver&#x3D;2#metadata).
-
-        */
-       
       meta_data?:object;
        
-      /**
-        * @description The preferred offline payment method for the customer. \* sepa_credit - SEPA Credit \* cash - Cash \* no_preference - No Preference \* bank_transfer - Bank Transfer \* boleto - Boleto \* check - Check \* ach_credit - ACH Credit
-
-        */
-       
       offline_payment_method?:OfflinePaymentMethod;
        
-      /**
-        * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_auto_close_invoices) which takes precedence.
-
-        */
-       
       auto_close_invoices?:boolean;
        
-      /**
-        * @description Indicates whether invoices raised on the same day for the &#x60;customer&#x60; are consolidated. When provided, this overrides the default configuration at the [site-level](https://www.chargebee.com/docs/consolidated-invoicing.html#configuring-consolidated-invoicing). This parameter can be provided only when [Consolidated Invoicing](https://www.chargebee.com/docs/consolidated-invoicing.html) is enabled.  
-**Note:**
-
-Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &#x60;future&#x60; &#x60;status&#x60;, are not consolidated by default. [Contact Support](https://chargebee.freshdesk.com/support/home) to enable consolidation for such invoices.
-.
-
-        */
-       
       consolidated_invoicing?:boolean;
        
-      /**
-        * @description The Chargebee payment token generated by Chargebee JS.
-
-        */
-       
       token_id?:string;
        
-      /**
-        * @description The unique ID of the [business entity](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) this customer should be [linked](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-linked-be) to. Applicable only when multiple business entities have been created for the site. When not provided, the customer is linked to the [default business entity](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-default-be) defined for the site.  
-**Note**
-
-An alternative way of passing this parameter is by means of a [custom HTTP header](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-header-main).
-.
-
-        */
-       
       business_entity_id?:string;
        
-      /**
-        * @description A customer-facing note added to all invoices associated with this API resource. This note becomes one among [all the notes](/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
-
-        */
-       
-      invoice_notes?:string;
-       
-      /**
-        * @description Parameters for card
-
-        */
-       
-      card?:{additional_information?:object,billing_addr1?:string,billing_addr2?:string,billing_city?:string,billing_country?:string,billing_state?:string,billing_state_code?:string,billing_zip?:string,cvv?:string,expiry_month?:number,expiry_year?:number,first_name?:string,gateway_account_id?:string,last_name?:string,number?:string};
-       
-      /**
-        * @description Parameters for bank_account
-
-        */
-       
-      bank_account?:{account_holder_type?:AccountHolderType,account_number?:string,account_type?:AccountType,bank_code?:string,bank_name?:string,billing_address?:object,company?:string,echeck_type?:EcheckType,email?:string,first_name?:string,gateway_account_id?:string,iban?:string,issuing_country?:string,last_name?:string,phone?:string,routing_number?:string,swedish_identity_number?:string};
-       
-      /**
-        * @description Parameters for payment_method
-
-        */
-       
-      payment_method?:{additional_information?:object,gateway_account_id?:string,issuing_country?:string,reference_id?:string,tmp_token?:string,type?:Type};
-       
-      /**
-        * @description Parameters for payment_intent
-
-        */
-       
-      payment_intent?:{additional_information?:object,gateway_account_id?:string,gw_token?:string,id?:string,payment_method_type?:'giropay' | 'ideal' | 'sepa_instant_transfer' | 'google_pay' | 'netbanking_emandates' | 'klarna_pay_now' | 'dotpay' | 'boleto' | 'direct_debit' | 'faster_payments' | 'sofort' | 'upi' | 'venmo' | 'amazon_payments' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'pay_to' | 'card',reference_id?:string};
-       
-      /**
-        * @description Parameters for billing_address
-
-        */
-       
-      billing_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
-       
-      /**
-        * @description Parameters for entity_identifiers
-
-        */
+      created_from_ip?:string;
        
-      entity_identifiers?:{id?:string,scheme?:string,standard?:string,value?:string}[];
+      invoice_notes?:string;
     }
     export interface ListResponse {  
-      /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
-
-        */
-       
        list:{customer:Customer,card?:Card}[];
        
-      /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
-
-        */
-       
        next_offset?:string;
     }
     export interface ListInputParam {
       [key : string]: any;  
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description The number of resources to be returned.
 
         */
         
       limit?:number;
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
 
         */
         
       offset?:string;
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Parameters for relationship
+
+        */
+        
+      relationship?:{invoice_owner_id?:{is?:string,is_not?:string,starts_with?:string},parent_id?:{is?:string,is_not?:string,starts_with?:string},payment_owner_id?:{is?:string,is_not?:string,starts_with?:string}};
+       
+      /**
+        * @description Indicates whether to include deleted objects in the list. The deleted objects have the attribute \&#x60;deleted\&#x60; as \&#x60;true\&#x60;.
 
         */
         
       include_deleted?:boolean;
        
+      include_deprecated?:boolean;
+       
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Identifier of the customer.
 
         */
         
       id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description First name of the customer
 
         */
         
       first_name?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Last name of the customer
 
         */
         
       last_name?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Email of the customer. Configured email notifications will be sent to this email.
 
         */
         
       email?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Company name of the customer.
 
         */
         
       company?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Phone number of the customer
 
         */
         
       phone?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Whether payments needs to be collected automatically for this customer
 
         */
         
-      auto_collection?:{in?:string,is?:'off' | 'on',is_not?:'off' | 'on',not_in?:string};
+      auto_collection?:{in?:string,is?:'on' | 'off',is_not?:'on' | 'off',not_in?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Specifies if the customer is liable for tax
 
         */
         
       taxability?:{in?:string,is?:'taxable' | 'exempt',is_not?:'taxable' | 'exempt',not_in?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Timestamp indicating when this customer resource is created.
 
         */
         
       created_at?:{after?:string,before?:string,between?:string,on?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description To filter based on &#x60;updated_at&#x60;. This attribute will be present only if the resource has been updated after 2016-09-28. It is advisable when using this filter, to pass the &#x60;sort_by&#x60; input parameter as &#x60;updated_at&#x60; for a faster response.
 
         */
         
       updated_at?:{after?:string,before?:string,between?:string,on?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
-
-        */
-        
-      business_entity_id?:{is?:string,is_not?:string,starts_with?:string};
-       
-      /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description The preferred offline payment method for the customer.
 
         */
         
-      offline_payment_method?:{in?:string,is?:'eu_automated_bank_transfer' | 'bank_transfer' | 'mx_automated_bank_transfer' | 'custom' | 'ach_credit' | 'boleto' | 'check' | 'uk_automated_bank_transfer' | 'no_preference' | 'us_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'sepa_credit' | 'cash',is_not?:'eu_automated_bank_transfer' | 'bank_transfer' | 'mx_automated_bank_transfer' | 'custom' | 'ach_credit' | 'boleto' | 'check' | 'uk_automated_bank_transfer' | 'no_preference' | 'us_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'sepa_credit' | 'cash',not_in?:string};
+      offline_payment_method?:{in?:string,is?:'no_preference' | 'cash' | 'check' | 'bank_transfer' | 'ach_credit' | 'sepa_credit' | 'boleto' | 'us_automated_bank_transfer' | 'eu_automated_bank_transfer' | 'uk_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'mx_automated_bank_transfer' | 'custom',is_not?:'no_preference' | 'cash' | 'check' | 'bank_transfer' | 'ach_credit' | 'sepa_credit' | 'boleto' | 'us_automated_bank_transfer' | 'eu_automated_bank_transfer' | 'uk_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'mx_automated_bank_transfer' | 'custom',not_in?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_auto_close_invoices) which takes precedence.
 
         */
         
       auto_close_invoices?:{is?:'true' | 'false'};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description The subscription channel this object originated from and is maintained in.
 
         */
         
-      channel?:{in?:string,is?:'app_store' | 'web' | 'play_store',is_not?:'app_store' | 'web' | 'play_store',not_in?:string};
+      channel?:{in?:string,is?:'web' | 'app_store' | 'play_store',is_not?:'web' | 'app_store' | 'play_store',not_in?:string};
        
       /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+        * @description The unique ID of the [business entity](/docs/api?prod_cat_ver&#x3D;2#mbe) of this subscription. This is always the same as the [business entity](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_customer_id) of the customer.  
+The ID of the business entity created for the site. For Product Catalog 1.0, all the site data is tied to this business entity.  
+**Note**
 
-        */
-        
-      sort_by?:{asc?:'updated_at' | 'created_at',desc?:'updated_at' | 'created_at'};
-       
-      /**
-        * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
+[Multiple Business Entities](/docs/api?prod_cat_ver&#x3D;2#mbe) is a feature available only on Product Catalog 2.0.
 
         */
         
-      relationship?:{invoice_owner_id?:{is?:string,is_not?:string,starts_with?:string},parent_id?:{is?:string,is_not?:string,starts_with?:string},payment_owner_id?:{is?:string,is_not?:string,starts_with?:string}};
+      business_entity_id?:{is?:string};
+       
+      sort_by?:{asc?:'created_at' | 'updated_at',desc?:'created_at' | 'updated_at'};
     }
     export interface RetrieveResponse {  
        customer:Customer;
@@ -1253,175 +449,52 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
     }
     export interface UpdateInputParam {
       [key : string] : any;  
-      /**
-        * @description First name of the customer.
-
-        */
+      tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
        
       first_name?:string;
        
-      /**
-        * @description Last name of the customer.
-
-        */
-       
       last_name?:string;
        
-      /**
-        * @description Email of the customer. Configured email notifications will be sent to this email.
-
-        */
-       
       email?:string;
        
-      /**
-        * @description The currency code (ISO 4217 format) of the customer. Applicable if Multicurrency is enabled.
-
-        */
-       
       preferred_currency_code?:string;
        
-      /**
-        * @description Phone number of the customer.
-
-        */
-       
       phone?:string;
        
-      /**
-        * @description Company name of the customer.
-
-        */
-       
       company?:string;
        
-      /**
-        * @description Whether payments needs to be collected automatically for this customer. \* on - Whenever an invoice is created, an automatic attempt to charge the customer&#x27;s payment method is made. \* off - Automatic collection of charges will not be made. All payments must be recorded offline.
-
-        */
-       
       auto_collection?:AutoCollection;
        
-      /**
-        * @description Whether the customer can pay via Direct Debit.
-
-        */
-       
       allow_direct_debit?:boolean;
        
-      /**
-        * @description The number of days within which the customer has to make payment for the invoice. .
-
-        */
-       
       net_term_days?:number;
        
-      /**
-        * @description Specifies if the customer is liable for tax. \* taxable - Computes tax for the customer based on the [site configuration](https://www.chargebee.com/docs/tax.html). In some cases, depending on the region, shipping_address is needed. If not provided, then billing_address is used to compute tax. If that&#x27;s not available either, the tax is taken as zero. \* exempt -
-
-* Customer is exempted from tax. When using Chargebee&#x27;s native [Taxes](https://www.chargebee.com/docs/tax.html) feature or when using the [TaxJar integration](https://www.chargebee.com/docs/taxjar.html), no other action is needed.
-* However, when using our [Avalara integration](https://www.chargebee.com/docs/avalara.html), optionally, specify &#x60;entity_code&#x60; or &#x60;exempt_number&#x60; attributes if you use Chargebee&#x27;s [AvaTax for Sales](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption) or specify &#x60;exemption_details&#x60; attribute if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. Tax may still be applied by Avalara for certain values of &#x60;entity_code&#x60;/&#x60;exempt_number&#x60;/&#x60;exemption_details&#x60; based on the state/region/province of the taxable address.
-
-        */
-       
       taxability?:Taxability;
        
-      /**
-        * @description Indicates the exemption information. You can customize customer exemption based on specific Location, Tax level (Federal, State, County and Local), Category of Tax or specific Tax Name. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.  
-To know more about what values you need to provide, refer to this [Avalara&#x27;s API document](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/sample-transactions/exemption/).
-
-        */
-       
       exemption_details?:any[];
        
-      /**
-        * @description Indicates the type of the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. \* senior_citizen - When the purchase is made by a customer who meets the jurisdiction requirements to be considered a senior citizen and qualifies for senior citizen tax breaks \* industrial - When the purchase is made by an industrial business \* business - When the purchase is made at a place of business \* residential - When the purchase is made by a customer for home use
-
-        */
-       
       customer_type?:CustomerType;
        
-      /**
-        * @description Indicates the Client profile id for the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
-
-        */
-       
       client_profile_id?:string;
        
-      /**
-        * @description Indicates the exemption type of the customer. This is applicable only if you use Chargebee&#x27;s TaxJar integration. \* government - Government \* other - Other \* wholesale - Whole-sale
-
-        */
-       
       taxjar_exemption_category?:TaxjarExemptionCategory;
        
-      /**
-        * @description Determines which region-specific language Chargebee uses to communicate with the customer. In the absence of the locale attribute, Chargebee will use your site&#x27;s default language for customer communication.
-
-        */
-       
       locale?:string;
        
-      /**
-        * @description The exemption category of the customer, for USA and Canada. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption). \* med2 - US Medical Device Excise Tax with taxable sales tax \* med1 - US Medical Device Excise Tax with exempt sales tax \* d - Foreign diplomat \* e - Charitable or benevolent organization \* f - Religious organization \* g - Resale \* a - Federal government \* b - State government \* c - Tribe/Status Indian/Indian Band \* l - Other or custom \* m - Educational organization \* n - Local government \* h - Commercial agricultural production \* i - Industrial production/manufacturer \* j - Direct pay permit \* k - Direct mail \* p - Commercial aquaculture \* q - Commercial Fishery \* r - Non-resident
-
-        */
-       
       entity_code?:EntityCode;
        
-      /**
-        * @description Any string value that will cause the sale to be exempted. Use this if your finance team manually verifies and tracks exemption certificates. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption).
-
-        */
-       
       exempt_number?:string;
        
-      /**
-        * @description The preferred offline payment method for the customer. \* bank_transfer - Bank Transfer \* boleto - Boleto \* sepa_credit - SEPA Credit \* cash - Cash \* check - Check \* no_preference - No Preference \* ach_credit - ACH Credit
-
-        */
-       
       offline_payment_method?:OfflinePaymentMethod;
        
-      /**
-        * @description A customer-facing note added to all invoices associated with this API resource. This note becomes one among [all the notes](/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
-
-        */
-       
       invoice_notes?:string;
        
-      /**
-        * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_auto_close_invoices) which takes precedence.
-
-        */
-       
       auto_close_invoices?:boolean;
        
-      /**
-        * @description A collection of key-value pairs that provides extra information about the customer.  
-**Note:** There&#x27;s a character limit of 65,535.
-[Learn more](advanced-features?prod_cat_ver&#x3D;2#metadata).
-
-        */
-       
       meta_data?:object;
        
-      /**
-        * @description Indicates whether or not the customer has been identified as fraudulent. \* fraudulent - The customer has been marked as fraudulent \* suspicious - The customer has been identified as potentially fraudulent by the gateway \* safe - The customer has been marked as safe
-
-        */
-       
       fraud_flag?:'safe' | 'fraudulent';
        
-      /**
-        * @description Indicates whether invoices raised on the same day for the &#x60;customer&#x60; are consolidated. When provided, this overrides the default configuration at the [site-level](https://www.chargebee.com/docs/consolidated-invoicing.html#configuring-consolidated-invoicing). This parameter can be provided only when [Consolidated Invoicing](https://www.chargebee.com/docs/consolidated-invoicing.html) is enabled.  
-**Note:**
-
-Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &#x60;future&#x60; &#x60;status&#x60;, are not consolidated by default. [Contact Support](https://chargebee.freshdesk.com/support/home) to enable consolidation for such invoices.
-.
-
-        */
-       
       consolidated_invoicing?:boolean;
     }
     export interface UpdatePaymentMethodResponse {  
@@ -1431,12 +504,7 @@ Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &
     }
     export interface UpdatePaymentMethodInputParam {
        
-      /**
-        * @description Parameters for payment_method
-
-        */
-       
-      payment_method:{additional_information?:object,gateway_account_id?:string,issuing_country?:string,reference_id?:string,tmp_token?:string,type:Type};
+      payment_method:{additional_information?:object,gateway?:Gateway,gateway_account_id?:string,issuing_country?:string,reference_id?:string,tmp_token?:string,type:Type};
     }
     export interface UpdateBillingInfoResponse {  
        customer:Customer;
@@ -1445,123 +513,44 @@ Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &
     }
     export interface UpdateBillingInfoInputParam {
        
-      /**
-        * @description The VAT/tax registration number for the customer. For customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ), the first two characters of the [full VAT
-number](https://en.wikipedia.org/wiki/VAT_identification_number) can be overridden by setting [vat_number_prefix](customers#customer_vat_number_prefix).
-
-        */
+      billing_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
        
-      vat_number?:string;
+      entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
        
-      /**
-        * @description An overridden value for the first two characters of the [full VAT
-number](https://en.wikipedia.org/wiki/VAT_identification_number). Only applicable specifically for customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ).  
-
-When you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or have [manually
-enabled](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, you have the option of setting [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60;. That&#x27;s the code for **United Kingdom - Northern
-Ireland** . The first two characters of the VAT number in such a case is &#x60;XI&#x60; by default. However, if the VAT number was registered in UK, the value should be &#x60;GB&#x60;. Set &#x60;vat_number_prefix&#x60; to &#x60;GB&#x60; for such cases.
-
-        */
+      tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
        
-      vat_number_prefix?:string;
+      vat_number?:string;
        
-      /**
-        * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, &#x60;DE:VAT&#x60; is used for a German business entity while &#x60;DE:LWID45&#x60; is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under &#x60;billing_address.country&#x60;. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).  
-**Tip:**
-
-
-If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
-.
-
-        */
+      vat_number_prefix?:string;
        
       entity_identifier_scheme?:string;
        
-      /**
-        * @description The standard used for specifying the &#x60;entity_identifier_scheme&#x60;. Currently only &#x60;iso6523-actorid-upis&#x60; is supported and is used by default when not provided.  
-**Tip:**
-
-
-If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
-.
-
-        */
-       
       entity_identifier_standard?:string;
        
-      /**
-        * @description Confirms that a customer is registered under GST. If set to &#x60;true&#x60; then the [Reverse Charge Mechanism](https://www.chargebee.com/docs/australian-gst.html#reverse-charge-mechanism) is applicable. This field is applicable only when Australian GST is configured for your site.
-
-        */
-       
       registered_for_gst?:boolean;
        
-      /**
-        * @description Confirms that a customer is a valid business without an EU/UK VAT number.
-
-        */
-       
       business_customer_without_vat_number?:boolean;
        
-      /**
-        * @description Determines whether the customer is e-invoiced. When set to &#x60;true&#x60; or not set to any value, the customer is e-invoiced so long as e-invoicing is enabled for their country (&#x60;billing_address.country&#x60;). When set to &#x60;false&#x60;, the customer is not e-invoiced even if e-invoicing is enabled for their country.  
-**Tip:**
-
-
-It is possible to set a value for this flag even when E-Invoicing is disabled. However, it comes into effect only when E-Invoicing is enabled.
-.
-
-        */
-       
       is_einvoice_enabled?:boolean;
        
-      /**
-        * @description Determines whether to send einvoice manually or automatic. \* automatic - Use this value to send e-invoice every time an invoice or credit note is created. \* manual - When manual is selected the automatic e-invoice sending is disabled. Use this value to send e-invoice manually through UI or API. \* site_default - The default value of the site which can be overridden at the customer level.
-
-        */
-       
       einvoicing_method?:EinvoicingMethod;
-       
-      /**
-        * @description Parameters for billing_address
-
-        */
-       
-      billing_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
-       
-      /**
-        * @description Parameters for entity_identifiers
-
-        */
-       
-      entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
     }
     export interface ContactsForCustomerResponse {  
-      /**
-        * @description This API retrieves all the contacts for a customer.
-
-        */
-       
        list:{contact:Contact}[];
        
-      /**
-        * @description This API retrieves all the contacts for a customer.
-
-        */
-       
        next_offset?:string;
     }
     export interface ContactsForCustomerInputParam {
       [key : string]: any;  
       /**
-        * @description This API retrieves all the contacts for a customer.
+        * @description The number of resources to be returned.
 
         */
         
       limit?:number;
        
       /**
-        * @description This API retrieves all the contacts for a customer.
+        * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
 
         */
         
@@ -1574,18 +563,8 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface AssignPaymentRoleInputParam {
        
-      /**
-        * @description Payment source id this role will be assigned to.
-
-        */
-       
       payment_source_id:string;
        
-      /**
-        * @description Indicates whether the payment source is Primary, Backup, or neither. \* backup - Backup \* none - None \* primary - Primary
-
-        */
-       
       role:Role;
     }
     export interface AddContactResponse {  
@@ -1595,12 +574,7 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface AddContactInputParam {
        
-      /**
-        * @description Parameters for contact
-
-        */
-       
-      contact?:{email:string,enabled?:boolean,first_name?:string,id?:string,label?:string,last_name?:string,phone?:string,send_account_email?:boolean,send_billing_email?:boolean};
+      contact:{email:string,enabled?:boolean,first_name?:string,id?:string,label?:string,last_name?:string,phone?:string,send_account_email?:boolean,send_billing_email?:boolean};
     }
     export interface UpdateContactResponse {  
        customer:Customer;
@@ -1609,12 +583,7 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface UpdateContactInputParam {
        
-      /**
-        * @description Parameters for contact
-
-        */
-       
-      contact?:{email?:string,enabled?:boolean,first_name?:string,id:string,label?:string,last_name?:string,phone?:string,send_account_email?:boolean,send_billing_email?:boolean};
+      contact:{email?:string,enabled?:boolean,first_name?:string,id:string,label?:string,last_name?:string,phone?:string,send_account_email?:boolean,send_billing_email?:boolean};
     }
     export interface DeleteContactResponse {  
        customer:Customer;
@@ -1623,110 +592,90 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface DeleteContactInputParam {
        
-      /**
-        * @description Parameters for contact
-
-        */
-       
-      contact?:{id:string};
+      contact:{id:string};
     }
-    export interface RecordExcessPaymentResponse {  
+    export interface AddPromotionalCreditsResponse {  
        customer:Customer;
-       
-       transaction:Transaction;
     }
-    export interface RecordExcessPaymentInputParam {
+    export interface AddPromotionalCreditsInputParam {
        
-      /**
-        * @description Remarks, if any, on the payment.
-
-        */
+      amount:number;
        
-      comment?:string;
+      currency_code?:string;
        
-      /**
-        * @description Parameters for transaction
-
-        */
+      description:string;
        
-      transaction:{amount:number,currency_code?:string,custom_payment_method_id?:string,date:number,payment_method:PaymentMethod,reference_number?:string};
+      credit_type?:CreditType;
+       
+      reference?:string;
     }
-    export interface CollectPaymentResponse {  
+    export interface DeductPromotionalCreditsResponse {  
        customer:Customer;
-       
-       transaction:Transaction;
     }
-    export interface CollectPaymentInputParam {
+    export interface DeductPromotionalCreditsInputParam {
        
-      /**
-        * @description Amount to be collected. If this parameter is not passed then the invoice(s) amount to collect will be collected.
-
-        */
+      amount:number;
        
-      amount?:number;
+      currency_code?:string;
        
-      /**
-        * @description Payment source used for the payment.
-
-        */
+      description:string;
        
-      payment_source_id?:string;
+      credit_type?:CreditType;
        
-      /**
-        * @description Token generated by Chargebee JS representing payment method details.
-
-        */
+      reference?:string;
+    }
+    export interface SetPromotionalCreditsResponse {  
+       customer:Customer;
+    }
+    export interface SetPromotionalCreditsInputParam {
        
-      token_id?:string;
+      amount:number;
        
-      /**
-        * @description Indicates whether the primary payment source should be replaced with this payment source. In case of Create Subscription for Customer endpoint, the default value is True. Otherwise, the default value is False.
-
-        */
+      currency_code?:string;
+       
+      description:string;
+       
+      credit_type?:CreditType;
+       
+      reference?:string;
+    }
+    export interface RecordExcessPaymentResponse {  
+       customer:Customer;
+       
+       transaction:Transaction;
+    }
+    export interface RecordExcessPaymentInputParam {
        
-      replace_primary_payment_source?:boolean;
+      transaction:{amount:number,currency_code?:string,custom_payment_method_id?:string,date:number,payment_method:PaymentMethod,reference_number?:string};
        
-      /**
-        * @description Indicates whether the payment source should be retained for the customer.
-
-        */
+      comment?:string;
+    }
+    export interface CollectPaymentResponse {  
+       customer:Customer;
        
-      retain_payment_source?:boolean;
+       transaction:Transaction;
+    }
+    export interface CollectPaymentInputParam {
        
-      /**
-        * @description The type of initiator to be used for the payment request triggered by this operation. \* customer - Pass this value to indicate that the request is initiated by the customer \* merchant - Pass this value to indicate that the request is initiated by the merchant
-
-        */
+      payment_method?:{additional_information?:object,gateway_account_id?:string,reference_id?:string,tmp_token?:string,type?:Type};
        
-      payment_initiator?:PaymentInitiator;
+      card?:{additional_information?:object,billing_addr1?:string,billing_addr2?:string,billing_city?:string,billing_country?:string,billing_state?:string,billing_state_code?:string,billing_zip?:string,cvv?:string,expiry_month?:number,expiry_year?:number,first_name?:string,gateway_account_id?:string,last_name?:string,number?:string};
        
-      /**
-        * @description Parameters for payment_method
-
-        */
+      payment_intent?:{additional_information?:object,gateway_account_id?:string,gw_payment_method_id?:string,gw_token?:string,id?:string,payment_method_type?:'card' | 'ideal' | 'sofort' | 'bancontact' | 'google_pay' | 'dotpay' | 'giropay' | 'apple_pay' | 'upi' | 'netbanking_emandates' | 'paypal_express_checkout' | 'direct_debit' | 'boleto' | 'venmo' | 'amazon_payments' | 'pay_to' | 'faster_payments' | 'sepa_instant_transfer' | 'klarna_pay_now' | 'online_banking_poland',reference_id?:string};
        
-      payment_method?:{additional_information?:object,gateway_account_id?:string,reference_id?:string,tmp_token?:string,type?:Type};
+      invoice_allocations:{allocation_amount?:number,invoice_id:string}[];
        
-      /**
-        * @description Parameters for card
-
-        */
+      amount?:number;
        
-      card?:{additional_information?:object,billing_addr1?:string,billing_addr2?:string,billing_city?:string,billing_country?:string,billing_state?:string,billing_state_code?:string,billing_zip?:string,cvv?:string,expiry_month?:number,expiry_year?:number,first_name?:string,gateway_account_id?:string,last_name?:string,number?:string};
+      payment_source_id?:string;
        
-      /**
-        * @description Parameters for payment_intent
-
-        */
+      token_id?:string;
        
-      payment_intent?:{additional_information?:object,gateway_account_id?:string,gw_token?:string,id?:string,payment_method_type?:'giropay' | 'ideal' | 'sepa_instant_transfer' | 'google_pay' | 'netbanking_emandates' | 'klarna_pay_now' | 'dotpay' | 'boleto' | 'direct_debit' | 'faster_payments' | 'sofort' | 'upi' | 'venmo' | 'amazon_payments' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'pay_to' | 'card',reference_id?:string};
+      replace_primary_payment_source?:boolean;
        
-      /**
-        * @description Parameters for invoice_allocations
-
-        */
+      retain_payment_source?:boolean;
        
-      invoice_allocations?:{allocation_amount?:number,invoice_id:string}[];
+      payment_initiator?:PaymentInitiator;
     }
     export interface DeleteResponse {  
        customer:Customer;
@@ -1735,11 +684,6 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface DeleteInputParam {
        
-      /**
-        * @description Deletes the Payment Method from the gateway/vault.
-
-        */
-       
       delete_payment_method?:boolean;
     }
     export interface MoveResponse {  
@@ -1747,18 +691,10 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface MoveInputParam {
        
-      /**
-        * @description Id of the customer to be copied.
-
-        */
+      tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
        
       id_at_from_site:string;
        
-      /**
-        * @description Name of the site from which this customer need to be copied.
-
-        */
-       
       from_site:string;
     }
     export interface ChangeBillingDateResponse {  
@@ -1766,43 +702,13 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
     }
     export interface ChangeBillingDateInputParam {
        
-      /**
-        * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. When set, renewals of all the monthly and yearly subscriptions of this customer will be aligned to this date.
-
-        */
-       
       billing_date?:number;
        
-      /**
-        * @description &#x60;billing_month&#x60;, together with &#x60;billing_date&#x60;, specify, for this customer, the day of the year when the renewals of all the year-based subscriptions take place.
-
-For example, the renewals happen on 15th July when &#x60;billing_month&#x60; is &#x60;7&#x60; and &#x60;billing_date&#x60; is &#x60;15&#x60;.  
-**Note**
-
-Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.html) (with customer-specific billing date support) is enabled and &#x60;billing_date_mode&#x60; is &#x60;manually_set&#x60;.
-
-        */
-       
       billing_month?:number;
        
-      /**
-        * @description Indicates whether this customer&#x27;s *billing_date* value is derived as per configurations or its specifically set (overriden). When specifically set, the *billing_date* will not be reset even when all of the monthly/yearly subscriptions are cancelled. \* manually_set - Billing date is specifically set (default configuration is overridden) \* using_defaults - Billing date is set based on defaults configured.
-
-        */
-       
       billing_date_mode?:BillingDateMode;
        
-      /**
-        * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. When set, renewals of all the weekly subscriptions of this customer will be aligned to this week day. \* sunday - Sunday \* wednesday - Wednesday \* tuesday - Tuesday \* monday - Monday \* saturday - Saturday \* friday - Friday \* thursday - Thursday
-
-        */
-       
-      billing_day_of_week?:'sunday' | 'saturday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'monday';
-       
-      /**
-        * @description Indicates whether this customer&#x27;s *billing_day_of_week* value is derived as per configurations or its specifically set (overriden). When specifically set, the *billing_day_of_week* will not be reset even when all of the weekly subscriptions are cancelled. \* manually_set - Billing date is specifically set (default configuration is overridden) \* using_defaults - Billing date is set based on defaults configured.
-
-        */
+      billing_day_of_week?:'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
        
       billing_day_of_week_mode?:BillingDayOfWeekMode;
     }
@@ -1811,18 +717,10 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
     }
     export interface MergeInputParam {
        
-      /**
-        * @description From customer id.
-
-        */
+      tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
        
       from_customer_id:string;
        
-      /**
-        * @description To customer id.
-
-        */
-       
       to_customer_id:string;
     }
     export interface ClearPersonalDataResponse {  
@@ -1834,50 +732,17 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
     }
     export interface RelationshipsInputParam {
        
-      /**
-        * @description ID of the customer intended to be set as the immediate parent of the customer identified by &#x60;customer_id&#x60;.
-
-        */
+      parent_account_access?:{portal_download_child_invoices?:'yes' | 'view_only' | 'no',portal_edit_child_subscriptions?:'yes' | 'view_only' | 'no',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
        
-      parent_id?:string;
+      child_account_access?:{portal_download_invoices?:'yes' | 'view_only' | 'no',portal_edit_subscriptions?:'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
        
-      /**
-        * @description The &#x60;id&#x60; of the customer responsible for paying the invoices for the customer identified by &#x60;customer_id&#x60;. This ID must match either &#x60;customer_id&#x60; or &#x60;invoice_owner_id&#x60;.
-
-        */
+      parent_id?:string;
        
       payment_owner_id?:string;
        
-      /**
-        * @description The &#x60;id&#x60; of the customer who receives the invoice for charges incurred by the customer identified by &#x60;customer_id&#x60;. This ID must match either &#x60;customer_id&#x60; or one of its ancestors.
-
-        */
-       
       invoice_owner_id?:string;
        
-      /**
-        * @description Decides if Chargebee should apply settings from the [Chargebee Billing UI](https://www.chargebee.com/docs/2.0/account-hierarchy.html#advanced-mode) or from this API request.
-
-* If set to &#x60;true&#x60;: Chargebee uses settings configured in the Chargebee Billing UI.
-* If set to &#x60;false&#x60;: Settings provided in the &#x60;parent_account_access&#x60; and &#x60;child_account_access&#x60; parameters are applied.
-
-        */
-       
       use_default_hierarchy_settings?:boolean;
-       
-      /**
-        * @description Settings for the parent account&#x27;s access.
-
-        */
-       
-      parent_account_access?:{portal_download_child_invoices?:'no' | 'yes' | 'view_only',portal_edit_child_subscriptions?:'no' | 'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
-       
-      /**
-        * @description Settings for the child account&#x27;s access.
-
-        */
-       
-      child_account_access?:{portal_download_invoices?:'no' | 'yes' | 'view_only',portal_edit_subscriptions?:'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
     }
     export interface DeleteRelationshipResponse {  
        customer:Customer;
@@ -1888,11 +753,6 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
     }
     export interface HierarchyInputParam {
        
-      /**
-        * @description Retrieves the full or partial [account hierarchy](/docs/api/hierarchies) for a customer.
-
-        */
-        
       hierarchy_operation_type:'complete_hierarchy' | 'subordinates' | 'path_to_root';
     }
     export interface UpdateHierarchySettingsResponse {  
@@ -1900,369 +760,108 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
     }
     export interface UpdateHierarchySettingsInputParam {
        
-      /**
-        * @description Decides if Chargebee should apply settings from the [Chargebee Billing UI](https://www.chargebee.com/docs/2.0/account-hierarchy.html#advanced-mode) or from this API request.
-
-* If set to &#x60;true&#x60;: Chargebee removes existing settings stored in the &#x60;parent_account_access&#x60; and &#x60;child_account_access&#x60; attributes of the customer. The settings configured in the Chargebee Billing UI apply for the customer.
-* If set to &#x60;false&#x60;: Chargebee replaces existing settings stored in the &#x60;parent_account_access&#x60; and &#x60;child_account_access&#x60; parameters with those passed in this API call. If any of those parameters are not passed, they remain unchanged for the customer.
-
-        */
-       
-      use_default_hierarchy_settings?:boolean;
-       
-      /**
-        * @description Parameters for parent_account_access
-
-        */
-       
-      parent_account_access?:{portal_download_child_invoices?:'no' | 'yes' | 'view_only',portal_edit_child_subscriptions?:'no' | 'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
+      parent_account_access?:{portal_download_child_invoices?:'yes' | 'view_only' | 'no',portal_edit_child_subscriptions?:'yes' | 'view_only' | 'no',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
        
-      /**
-        * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this attribute defines the level of access that the customer has to its own information.
-
-        */
+      child_account_access?:{portal_download_invoices?:'yes' | 'view_only' | 'no',portal_edit_subscriptions?:'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
        
-      child_account_access?:{portal_download_invoices?:'no' | 'yes' | 'view_only',portal_edit_subscriptions?:'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
+      use_default_hierarchy_settings?:boolean;
     }
     export interface BillingAddress {  
-         /**
-          * @description The first name of the billing contact.
-
-          */
-       
       first_name?:string;
        
-         /**
-          * @description The last name of the billing contact.
-
-          */
-       
       last_name?:string;
        
-         /**
-          * @description The email address.
-
-          */
-       
       email?:string;
        
-         /**
-          * @description The company name.
-
-          */
-       
       company?:string;
        
-         /**
-          * @description The phone number.
-
-          */
-       
       phone?:string;
        
-         /**
-          * @description Address line 1
-
-          */
-       
       line1?:string;
        
-         /**
-          * @description Address line 2
-
-          */
-       
       line2?:string;
        
-         /**
-          * @description Address line 3
-
-          */
-       
       line3?:string;
        
-         /**
-          * @description The name of the city.
-
-          */
-       
       city?:string;
        
-         /**
-          * @description The [ISO 3166-2 state/province code](https://www.iso.org/obp/ui/#search) without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set &#x60;state_code&#x60; as &#x60;AZ&#x60; (not &#x60;US-AZ&#x60;). For Tamil Nadu (India), set as &#x60;TN&#x60; (not &#x60;IN-TN&#x60;). For British Columbia (Canada), set as &#x60;BC&#x60; (not &#x60;CA-BC&#x60;).
-
-          */
-       
       state_code?:string;
        
-         /**
-          * @description State or Province
-
-          */
-       
       state?:string;
        
-         /**
-          * @description The billing address country of the customer. Must be one of [ISO 3166 alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html).   
-
-**Note** : If you enter an invalid country code, the system will return an error.  
-
-**Brexit**
-
-
-If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or later, or have [manually enable](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, then &#x60;XI&#x60; (the code for **United Kingdom -- Northern Ireland**) is available as an option.
-
-          */
-       
       country?:string;
        
-         /**
-          * @description Zip or postal code. The number of characters is validated according to the rules [specified here](https://chromium-i18n.appspot.com/ssl-address).
-
-          */
-       
       zip?:string;
        
-         /**
-          * @description The address verification status. \* valid - Address was validated successfully. \* partially_valid - The address is valid for taxability but has not been validated for shipping. \* invalid - Address is invalid. \* not_validated - Address is not yet validated.
-
-          */
-       
       validation_status?:ValidationStatus;
     }
     export interface ReferralUrl {  
-         /**
-          * @description External customer id in the referral system
-
-          */
-       
       external_customer_id?:string;
        
-         /**
-          * @description Referral sharing url for the customer
-
-          */
-       
       referral_sharing_url:string;
        
-         /**
-          * @description The referral url creation time
-
-          */
-       
       created_at:number;
        
-         /**
-          * @description The referral url updation time
-
-          */
-       
       updated_at:number;
        
-         /**
-          * @description Referral campaign id
-
-          */
-       
       referral_campaign_id:string;
        
-         /**
-          * @description Referral account id
-
-          */
-       
       referral_account_id:string;
        
-         /**
-          * @description Referral external campaign id
-
-          */
-       
       referral_external_campaign_id?:string;
        
-         /**
-          * @description Url for the referral system account \* referral_saasquatch - Referral Saasquatch \* friendbuy - Friendbuy \* referral_candy - Referral Candy
-
-          */
-       
-      referral_system:'referral_candy' | 'friendbuy' | 'referral_saasquatch';
+      referral_system:'referral_candy' | 'referral_saasquatch' | 'friendbuy';
     }
     export interface Contact {  
-         /**
-          * @description Unique reference ID provided for the contact.
-
-          */
-       
       id:string;
        
-         /**
-          * @description First name of the contact.
-
-          */
-       
       first_name?:string;
        
-         /**
-          * @description Last name of the contact.
-
-          */
-       
       last_name?:string;
        
-         /**
-          * @description Email of the contact.
-
-          */
-       
       email:string;
        
-         /**
-          * @description Phone number of the contact.
-
-          */
-       
       phone?:string;
        
-         /**
-          * @description Label/Tag provided for contact.
-
-          */
-       
       label?:string;
        
-         /**
-          * @description Contact enabled / disabled
-
-          */
-       
       enabled:boolean;
        
-         /**
-          * @description Whether Account Emails option is enabled for the contact.
-
-          */
-       
       send_account_email:boolean;
        
-         /**
-          * @description Whether Billing Emails option is enabled for the contact.
-
-          */
-       
       send_billing_email:boolean;
     }
     export interface PaymentMethod {  
-         /**
-          * @description Type of payment source \* google_pay - Payments made via Google Pay. \* sofort - Payments made via Sofort. \* netbanking_emandates - Netbanking (eMandates) Payments. \* apple_pay - Payments made via Apple Pay. \* unionpay - Payments made via UnionPay. \* giropay - Payments made via giropay. \* direct_debit - Represents bank account for which the direct debit or ACH agreement/mandate is created. \* bancontact - Payments made via Bancontact Card. \* upi - UPI Payments. \* alipay - Payments made via Alipay. \* pay_to - Payments made via PayTo \* wechat_pay - Payments made via WeChat Pay. \* sepa_instant_transfer - Payments made via Sepa Instant Transfer \* dotpay - Payments made via Dotpay. \* paypal_express_checkout - Payments made via PayPal Express Checkout. \* ideal - Payments made via iDEAL. \* generic - Payments made via Generic Payment Method. \* faster_payments - Payments made via Faster Payments \* venmo - Payments made via Venmo \* amazon_payments - Payments made via Amazon Payments. \* card - Card based payment including credit cards and debit cards. Details about the card can be obtained from the card resource.
-
-          */
-       
       type:Type;
        
-         /**
-          * @description Name of the gateway the payment method is associated with. \* ecentric - Ecentric provides a seamless payment processing service in South Africa specializing on omnichannel capabilities. \* paypal_payflow_pro - PayPal Payflow Pro is a payment gateway. \* sage_pay - Sage Pay is a payment gateway. \* wepay - WePay is a payment gateway. \* wirecard - WireCard Account is a payment service provider. \* migs - MasterCard Internet Gateway Service payment gateway. \* ebanx - EBANX is a payment gateway, enabling businesses to accept diverse local payment methods from various countries for increased market reach and conversion. \* beanstream - Bambora(formerly known as Beanstream) is a payment gateway. \* adyen - Adyen is a payment gateway. \* razorpay - Razorpay is a fast growing payment service provider in India working with all leading banks and support for major local payment methods including Netbanking, UPI etc. \* braintree - Braintree is a payment gateway. \* nmi - NMI is a payment gateway. \* chargebee_payments - Chargebee Payments gateway \* bluepay - BluePay is a payment gateway. \* paypal - PayPal Commerce is a payment gateway. \* bank_of_america - Bank of America is a payment gateway. \* paypal_pro - PayPal Pro Account is a payment gateway. \* eway_rapid - eWAY Rapid is a payment gateway. \* windcave - Windcave provides an end to end payment processing solution in ANZ and other leading global markets. \* moneris_us - Moneris USA is a payment gateway. \* exact - Exact Payments is a payment gateway. \* paypal_express_checkout - PayPal Express Checkout is a payment gateway. \* tco - 2Checkout is a payment gateway. \* pay_com - Pay.com provides payment services focused on simplicity and hassle-free operations for businesses of all sizes. \* chargebee - Chargebee test gateway. \* stripe - Stripe is a payment gateway. \* eway - eWAY Account is a payment gateway. \* authorize_net - Authorize.net is a payment gateway \* moneris - Moneris is a payment gateway. \* worldpay - WorldPay is a payment gateway \* pin - Pin is a payment gateway \* gocardless - GoCardless is a payment service provider. \* elavon - Elavon Virtual Merchant is a payment solution. \* cybersource - CyberSource is a payment gateway. \* vantiv - Vantiv is a payment gateway. \* amazon_payments - Amazon Payments is a payment service provider. \* global_payments - Global Payments is a payment service provider. \* first_data_global - First Data Global Gateway Virtual Terminal Account \* orbital - Chase Paymentech(Orbital) is a payment gateway. \* checkout_com - Checkout.com is a payment gateway. \* quickbooks - Intuit QuickBooks Payments gateway \* mollie - Mollie is a payment gateway. \* bluesnap - BlueSnap is a payment gateway. \* paymill - PAYMILL is a payment gateway. \* ogone - Ingenico ePayments (formerly known as Ogone) is a payment gateway. \* not_applicable - Indicates that payment gateway is not applicable for this resource. \* hdfc - HDFC Account is a payment gateway. \* balanced_payments - Balanced is a payment gateway \* ingenico_direct - Worldline Online Payments is a payment gateway. \* metrics_global - Metrics global is a leading payment service provider providing unified payment services in the US.
-
-          */
-       
       gateway:Gateway;
        
-         /**
-          * @description The gateway account this payment method is stored with.
-
-          */
-       
       gateway_account_id?:string;
        
-         /**
-          * @description Current status of the payment source. \* expired - A payment source that has expired \* invalid - The billing agreement cannot be used. It might become valid again either automatically or due to customer action. \* valid - A payment source that is valid and active. \* pending_verification - The payment source needs to be verified \* expiring - A payment source that is expiring (like card&#x27;s status based on its expiry date).
-
-          */
-       
       status:'valid' | 'expiring' | 'expired' | 'invalid' | 'pending_verification';
        
-         /**
-          * @description The reference id. In the case of Amazon and PayPal this will be the &#x27;billing agreement id&#x27;. For GoCardless direct debit this will be &#x27;mandate id&#x27;. In the case of card payments this will be the identifier provided by the gateway/card vault for the specific payment method resource.  
-**Note:** This is not the one time temporary token provided by gateways like Stripe.
-
-          */
-       
       reference_id:string;
     }
-    export interface CustomerBalance {  
-         /**
-          * @description Promotional credits balance of this customer.
-
-          */
-       
+    export interface Balance {  
       promotional_credits:number;
        
-         /**
-          * @description Total unused payments associated with the customer.
-
-          */
-       
       excess_payments:number;
        
-         /**
-          * @description Refundable credits balance of this customer
-
-          */
-       
       refundable_credits:number;
        
-         /**
-          * @description Total unbilled charges for this customer.
-
-          */
-       
       unbilled_charges:number;
        
-         /**
-          * @description The currency code (ISO 4217 format) for balance
-
-          */
-       
       currency_code:string;
+       
+      balance_currency_code:string;
     }
     export interface EntityIdentifier {  
-         /**
-          * @description The unique id for the &#x60;entity_identifier&#x60; in Chargebee. When not provided, it is autogenerated.
-
-          */
-       
       id:string;
        
-         /**
-          * @description The value of the &#x60;entity_identifier&#x60;. This identifies the customer entity on the Peppol network. For example: &#x60;10101010-STO-10&#x60;.  
-**Tip:**
-
-
-If there is only one entity identifier for the customer and the value is the same as &#x60;vat_number&#x60;, then there is no need to provide the &#x60;entity_identifiers[]&#x60; array. See [description for &#x60;entity_identifiers[]&#x60;](customers#customer_entity_identifiers).
-
-          */
-       
       value?:string;
        
-         /**
-          * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, &#x60;DE:VAT&#x60; is used for a German business entity while &#x60;DE:LWID45&#x60; is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under &#x60;billing_address.country&#x60;. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).  
-**Tip:**
-
-
-If there is only one entity identifier for the customer and the value is the same as &#x60;vat_number&#x60;, then there is no need to provide the &#x60;entity_identifiers[]&#x60; array. See [description for &#x60;entity_identifiers[]&#x60;](customers#customer_entity_identifiers).
-
-          */
-       
       scheme:string;
        
-         /**
-          * @description The standard used for specifying the &#x60;entity_identifier&#x60; &#x60;scheme&#x60;. Currently, only &#x60;iso6523-actorid-upis&#x60; is supported and is used by default when not provided.  
-**Tip:**
-
-
-If there is only one entity identifier for the customer and the value is the same as &#x60;vat_number&#x60;, then there is no need to provide the &#x60;entity_identifiers[]&#x60; array. See [description for &#x60;entity_identifiers[]&#x60;](customers#customer_entity_identifiers).
-
-          */
-       
       standard?:string;
     }
     export interface TaxProvidersField {  
@@ -2273,97 +872,32 @@ If there is only one entity identifier for the customer and the value is the sam
       field_value:string;
     }
     export interface Relationship {  
-         /**
-          * @description The &#x60;id&#x60; of the immediate parent of this customer under account hierarchy. If the customer is the root of the hierarchy, this attribute isn&#x27;t returned.
-
-          */
-       
       parent_id?:string;
        
-         /**
-          * @description The &#x60;id&#x60; of the customer responsible for paying the invoices for this customer. This ID must match either this customer&#x27;s ID or the &#x60;invoice_owner_id&#x60;.
-
-          */
-       
       payment_owner_id:string;
        
-         /**
-          * @description The &#x60;id&#x60; of the customer who receives the invoice for charges incurred by the customer. This ID must match either this customer or one of its ancestors.
-
-          */
-       
       invoice_owner_id:string;
     }
     export interface ParentAccountAccess {  
-         /**
-          * @description Determines the parent&#x27;s access to the child&#x27;s subscriptions in the Self-Serve Portal. \* no - The parent can&#x27;t view or edit the child&#x27;s subscriptions. \* view_only - The parent can only view the child&#x27;s subscriptions. \* yes - The parent can view and edit the child&#x27;s subscriptions.
-
-          */
-       
-      portal_edit_child_subscriptions?:'no' | 'yes' | 'view_only';
-       
-         /**
-          * @description Determines the parent&#x27;s access to the child&#x27;s invoices in the Self-Serve Portal. \* no - The parent can&#x27;t view or download the child&#x27;s invoices. \* yes - The parent can both view and download the child&#x27;s invoices. \* view_only - The parent can view but not download the child&#x27;s invoices.
-
-          */
+      portal_edit_child_subscriptions?:'yes' | 'view_only' | 'no';
        
-      portal_download_child_invoices?:'no' | 'yes' | 'view_only';
-       
-         /**
-          * @description Determines whether the parent receives email notifications for the child&#x27;s subscriptions.
-
-          */
+      portal_download_child_invoices?:'yes' | 'view_only' | 'no';
        
       send_subscription_emails:boolean;
        
-         /**
-          * @description Determines whether the parent receives email notifications for the child&#x27;s invoices.
-
-          */
-       
       send_invoice_emails:boolean;
        
-         /**
-          * @description Determines whether, the parent receives email notifications for payment-related activities on the child&#x27;s invoices.
-
-          */
-       
       send_payment_emails:boolean;
     }
     export interface ChildAccountAccess {  
-         /**
-          * @description Determines the child&#x27;s access to its own subscriptions in the Self-Serve Portal. \* yes - The child account can view and edit its subscriptions. \* view_only - The child account can only view its subscriptions.
-
-          */
-       
       portal_edit_subscriptions?:'yes' | 'view_only';
        
-         /**
-          * @description Determines the child&#x27;s access to its own invoices in the Self-Serve Portal. \* view_only - The child account can view but not download its invoices. \* yes - The child account can both view and download its invoices. \* no - The child account cannot view or download its own invoices.
-
-          */
-       
-      portal_download_invoices?:'no' | 'yes' | 'view_only';
-       
-         /**
-          * @description Determines whether the child account receives email notifications for its subscriptions.
-
-          */
+      portal_download_invoices?:'yes' | 'view_only' | 'no';
        
       send_subscription_emails:boolean;
        
-         /**
-          * @description Determines whether the child account receives email notifications for its invoices.
-
-          */
-       
       send_invoice_emails:boolean;
        
-         /**
-          * @description Determines whether the child account receives email notifications for payment-related activities for its invoices.
-
-          */
-       
       send_payment_emails:boolean;
     }
   }