lago-javascript-client 1.36.0 → 1.43.0

package/script/openapi/client.d.ts

@@ -59,6 +59,16 @@ export interface BillingEntityObject {
      * @example 0
      */
     invoice_grace_period: number;
+    /**
+     * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+     * @default "next_period_start"
+     */
+    subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+    /**
+     * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+     * @default "align_with_finalization_date"
+     */
+    subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
     /**
      * Whether this billing entity is the default billing entity for the organization. Default billing entity will be used as fallback in services if no billing entity is specified when billing_entity is not provided. Default billing entity is the billing entity that will be used to generate invoices if no billing entity is specified when invoice is created. is the oldest active billing entity and this flag cannot be changed
      * @example false
@@ -219,6 +229,16 @@ export interface BillingEntityCreateInput {
              * @example 0
              */
             invoice_grace_period?: number;
+            /**
+             * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+             * @default "next_period_start"
+             */
+            subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+            /**
+             * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+             * @default "align_with_finalization_date"
+             */
+            subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
         };
         /**
          * The net payment term (in days) for this billing entity
@@ -468,6 +488,16 @@ export interface BillingEntityUpdateInput {
          * @example 0
          */
         invoice_grace_period?: number;
+        /**
+         * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+         * @default "next_period_start"
+         */
+        subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+        /**
+         * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+         * @default "align_with_finalization_date"
+         */
+        subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
     };
     /**
      * The net payment term (in days) for this billing entity
@@ -2008,6 +2038,12 @@ export interface FeeObject {
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
     lago_charge_filter_id?: string | null;
+    /**
+     * Unique identifier assigned to the fixed charge that the fee belongs to
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_fixed_charge_id?: string | null;
     /**
      * Unique identifier assigned to the invoice that the fee belongs to
      * @format uuid
@@ -2124,13 +2160,13 @@ export interface FeeObject {
      */
     invoiceable: boolean;
     /**
-     * The beginning date of the period that the fee covers. It is applicable only to `subscription` and `charge` fees. This field indicates the start date of the billing period or subscription period associated with the fee.
+     * The beginning date of the period that the fee covers. It is applicable only to `subscription`, `charge`, `fixed_charge` and `commitment` fees. This field indicates the start date of the billing period or subscription period associated with the fee.
      * @format date-time
      * @example "2022-04-29T08:59:51Z"
      */
     from_date?: string | null;
     /**
-     * The ending date of the period that the fee covers. It is applicable only to `subscription` and `charge` fees. This field indicates the end date of the billing period or subscription period associated with the fee.
+     * The ending date of the period that the fee covers. It is applicable only to `subscription`, `charge`, `fixed_charge` and `commitment` fees. This field indicates the end date of the billing period or subscription period associated with the fee.
      * @format date-time
      * @example "2022-05-29T08:59:51Z"
      */
@@ -2189,12 +2225,12 @@ export interface FeeObject {
     /** Item attached to the fee */
     item: {
         /**
-         * The fee type. Possible values are `add-on`, `charge`, `credit`, `subscription` or `commitment`.
+         * The fee type. Possible values are `add-on`, `charge`, `fixed_charge`, `credit`, `subscription` or `commitment`.
          * @example "subscription"
          */
-        type: "charge" | "add_on" | "subscription" | "credit" | "commitment";
+        type: "charge" | "fixed_charge" | "add_on" | "subscription" | "credit" | "commitment";
         /**
-         * The code of the fee item. It can be the code of the `add-on`, the code of the `charge`, the code of the `credit` or the code of the `subscription`.
+         * The code of the fee item. It can be the code of the `add-on`, the code of the `charge`, the code of the `fixed_charge`, the code of the `credit` or the code of the `subscription`.
          * @example "startup"
          */
         code: string;
@@ -2287,6 +2323,12 @@ export type CreditNoteAppliedTaxObject = BaseAppliedTax & {
     /** @example 100 */
     base_amount_cents?: number;
 };
+/**
+ * Custom metadata stored as key-value pairs.
+ * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+ * @example {"external_id":"ext-123","synced_at":"2024-01-15","source":null}
+ */
+export type MetadataObject = object | null;
 export interface CreditNoteErrorDetailsObject {
     /**
      * The credit note error details unique identifier, created by Lago.
@@ -2410,6 +2452,11 @@ export interface CreditNoteObject {
      * @example 0
      */
     refund_amount_cents: number;
+    /**
+     * The ofsetted amount (deducted from the invoice balance) of the credit note, expressed in cents.
+     * @example 0
+     */
+    offset_amount_cents: number;
     /**
      * The pro-rated amount of the coupons applied to the source invoice.
      * @example 20
@@ -2440,12 +2487,22 @@ export interface CreditNoteObject {
      * @example false
      */
     self_billed?: boolean;
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata?: MetadataObject;
     error_details?: any[] | null;
 }
 export interface CreditNotesPaginated {
     credit_notes: CreditNoteObject[];
     meta: PaginationMeta;
 }
+/**
+ * Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+ * @example {"external_id":"ext-123","synced_at":"2024-01-15"}
+ */
+export type MetadataInput = Record<string, string | null>;
 export interface CreditNoteCreateInput {
     credit_note: {
         /**
@@ -2466,61 +2523,23 @@ export interface CreditNoteCreateInput {
          */
         description?: string;
         /**
-         * The total amount to be credited to the customer balance for discounts on future invoices. For a total or partial refund or credit, the amount in cents must include both the item amount and the applicable tax. The refunded and credited amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
+         * The total amount to be credited to the customer balance for discounts on future invoices. For a total or partial refund, credit or offset, the amount in cents must include both the item amount and the applicable tax. The refunded, credited and offsetted amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
          * @example 100
          */
         credit_amount_cents?: number | null;
         /**
-         * The total amount to be refunded immediately to the payment method used by the customer. For a total or partial refund or credit, the amount in cents must include both the item amount and the applicable tax. The refunded and credited amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
+         * The total amount to be refunded immediately to the payment method used by the customer. For a total or partial refund, credit or offset, the amount in cents must include both the item amount and the applicable tax. The refunded, credited and offsetted amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
          * @example 500
          */
         refund_amount_cents?: number | null;
         /**
-         * The list of credit note's items.
-         * @example [{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","amount_cents":100},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","amount_cents":500}]
+         * The total amount to be immediately deducted from the invoice balance. For a total or partial refund, credit or offset, the amount in cents must include both the item amount and the applicable tax. The refunded, credited and offsetted amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
+         * @example 200
          */
-        items: {
-            /**
-             * The fee unique identifier, created by Lago.
-             * @format uuid
-             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-             */
-            fee_id: string;
-            /**
-             * This is the amount of the credit note item excluding taxes, expressed in cents.
-             * @example 100
-             */
-            amount_cents: number;
-        }[];
-    };
-}
-export interface CreditNote {
-    credit_note: CreditNoteObject;
-}
-export interface CreditNoteUpdateInput {
-    credit_note: {
-        /**
-         * The status of the refund portion of the credit note. It indicates the current state or condition of the refund associated with the credit note. The possible values for this field are:
-         *
-         * - `pending`: this status indicates that the refund is pending execution. The refund request has been initiated but has not been processed or completed yet.
-         * - `succeeded`: this status indicates that the refund has been successfully executed. The refund amount has been processed and returned to the customer or the designated recipient.
-         * - `failed`: this status indicates that the refund failed to execute. The refund request encountered an error or unsuccessful processing, and the refund amount could not be returned.
-         * @example "succeeded"
-         */
-        refund_status: "pending" | "succeeded" | "failed";
-    };
-}
-export interface CreditNoteEstimateInput {
-    credit_note: {
-        /**
-         * The invoice unique identifier, created by Lago.
-         * @format uuid
-         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-         */
-        invoice_id: string;
+        offset_amount_cents?: number | null;
         /**
          * The list of credit note's items.
-         * @example [{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","amount_cents":10},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","amount_cents":5}]
+         * @example [{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","amount_cents":100},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","amount_cents":500},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","amount_cents":200}]
          */
         items: {
             /**
@@ -2530,138 +2549,15 @@ export interface CreditNoteEstimateInput {
              */
             fee_id: string;
             /**
-             * The amount of the credit note item, expressed in cents.
-             * @example 10
-             */
-            amount_cents: number;
-        }[];
-    };
-}
-export interface CreditNoteEstimated {
-    estimated_credit_note: {
-        /**
-         * Unique identifier assigned to the invoice that the credit note belongs to
-         * @format uuid
-         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-         */
-        lago_invoice_id: string;
-        /**
-         * The invoice unique number, related to the credit note.
-         * @example "LAG-1234"
-         */
-        invoice_number: string;
-        /**
-         * The currency of the credit note.
-         * @example "EUR"
-         */
-        currency: Currency;
-        /**
-         * The tax amount of the credit note, expressed in cents.
-         * @example 20
-         */
-        taxes_amount_cents: number;
-        /**
-         * The precise tax amount of the credit note, expressed in cents with decimal precision.
-         * @example 20.1
-         */
-        precise_taxes_amount_cents: number;
-        /**
-         * The tax rate associated with this specific credit note.
-         * @example 20
-         */
-        taxes_rate: number;
-        /**
-         * The subtotal of the credit note excluding any applicable taxes, expressed in cents.
-         * @example 100
-         */
-        sub_total_excluding_taxes_amount_cents: number;
-        /**
-         * The credited amount of the credit note, expressed in cents.
-         * @example 100
-         */
-        max_creditable_amount_cents: number;
-        /**
-         * The refunded amount of the credit note, expressed in cents.
-         * @example 0
-         */
-        max_refundable_amount_cents: number;
-        /**
-         * The pro-rated amount of the coupons applied to the source invoice.
-         * @example 20
-         */
-        coupons_adjustment_amount_cents: number;
-        /**
-         * The precise pro-rated amount with decimal precision of the coupons applied to the source invoice.
-         * @example 20.1
-         */
-        precise_coupons_adjustment_amount_cents: number;
-        /** Array of credit note's items. */
-        items: {
-            /**
-             * The credit note's item amount, expressed in cents.
+             * This is the amount of the credit note item excluding taxes, expressed in cents.
              * @example 100
              */
             amount_cents: number;
-            /**
-             * Unique identifier assigned to the fee within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the fee's record within the Lago system.
-             * @format uuid
-             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-             */
-            lago_fee_id: string | null;
-        }[];
-        applied_taxes?: {
-            /**
-             * Unique identifier of the tax, created by Lago.
-             * @format uuid
-             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-             */
-            lago_tax_id?: string;
-            /**
-             * Name of the tax.
-             * @example "TVA"
-             */
-            tax_name?: string;
-            /**
-             * Unique code used to identify the tax associated with the API request.
-             * @example "french_standard_vat"
-             */
-            tax_code?: string;
-            /**
-             * The percentage rate of the tax
-             * @example 20
-             */
-            tax_rate?: number;
-            /**
-             * Internal description of the taxe
-             * @example "French standard VAT"
-             */
-            tax_description?: string;
-            /** @example 100 */
-            base_amount_cents?: number;
-            /**
-             * Amount of the tax
-             * @example 2000
-             */
-            amount_cents?: number;
-            /**
-             * Currency of the tax
-             * @example "USD"
-             */
-            amount_currency?: Currency;
         }[];
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
-export interface ApiErrorNotAllowed {
-    /**
-     * @format int32
-     * @example 405
-     */
-    status: number;
-    /** @example "Method Not Allowed" */
-    error: string;
-    /** @example "not_allowed" */
-    code: string;
-}
 /** @example "US" */
 export type CountryOrNull = "AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AO" | "AQ" | "AR" | "AS" | "AT" | "AU" | "AW" | "AX" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BQ" | "BR" | "BS" | "BT" | "BV" | "BW" | "BY" | "BZ" | "CA" | "CC" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CW" | "CX" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FM" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GF" | "GG" | "GH" | "GI" | "GL" | "GM" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GU" | "GW" | "GY" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IM" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MF" | "MG" | "MH" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PN" | "PR" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SH" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VA" | "VC" | "VE" | "VG" | "VI" | "VN" | "VU" | "WF" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW";
 /** @example "America/Los_Angeles" */
@@ -2673,6 +2569,18 @@ export interface CustomerBillingConfiguration {
      * @example 3
      */
     invoice_grace_period?: number;
+    /**
+     * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+     * @default null
+     * @example "next_period_start"
+     */
+    subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+    /**
+     * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+     * @default null
+     * @example "keep_anchor"
+     */
+    subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
     /**
      * The payment provider utilized to initiate payments for invoices issued by Lago.
      * Accepted values: `stripe`, `adyen`, `gocardless` or null. This field is required if you intend to assign a `provider_customer_id`.
@@ -2921,23 +2829,211 @@ export interface CustomerBaseObject {
      */
     updated_at?: string;
     /**
-     * Specifies how invoices with a zero total amount should be handled:
-     * - `inherit`: (Default) Follows the organization-level configuration.
-     * - `finalize`: Invoices are issued and finalized even if the total amount is zero.
-     * - `skip`: Invoices with a total amount of zero are not finalized.
-     * @example "inherit"
+     * Specifies how invoices with a zero total amount should be handled:
+     * - `inherit`: (Default) Follows the organization-level configuration.
+     * - `finalize`: Invoices are issued and finalized even if the total amount is zero.
+     * - `skip`: Invoices with a total amount of zero are not finalized.
+     * @example "inherit"
+     */
+    finalize_zero_amount_invoice?: "inherit" | "skip" | "finalize";
+    /**
+     * Set to true to exclude all invoice custom sections from PDF generation for this customer only.
+     * @example false
+     */
+    skip_invoice_custom_sections?: boolean;
+    /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
+    billing_configuration?: CustomerBillingConfiguration;
+    /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
+    shipping_address?: Address;
+    metadata?: CustomerMetadata[];
+}
+export type CreditNoteExtendedObject = CreditNoteObject & {
+    customer?: CustomerBaseObject;
+};
+export interface CreditNoteExtended {
+    credit_note: CreditNoteExtendedObject;
+}
+export interface CreditNoteUpdateInput {
+    credit_note: {
+        /**
+         * The status of the refund portion of the credit note. It indicates the current state or condition of the refund associated with the credit note. The possible values for this field are:
+         *
+         * - `pending`: this status indicates that the refund is pending execution. The refund request has been initiated but has not been processed or completed yet.
+         * - `succeeded`: this status indicates that the refund has been successfully executed. The refund amount has been processed and returned to the customer or the designated recipient.
+         * - `failed`: this status indicates that the refund failed to execute. The refund request encountered an error or unsuccessful processing, and the refund amount could not be returned.
+         * @example "succeeded"
+         */
+        refund_status: "pending" | "succeeded" | "failed";
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
+    };
+}
+export interface CreditNote {
+    credit_note: CreditNoteObject;
+}
+export interface CreditNoteEstimateInput {
+    credit_note: {
+        /**
+         * The invoice unique identifier, created by Lago.
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        invoice_id: string;
+        /**
+         * The list of credit note's items.
+         * @example [{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","amount_cents":10},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","amount_cents":5}]
+         */
+        items: {
+            /**
+             * The fee unique identifier, created by Lago.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            fee_id: string;
+            /**
+             * The amount of the credit note item, expressed in cents.
+             * @example 10
+             */
+            amount_cents: number;
+        }[];
+    };
+}
+export interface CreditNoteEstimated {
+    estimated_credit_note: {
+        /**
+         * Unique identifier assigned to the invoice that the credit note belongs to
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        lago_invoice_id: string;
+        /**
+         * The invoice unique number, related to the credit note.
+         * @example "LAG-1234"
+         */
+        invoice_number: string;
+        /**
+         * The currency of the credit note.
+         * @example "EUR"
+         */
+        currency: Currency;
+        /**
+         * The tax amount of the credit note, expressed in cents.
+         * @example 20
+         */
+        taxes_amount_cents: number;
+        /**
+         * The precise tax amount of the credit note, expressed in cents with decimal precision.
+         * @example 20.1
+         */
+        precise_taxes_amount_cents: number;
+        /**
+         * The tax rate associated with this specific credit note.
+         * @example 20
+         */
+        taxes_rate: number;
+        /**
+         * The subtotal of the credit note excluding any applicable taxes, expressed in cents.
+         * @example 100
+         */
+        sub_total_excluding_taxes_amount_cents: number;
+        /**
+         * The credited amount of the credit note, expressed in cents.
+         * @example 100
+         */
+        max_creditable_amount_cents: number;
+        /**
+         * The refunded amount of the credit note, expressed in cents.
+         * @example 0
+         */
+        max_refundable_amount_cents: number;
+        /**
+         * The ofsetted amount of the credit note, expressed in cents.
+         * @example 0
+         */
+        max_offsettable_amount_cents: number;
+        /**
+         * The pro-rated amount of the coupons applied to the source invoice.
+         * @example 20
+         */
+        coupons_adjustment_amount_cents: number;
+        /**
+         * The precise pro-rated amount with decimal precision of the coupons applied to the source invoice.
+         * @example 20.1
+         */
+        precise_coupons_adjustment_amount_cents: number;
+        /** Array of credit note's items. */
+        items: {
+            /**
+             * The credit note's item amount, expressed in cents.
+             * @example 100
+             */
+            amount_cents: number;
+            /**
+             * Unique identifier assigned to the fee within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the fee's record within the Lago system.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            lago_fee_id: string | null;
+        }[];
+        applied_taxes?: {
+            /**
+             * Unique identifier of the tax, created by Lago.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            lago_tax_id?: string;
+            /**
+             * Name of the tax.
+             * @example "TVA"
+             */
+            tax_name?: string;
+            /**
+             * Unique code used to identify the tax associated with the API request.
+             * @example "french_standard_vat"
+             */
+            tax_code?: string;
+            /**
+             * The percentage rate of the tax
+             * @example 20
+             */
+            tax_rate?: number;
+            /**
+             * Internal description of the taxe
+             * @example "French standard VAT"
+             */
+            tax_description?: string;
+            /** @example 100 */
+            base_amount_cents?: number;
+            /**
+             * Amount of the tax
+             * @example 2000
+             */
+            amount_cents?: number;
+            /**
+             * Currency of the tax
+             * @example "USD"
+             */
+            amount_currency?: Currency;
+        }[];
+    };
+}
+export interface ApiErrorNotAllowed {
+    /**
+     * @format int32
+     * @example 405
      */
-    finalize_zero_amount_invoice?: "inherit" | "skip" | "finalize";
+    status: number;
+    /** @example "Method Not Allowed" */
+    error: string;
+    /** @example "not_allowed" */
+    code: string;
+}
+export interface CreditNoteMetadataResponse {
     /**
-     * Set to true to exclude all invoice custom sections from PDF generation for this customer only.
-     * @example false
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
      */
-    skip_invoice_custom_sections?: boolean;
-    /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
-    billing_configuration?: CustomerBillingConfiguration;
-    /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
-    shipping_address?: Address;
-    metadata?: CustomerMetadata[];
+    metadata: MetadataObject;
 }
 /** Configuration specific to the accounting and tax integrations. This object contains settings and parameters necessary for syncing documents and payments. */
 export interface IntegrationCustomer {
@@ -3586,6 +3682,12 @@ export interface PaymentObject {
      * @example "cus_5eb0285bcf941bc6ba"
      */
     provider_customer_id: string;
+    /**
+     * The unique identifier of the payment method used for this payment.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    payment_method_id?: string | null;
     /**
      * The next action to be taken by the customer to complete the payment. Should usually be empty, except when receiving the `payment.requires_action` webhook.
      * @example {"type":"redirect_to_url","redirect_to_url":{"url":"https://hooks.stripe.com/3d_secure_2/hosted?merchant=acct_AAA&payment_intent=pi_BBB&payment_intent_client_secret=pi_BBB&publishable_key=pk_test_CCC","return_url":"https://app.example.com"}}
@@ -3647,6 +3749,20 @@ export interface PaymentRequestsPaginated {
     payment_requests: PaymentRequestObject[];
     meta: PaginationMeta;
 }
+/** Reference to a specific payment method for processing the payment. */
+export interface PaymentMethodReference {
+    /**
+     * The type of payment method to use.
+     * @example "provider"
+     */
+    payment_method_type?: "provider" | "manual";
+    /**
+     * The unique identifier of the payment method (required when using a specific provider payment method).
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    payment_method_id?: string;
+}
 export interface SubscriptionObject {
     /**
      * Unique identifier assigned to the subscription within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the subscription's record within the Lago system
@@ -3685,6 +3801,16 @@ export interface SubscriptionObject {
      * @example "premium"
      */
     plan_code: string;
+    /**
+     * The base cost of the related plan, excluding any applicable taxes, that is billed on a recurring basis.
+     * @example 10000
+     */
+    plan_amount_cents?: number;
+    /**
+     * The currency of the related plan. It indicates the monetary unit in which the plan's cost, including taxes and usage-based charges, is expressed.
+     * @example "USD"
+     */
+    plan_amount_currency?: Currency;
     /**
      * The status of the subscription, which can have the following values:
      * - `active`: the subscription is currently active and applied to the customer.
@@ -3770,12 +3896,13 @@ export interface SubscriptionObject {
      *
      * - `credit`: A credit note is generated for the unused subscription time. The unused amount is credited back to the customer.
      * - `refund`: A credit note is generated for the unused subscription time. If the invoice is paid or partially paid, the unused paid amount is refunded; any unpaid unused amount is credited back to the customer.
+     * - `offset`: A credit note is generated for the unused subscription time. If the invoice is paid or partially paid, the unused paid amount is refunded; any unpaid unused amount is applied to the invoice reducing its amount due.
      * - `skip`: No credit note is generated for the unused subscription time.
      *
      * _Note: This field is only applicable to pay-in-advance plans and will be `null` for pay-in-arrears plans._
      * @example "credit"
      */
-    on_termination_credit_note: "credit" | "refund" | "skip";
+    on_termination_credit_note: "credit" | "refund" | "offset" | "skip";
     /**
      * When a subscription is terminated before the end of its billing period, we generate an invoice for the unbilled usage.
      * This field allows you to control the behavior of the invoice generation:
@@ -3786,6 +3913,8 @@ export interface SubscriptionObject {
      * @example "generate"
      */
     on_termination_invoice: "generate" | "skip";
+    /** The payment method assigned to this subscription for processing payments. */
+    payment_method?: PaymentMethodReference;
 }
 export interface SubscriptionsPaginated {
     subscriptions: SubscriptionObject[];
@@ -3886,6 +4015,8 @@ export interface WalletRecurringTransactionRule {
      * @example false
      */
     ignore_paid_top_up_limits: boolean;
+    /** The payment method assigned to this recurring transaction rule for processing top-up payments. */
+    payment_method?: PaymentMethodReference;
 }
 export interface WalletObject {
     /**
@@ -3920,6 +4051,18 @@ export interface WalletObject {
      * @example "Prepaid"
      */
     name?: string | null;
+    /**
+     * The code of the wallet.
+     * @example "prepaid"
+     */
+    code?: string | null;
+    /**
+     * Wallet priority for ordering when a customer has multiple wallets. Allowed values: 1-50, where 1 is highest priority and 50 is lowest. Defaults to 50.
+     * @min 1
+     * @max 50
+     * @example 50
+     */
+    priority?: number;
     /**
      * The rate of conversion between credits and the amount in the specified currency. It indicates the ratio or factor used to convert credits into the corresponding monetary value in the currency of the transaction.
      * @pattern ^[0-9]+.?[0-9]*$
@@ -4025,6 +4168,13 @@ export interface WalletObject {
      * @example 1000
      */
     paid_top_up_max_amount_cents?: number | null;
+    /** The payment method assigned to this wallet for processing top-up payments. */
+    payment_method?: PaymentMethodReference;
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata?: MetadataObject;
 }
 export interface WalletsPaginated {
     wallets: WalletObject[];
@@ -4305,35 +4455,78 @@ export interface CustomerPastUsage {
     usage_periods: CustomerUsage[];
     meta: PaginationMeta;
 }
-/** . */
 export interface CustomerCheckoutUrl {
-    customer?: {
-        /**
-         * Unique identifier assigned to the customer within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the customer's record within the Lago system
-         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-         */
-        lago_customer_id: string;
-        /**
-         * The customer external unique identifier (provided by your own application)
-         * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
-         */
-        external_customer_id: string;
-        /**
-         * The Payment Provider name linked to the Customer.
-         * @example "stripe"
-         */
-        payment_provider: string;
-        /**
-         * Code of the payment provider
-         * @example "Stripe Prod"
-         */
-        payment_provider_code?: string;
-        /**
-         * The new generated Payment Provider Checkout URL for the Customer.
-         * @example "https://foo.bar"
-         */
-        checkout_url?: string;
-    };
+    /**
+     * Unique identifier assigned to the customer within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the customer's record within the Lago system
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_customer_id: string;
+    /**
+     * The customer external unique identifier (provided by your own application)
+     * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
+     */
+    external_customer_id: string;
+    /**
+     * The Payment Provider name linked to the Customer.
+     * @example "stripe"
+     */
+    payment_provider: string;
+    /**
+     * Code of the payment provider
+     * @example "Stripe Prod"
+     */
+    payment_provider_code?: string;
+    /**
+     * The new generated Payment Provider Checkout URL for the Customer.
+     * @example "https://foo.bar"
+     */
+    checkout_url?: string;
+}
+export interface PaymentMethodObject {
+    /**
+     * The unique identifier of the payment method, created by Lago.
+     * @format uuid
+     * @example "4cf085a7-c196-4f07-a543-97c50ec6e8b2"
+     */
+    lago_id: string;
+    /**
+     * Indicates whether this payment method is the default one for the customer.
+     * @example true
+     */
+    is_default: boolean;
+    /**
+     * Code of the payment provider associated with this payment method.
+     * @example "stripe_prod"
+     */
+    payment_provider_code?: string | null;
+    /**
+     * Human-readable name of the payment provider.
+     * @example "Stripe"
+     */
+    payment_provider_name?: string | null;
+    /**
+     * The type of the payment provider.
+     * @example "stripe"
+     */
+    payment_provider_type: "adyen" | "cashfree" | "gocardless" | "stripe" | "flutterwave" | "moneyhash";
+    /**
+     * Unique identifier of the payment method within the payment provider.
+     * @example "pm_1N8ZQX2eZvKYlo2CkL9Y8XYZ"
+     */
+    provider_method_id: string;
+    /**
+     * Timestamp when the payment method was created in Lago's database.
+     * @format date-time
+     * @example "2025-01-21T00:10:29Z"
+     */
+    created_at: string;
+}
+export interface PaymentMethodsPaginated {
+    payment_methods: PaymentMethodObject[];
+    meta: PaginationMeta;
+}
+export interface PaymentMethod {
+    payment_method: PaymentMethodObject;
 }
 export interface EventObject {
     /**
@@ -4341,7 +4534,7 @@ export interface EventObject {
      * @format uuid
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
-    lago_id: string;
+    lago_id?: string | null;
     /**
      * This field represents a unique identifier for the event. It is crucial for ensuring idempotency, meaning that each event can be uniquely identified and processed without causing any unintended side effects.
      * @example "transaction_1234567890"
@@ -4394,7 +4587,7 @@ export interface EventObject {
      * @format date-time
      * @example "2022-04-29T08:59:51Z"
      */
-    created_at: string;
+    created_at?: string | null;
 }
 export interface EventsPaginated {
     events: EventObject[];
@@ -4767,6 +4960,8 @@ export interface InvoiceOneOffCreateInput {
              */
             skip_psp?: boolean | null;
         }[];
+        /** Optional payment method to use for processing the invoice payment. */
+        payment_method?: PaymentMethodReference;
     };
 }
 export interface ErrorDetailObject {
@@ -5298,6 +5493,8 @@ export interface PaymentRequestCreateInput {
         email: string;
         /** A list of Lago IDs for the customer's overdue invoices to start the dunning process */
         lago_invoice_ids: string[];
+        /** Optional payment method to use for processing the payment request. */
+        payment_method?: PaymentMethodReference;
     };
 }
 export interface PaymentRequest {
@@ -5638,6 +5835,143 @@ export interface ChargeObject {
          */
         conversion_rate: string;
     };
+    /**
+     * Specifies whether the charge accepts a target wallet for prepaid credits deduction.
+     * @example false
+     */
+    accepts_target_wallet?: boolean | null;
+}
+export interface FixedChargeProperties {
+    /**
+     * - The unit price, excluding tax, for a `standard` charge model. It is expressed as a decimal value.
+     * - The amount, excluding tax, for a complete set of units in a `package` charge model. It is expressed as a decimal value.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "30"
+     */
+    amount?: string;
+    /** Graduated ranges, sorted from bottom to top tiers, used for a `graduated` charge model. */
+    graduated_ranges?: {
+        /**
+         * Specifies the lower value of a tier for a `graduated` charge model. It must be either 0 or the previous range's `to_value + 1` to maintain the proper sequence of values.
+         * @example 0
+         */
+        from_value: number;
+        /**
+         * Specifies the highest value of a tier for a `graduated` charge model.
+         * - This value must be higher than the from_value of the same tier.
+         * - This value must be null for the last tier.
+         * @example 10
+         */
+        to_value: number | null;
+        /**
+         * The flat amount for a whole tier, excluding tax, for a `graduated` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "10"
+         */
+        flat_amount: string;
+        /**
+         * The unit price, excluding tax, for a specific tier of a `graduated` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "0.5"
+         */
+        per_unit_amount: string;
+    }[];
+    /** Volume ranges, sorted from bottom to top tiers, used for a `volume` charge model. */
+    volume_ranges?: {
+        /**
+         * Specifies the lower value of a tier for a `volume` charge model. It must be either 0 or the previous range's `to_value + 1` to maintain the proper sequence of values.
+         * @example 0
+         */
+        from_value: number;
+        /**
+         * Specifies the highest value of a tier for a `volume` charge model.
+         * - This value must be higher than the `from_value` of the same tier.
+         * - This value must be `null` for the last tier.
+         * @example 10
+         */
+        to_value: number | null;
+        /**
+         * The flat amount for a whole tier, excluding tax, for a `volume` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "10"
+         */
+        flat_amount: string;
+        /**
+         * The unit price, excluding tax, for a specific tier of a `volume` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "0.5"
+         */
+        per_unit_amount: string;
+    }[];
+}
+export interface FixedChargeObject {
+    /**
+     * Unique identifier of the fixed charge, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * Unique identifier of the add-on associated with this fixed charge.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_add_on_id: string;
+    /**
+     * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
+     * @example "Setup fee"
+     */
+    invoice_display_name: string;
+    /**
+     * Unique code used to identify the add-on.
+     * @example "setup_fee"
+     */
+    add_on_code: string;
+    /**
+     * The date and time when the fixed charge was created. It is expressed in UTC format according to the ISO 8601 datetime standard.
+     * @format date-time
+     * @example "2023-06-27T19:43:42Z"
+     */
+    created_at: string;
+    /**
+     * Unique code for the fixed charge.
+     * @example "setup_fee"
+     */
+    code?: string;
+    /**
+     * The charge model for the fixed charge. Only `standard`, `graduated`, and `volume` models are supported for fixed charges.
+     * @example "standard"
+     */
+    charge_model: "standard" | "graduated" | "volume";
+    /**
+     * This field determines the billing timing for this fixed charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period.
+     * @example false
+     */
+    pay_in_advance: boolean;
+    /**
+     * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
+     *
+     * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
+     * - If set to `false`, the charge is billed in full.
+     * - If not defined in the request, default value is `false`.
+     * @example false
+     */
+    prorated: boolean;
+    /** List of all thresholds utilized for calculating the fixed charge. */
+    properties: FixedChargeProperties;
+    /**
+     * The number of units for the fixed charge.
+     * @example 1
+     */
+    units: number;
+    /**
+     * Unique identifier of the parent fixed charge (for plan versions).
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_parent_id?: string | null;
+    /** List of taxes applied to the fixed charge. */
+    taxes?: TaxObject[];
 }
 export type PlanEntitlementPrivilegeObject = FeaturePrivilegeObject & {
     /**
@@ -5733,19 +6067,34 @@ export interface PlanObject {
      * This field, when set to `true`, enables to invoice usage-based charges on monthly basis, even if the cadence of the plan is yearly or semiannual. This allows customers to pay charges overage on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
      * @example null
      */
-    bill_charges_monthly?: boolean | null;
+    bill_charges_monthly?: boolean | null;
+    /**
+     * This field, when set to `true`, enables to invoice fixed charges on monthly basis, even if the cadence of the plan is yearly or semiannual. This allows customers to pay fixed charges on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
+     * @example null
+     */
+    bill_fixed_charges_monthly?: boolean | null;
     minimum_commitment?: MinimumCommitmentObject;
     /**
      * Additional usage-based charges for this plan.
      * @example [{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","billable_metric_code":"requests","created_at":"2023-06-27T19:43:42Z","charge_model":"package","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":false,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"filters":[]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","billable_metric_code":"cpu","created_at":"2023-06-27T19:43:42Z","charge_model":"graduated","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":false,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":0,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"flat_amount":"10","per_unit_amount":"0.5"},{"from_value":11,"to_value":null,"flat_amount":"0","per_unit_amount":"0.4"}]},"filters":[]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","billable_metric_code":"seats","created_at":"2023-06-27T19:43:42Z","charge_model":"standard","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":true,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":0,"properties":{},"filters":[{"invoice_display_name":"Europe","properties":{"amount":"10"},"values":{"region":["Europe"]}},{"invoice_display_name":"USA","properties":{"amount":"5"},"values":{"region":["USA"]}},{"invoice_display_name":"Africa","properties":{"amount":"8"},"values":{"region":["Africa"]}}]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","billable_metric_code":"storage","created_at":"2023-06-27T19:43:42Z","charge_model":"volume","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":false,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":0,"properties":{"volume_ranges":[{"from_value":0,"to_value":100,"flat_amount":"0","per_unit_amount":"0"},{"from_value":101,"to_value":null,"flat_amount":"0","per_unit_amount":"0.5"}]},"filters":[]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","billable_metric_code":"payments","created_at":"2023-06-27T19:43:42Z","charge_model":"percentage","invoiceable":false,"invoice_display_name":"Setup","pay_in_advance":true,"regroup_paid_fees":"invoice","prorated":false,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"filters":[]}]
      */
     charges?: ChargeObject[];
+    /**
+     * List of fixed charges for this plan.
+     * @example [{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","lago_add_on_id":"2b802b80-2b80-2b80-2b80-2b802b802b80","code":"setup_fee","invoice_display_name":"Setup Fee","add_on_code":"setup","created_at":"2026-01-15T10:30:00Z","charge_model":"standard","pay_in_advance":true,"prorated":false,"properties":{"amount":"500"},"units":1,"lago_parent_id":null,"taxes":[{"lago_id":"3c703c70-3c70-3c70-3c70-3c703c703c70","name":"VAT","code":"vat_20","rate":20,"description":"Standard VAT rate","applied_to_organization":true,"created_at":"2026-01-01T00:00:00Z"}]},{"lago_id":"4d604d60-4d60-4d60-4d60-4d604d604d60","lago_add_on_id":"5e505e50-5e50-5e50-5e50-5e505e505e50","code":"support_tier","invoice_display_name":"Support Tier","add_on_code":"premium_support","created_at":"2026-01-15T10:30:00Z","charge_model":"graduated","pay_in_advance":false,"prorated":true,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"per_unit_amount":"5","flat_amount":"200"},{"from_value":11,"to_value":null,"per_unit_amount":"1","flat_amount":"300"}]},"units":1,"lago_parent_id":null,"taxes":[]},{"lago_id":"6f406f40-6f40-6f40-6f40-6f406f406f40","lago_add_on_id":"7a307a30-7a30-7a30-7a30-7a307a307a30","code":"storage","invoice_display_name":"Storage Allocation","add_on_code":"cloud_storage","created_at":"2026-01-15T10:30:00Z","charge_model":"volume","pay_in_advance":false,"prorated":false,"properties":{"volume_ranges":[{"from_value":0,"to_value":100,"per_unit_amount":"2","flat_amount":"1"},{"from_value":101,"to_value":null,"per_unit_amount":"1","flat_amount":"0"}]},"units":50,"lago_parent_id":null,"taxes":[]}]
+     */
+    fixed_charges?: FixedChargeObject[];
     /** All taxes applied to the plan. */
     taxes?: TaxObject[];
     /** List of usage thresholds applied to the plan. */
     usage_thresholds?: UsageThresholdObject[];
     /** List of all feature entitlements and their privileges available for this plan. */
     entitlements?: PlanEntitlement[];
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata?: MetadataObject;
 }
 export interface PlansPaginated {
     plans: PlanObject[];
@@ -5805,52 +6154,57 @@ export interface PlanCreateInput {
          * The name of the plan.
          * @example "Startup"
          */
-        name?: string;
+        name: string;
         /**
          * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the plan will be used as the default display name.
          * @example "Startup plan"
          */
-        invoice_display_name?: string;
+        invoice_display_name?: string | null;
         /**
          * The code of the plan. It serves as a unique identifier associated with a particular plan. The code is typically used for internal or system-level identification purposes, like assigning a subscription, for instance.
          * @example "startup"
          */
-        code?: string;
+        code: string;
         /**
          * The interval used for recurring billing. It represents the frequency at which subscription billing occurs. The interval can be one of the following values: `yearly`, `semiannual`, `quarterly`, `monthly`, or `weekly`.
          * @example "monthly"
          */
-        interval?: "weekly" | "monthly" | "quarterly" | "semiannual" | "yearly";
+        interval: "weekly" | "monthly" | "quarterly" | "semiannual" | "yearly";
         /**
          * The description on the plan.
          * @example "Plan for early stage startups."
          */
-        description?: string;
+        description?: string | null;
         /**
          * The base cost of the plan, excluding any applicable taxes, that is billed on a recurring basis. This value is defined at 0 if your plan is a pay-as-you-go plan.
          * @example 10000
          */
-        amount_cents?: number;
+        amount_cents: number;
         /**
          * The currency of the plan. It indicates the monetary unit in which the plan's cost, including taxes and usage-based charges, is expressed.
          * @example "USD"
          */
-        amount_currency?: Currency;
+        amount_currency: Currency;
         /**
          * The duration in days during which the base cost of the plan is offered for free.
          * @example 5
          */
-        trial_period?: number;
+        trial_period?: number | null;
         /**
          * This field determines the billing timing for the plan. When set to `true`, the base cost of the plan is due at the beginning of each billing period. Conversely, when set to `false`, the base cost of the plan is due at the end of each billing period.
          * @example true
          */
-        pay_in_advance?: boolean;
+        pay_in_advance: boolean;
         /**
          * This field, when set to `true`, enables to invoice usage-based charges on monthly basis, even if the cadence of the plan is `yearly` or `semiannual`. This allows customers to pay charges overage on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
          * @example null
          */
         bill_charges_monthly?: boolean | null;
+        /**
+         * This field, when set to `true`, enables to invoice fixed charges on monthly basis, even if the cadence of the plan is `yearly` or `semiannual`. This allows customers to pay fixed charges on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
+         * @example null
+         */
+        bill_fixed_charges_monthly?: boolean | null;
         /** List of unique code used to identify the taxes. */
         tax_codes?: TaxCodes;
         /** Minimum commitment for this plan. */
@@ -5865,7 +6219,7 @@ export interface PlanCreateInput {
              * @format uuid
              * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
              */
-            billable_metric_id?: string;
+            billable_metric_id: string;
             /**
              * Specifies the pricing model used for the calculation of the final fee. It can be any of the following values:
              *   - [`dynamic`](https://docs.getlago.com/guide/plans/charges/charge-models/dynamic)
@@ -5876,7 +6230,7 @@ export interface PlanCreateInput {
              *   - [`standard`](https://docs.getlago.com/guide/plans/charges/charge-models/standard)
              *   - [`volume`](https://docs.getlago.com/guide/plans/charges/charge-models/volume)
              */
-            charge_model?: ChargeModelEnum;
+            charge_model: ChargeModelEnum;
             /**
              * This field determines the billing timing for this specific usage-based charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period.
              * @example false
@@ -5936,9 +6290,71 @@ export interface PlanCreateInput {
                  */
                 conversion_rate?: string;
             };
+            /**
+             * Specifies whether the charge accepts a target wallet for prepaid credits deduction.
+             * @example false
+             */
+            accepts_target_wallet?: boolean | null;
+        }[];
+        /**
+         * Additional fixed charges for this plan.
+         * @example [{"add_on_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","code":"setup_fee","invoice_display_name":"Setup Fee","charge_model":"standard","pay_in_advance":true,"prorated":false,"properties":{"amount":"500"},"units":1,"tax_codes":["french_standard_vat"]},{"add_on_id":"4d604d60-4d60-4d60-4d60-4d604d604d60","invoice_display_name":"Support Tier","charge_model":"graduated","pay_in_advance":false,"prorated":true,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"per_unit_amount":"5","flat_amount":"200"},{"from_value":11,"to_value":null,"per_unit_amount":"1","flat_amount":"300"}]},"units":2},{"add_on_id":"6f406f40-6f40-6f40-6f40-6f406f406f40","charge_model":"volume","properties":{"volume_ranges":[{"from_value":0,"to_value":100,"per_unit_amount":"2","flat_amount":"1"},{"from_value":101,"to_value":null,"per_unit_amount":"1","flat_amount":"0"}]},"units":50}]
+         */
+        fixed_charges?: {
+            /**
+             * Unique identifier of the add-on associated with this fixed charge.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            add_on_id: string;
+            /**
+             * Unique code for the fixed charge. If not provided, it will be automatically generated based on the add-on code.
+             * @example "setup_fee"
+             */
+            code?: string;
+            /**
+             * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
+             * @example "Setup fee"
+             */
+            invoice_display_name?: string;
+            /**
+             * The number of units for the fixed charge. Defaults to 0 if not provided.
+             * @default 0
+             * @example 1
+             */
+            units?: number;
+            /**
+             * The charge model for the fixed charge. Only `standard`, `graduated`, and `volume` models are supported for fixed charges.
+             * @example "standard"
+             */
+            charge_model: "standard" | "graduated" | "volume";
+            /**
+             * This field determines the billing timing for this specific fixed charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period. Defaults to `false` if not provided.
+             * @default false
+             * @example false
+             */
+            pay_in_advance?: boolean;
+            /**
+             * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
+             *
+             * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
+             * - If set to `false`, the charge is billed in full.
+             * - Defaults to `false` if not provided.
+             *
+             * Note: Prorated fixed charges with `graduated` model and `pay_in_advance` are not allowed.
+             * @default false
+             * @example false
+             */
+            prorated?: boolean;
+            /** List of all thresholds utilized for calculating the fixed charge. */
+            properties?: FixedChargeProperties;
+            /** List of taxes applied to the fixed charge. */
+            tax_codes?: TaxCodes;
         }[];
         /** List of usage thresholds to apply to the plan. */
         usage_thresholds?: UsageThresholdInput[];
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface Plan {
@@ -5955,7 +6371,7 @@ export interface PlanUpdateInput {
          * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the plan will be used as the default display name.
          * @example "Startup plan"
          */
-        invoice_display_name?: string;
+        invoice_display_name?: string | null;
         /**
          * The code of the plan. It serves as a unique identifier associated with a particular plan. The code is typically used for internal or system-level identification purposes, like assigning a subscription, for instance.
          * @example "startup"
@@ -5970,7 +6386,7 @@ export interface PlanUpdateInput {
          * The description on the plan.
          * @example "Plan for early stage startups."
          */
-        description?: string;
+        description?: string | null;
         /**
          * The base cost of the plan, excluding any applicable taxes, that is billed on a recurring basis. This value is defined at 0 if your plan is a pay-as-you-go plan.
          * @example 10000
@@ -5985,7 +6401,7 @@ export interface PlanUpdateInput {
          * The duration in days during which the base cost of the plan is offered for free.
          * @example 5
          */
-        trial_period?: number;
+        trial_period?: number | null;
         /**
          * This field determines the billing timing for the plan. When set to `true`, the base cost of the plan is due at the beginning of each billing period. Conversely, when set to `false`, the base cost of the plan is due at the end of each billing period.
          * @example true
@@ -5996,6 +6412,11 @@ export interface PlanUpdateInput {
          * @example null
          */
         bill_charges_monthly?: boolean | null;
+        /**
+         * This field, when set to `true`, enables to invoice fixed charges on monthly basis, even if the cadence of the plan is `yearly` or `semiannual`. This allows customers to pay fixed charges on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
+         * @example null
+         */
+        bill_fixed_charges_monthly?: boolean | null;
         /** List of unique code used to identify the taxes. */
         tax_codes?: TaxCodes;
         /** Minimum commitment for this plan. */
@@ -6082,6 +6503,77 @@ export interface PlanUpdateInput {
                  */
                 conversion_rate?: string;
             };
+            /**
+             * Specifies whether the charge accepts a target wallet for prepaid credits deduction.
+             * @example false
+             */
+            accepts_target_wallet?: boolean | null;
+        }[];
+        /**
+         * Additional fixed charges for this plan.
+         * @example [{"id":"1a901a90-1a90-1a90-1a90-1a901a901a90","invoice_display_name":"New Setup Fee","charge_model":"standard","apply_units_immediately":true,"units":5},{"add_on_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","code":"setup_fee","invoice_display_name":"Setup Fee","charge_model":"standard","pay_in_advance":true,"prorated":false,"properties":{"amount":"500"},"units":1,"apply_units_immediately":false,"tax_codes":["french_standard_vat"]},{"add_on_id":"4d604d60-4d60-4d60-4d60-4d604d604d60","invoice_display_name":"Support Tier","charge_model":"graduated","pay_in_advance":false,"prorated":true,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"per_unit_amount":"5","flat_amount":"200"},{"from_value":11,"to_value":null,"per_unit_amount":"1","flat_amount":"300"}]},"units":2},{"add_on_id":"6f406f40-6f40-6f40-6f40-6f406f406f40","charge_model":"volume","properties":{"volume_ranges":[{"from_value":0,"to_value":100,"per_unit_amount":"2","flat_amount":"1"},{"from_value":101,"to_value":null,"per_unit_amount":"1","flat_amount":"0"}]},"units":50}]
+         */
+        fixed_charges?: {
+            /**
+             * Unique identifier of the fixed charge created by Lago (required for updates).
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            id?: string;
+            /**
+             * Unique identifier of the add-on associated with this fixed charge.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            add_on_id?: string;
+            /**
+             * Unique code for the fixed charge. If not provided, it will be automatically generated based on the add-on code.
+             * @example "setup_fee"
+             */
+            code?: string;
+            /**
+             * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
+             * @example "Setup fee"
+             */
+            invoice_display_name?: string;
+            /**
+             * The number of units for the fixed charge. Defaults to 0 if not provided.
+             * @default 0
+             * @example 1
+             */
+            units?: number;
+            /**
+             * The charge model for the fixed charge. Only `standard`, `graduated`, and `volume` models are supported for fixed charges.
+             * @example "standard"
+             */
+            charge_model?: "standard" | "graduated" | "volume";
+            /**
+             * This field determines the billing timing for this specific fixed charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period. Defaults to `false` if not provided.
+             * @default false
+             * @example false
+             */
+            pay_in_advance?: boolean;
+            /**
+             * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
+             *
+             * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
+             * - If set to `false`, the charge is billed in full.
+             * - Defaults to `false` if not provided.
+             *
+             * Note: Prorated fixed charges with `graduated` model and `pay_in_advance` are not allowed.
+             * @default false
+             * @example false
+             */
+            prorated?: boolean;
+            /** List of all thresholds utilized for calculating the fixed charge. */
+            properties?: FixedChargeProperties;
+            /** List of taxes applied to the fixed charge. */
+            tax_codes?: TaxCodes;
+            /**
+             * Determines if the units should be applied immediately upon assignment or deferred to the next billing cycle.
+             * @example true
+             */
+            apply_units_immediately?: boolean;
         }[];
         /** List of usage thresholds to apply to the plan. */
         usage_thresholds?: UsageThresholdInput[];
@@ -6090,6 +6582,8 @@ export interface PlanUpdateInput {
          * @example true
          */
         cascade_updates?: boolean;
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface PlanEntitlements {
@@ -6102,6 +6596,13 @@ export interface EntitlementUpdateInput {
      */
     entitlements: Record<string, Record<string, number | boolean | string>>;
 }
+export interface PlanMetadataResponse {
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata: MetadataObject;
+}
 /** Based plan overrides. */
 export interface PlanOverridesObject {
     /**
@@ -6190,8 +6691,39 @@ export interface PlanOverridesObject {
             conversion_rate?: string;
         };
     }[];
+    /** Additional fixed charges for this plan. */
+    fixed_charges?: {
+        /**
+         * Unique identifier of the fixed charge created by Lago.
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        id: string;
+        /**
+         * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
+         * @example "Setup fee"
+         */
+        invoice_display_name?: string;
+        /**
+         * The number of units for the fixed charge. Defaults to 0 if not provided.
+         * @default 0
+         * @example 1
+         */
+        units?: number;
+        /**
+         * Determines if the units should be applied immediately upon assignment or deferred to the next billing cycle.
+         * @example true
+         */
+        apply_units_immediately?: boolean;
+        /** List of all thresholds utilized for calculating the fixed charge. */
+        properties?: FixedChargeProperties;
+        /** List of taxes applied to the fixed charge. */
+        tax_codes?: TaxCodes;
+    }[];
     /** List of usage thresholds applied to the subscription. */
     usage_thresholds?: UsageThresholdInput[];
+    /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+    metadata?: MetadataInput;
 }
 export interface SubscriptionCreateInput {
     /**
@@ -6260,6 +6792,8 @@ export interface SubscriptionCreateInput {
         subscription_at?: string;
         /** Based plan overrides. */
         plan_overrides?: PlanOverridesObject;
+        /** Optional payment method to use for processing subscription payments. */
+        payment_method?: PaymentMethodReference;
     };
 }
 export type SubscriptionObjectExtended = SubscriptionObject & {
@@ -6294,6 +6828,8 @@ export interface SubscriptionUpdateInput {
         subscription_at?: string;
         /** Based plan overrides. */
         plan_overrides?: PlanOverridesObject;
+        /** Optional payment method to use for processing subscription payments. */
+        payment_method?: PaymentMethodReference;
     };
 }
 export interface LifetimeUsageThresholdObject {
@@ -6412,12 +6948,12 @@ export interface AlertObject {
      * The subscription external unique identifier (provided by your own application).
      * @example "sub_1234567890"
      */
-    subscription_external_id: string;
+    external_subscription_id: string;
     /**
      * The customer external unique identifier (provided by your own application).
      * @example "cus_0987654321"
      */
-    customer_external_id: string;
+    external_customer_id: string;
     /** The billable metric associated with the alert. Only for alerts based on a billable metric. */
     billable_metric: BillableMetricObject;
     /**
@@ -6499,6 +7035,21 @@ export interface AlertCreateInput {
         code: string;
     };
 }
+export interface AlertBatchCreateInput {
+    /** Array of alerts to create. All alerts are created atomically - if any fail validation, none are created. */
+    alerts: (AlertBaseInput & {
+        /**
+         * The type of alert.
+         * @example "billable_metric_current_usage_amount"
+         */
+        alert_type: "current_usage_amount" | "billable_metric_current_usage_amount" | "billable_metric_current_usage_units" | "lifetime_usage_amount";
+        /**
+         * Unique code used to identify the alert.
+         * @example "storage_threshold_alert"
+         */
+        code: string;
+    })[];
+}
 export interface Alert {
     alert: AlertObject;
 }
@@ -6552,6 +7103,9 @@ export interface SubscriptionEntitlements {
 export interface SubscriptionEntitlement {
     entitlement: SubscriptionEntitlementObject;
 }
+export interface FixedCharges {
+    fixed_charges: FixedChargeObject[];
+}
 export interface TaxesPaginated {
     taxes: TaxObject[];
     meta: PaginationMeta;
@@ -6601,6 +7155,18 @@ export interface WalletCreateInput {
          * @example "Prepaid"
          */
         name?: string | null;
+        /**
+         * The code of the wallet.
+         * @example "prepaid"
+         */
+        code?: string | null;
+        /**
+         * Wallet priority for ordering when a customer has multiple wallets. Allowed values: 1-50, where 1 is highest priority and 50 is lowest. Defaults to 50.
+         * @min 1
+         * @max 50
+         * @example 50
+         */
+        priority?: number;
         /**
          * The rate of conversion between credits and the amount in the specified currency. It indicates the ratio or factor used to convert credits into the corresponding monetary value in the currency of the transaction.
          * @pattern ^[0-9]+.?[0-9]*$
@@ -6680,6 +7246,10 @@ export interface WalletCreateInput {
         ignore_paid_top_up_limits_on_creation?: boolean | null;
         /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
         recurring_transaction_rules?: any[] | null;
+        /** Optional payment method to use for processing wallet top-up payments. */
+        payment_method?: PaymentMethodReference;
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface Wallet {
@@ -6692,6 +7262,18 @@ export interface WalletUpdateInput {
          * @example "new_name"
          */
         name?: string | null;
+        /**
+         * The code of the wallet.
+         * @example "prepaid"
+         */
+        code?: string | null;
+        /**
+         * Wallet priority for ordering when a customer has multiple wallets. Allowed values: 1-50, where 1 is highest priority and 50 is lowest. Defaults to 50.
+         * @min 1
+         * @max 50
+         * @example 50
+         */
+        priority?: number;
         /**
          * The date and time that determines when the wallet will expire. It follows the ISO 8601 datetime format and is expressed in Coordinated Universal Time (UTC).
          * @format date-time
@@ -6782,7 +7364,11 @@ export interface WalletUpdateInput {
              * @example "Tokens for models 'high-fidelity-boost'"
              */
             transaction_name?: string | null;
+            /** Optional payment method to use for processing recurring top-up payments. */
+            payment_method?: PaymentMethodReference;
         }[];
+        /** Optional payment method to use for processing wallet top-up payments. */
+        payment_method?: PaymentMethodReference;
         /** Set wallet limitations to fee types. */
         applies_to?: {
             /**
@@ -6796,8 +7382,17 @@ export interface WalletUpdateInput {
              */
             billable_metric_codes?: any[] | null;
         };
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
+export interface WalletMetadataResponse {
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata: MetadataObject;
+}
 export interface WalletTransactionCreateInput {
     wallet_transaction: {
         /**
@@ -6841,6 +7436,8 @@ export interface WalletTransactionCreateInput {
          * @example false
          */
         ignore_paid_top_up_limits?: boolean;
+        /** Optional payment method to use for processing the wallet transaction payment. */
+        payment_method?: PaymentMethodReference;
         /**
          * This optional field allows you to store a list of key-value pairs that hold additional information or custom attributes related to the data.
          * @example [{"key":"example key","value":"example value"},{"key":"another key","value":"another value"}]
@@ -6931,6 +7528,8 @@ export interface WalletTransactionObject {
      * @example "Tokens for models 'high-fidelity-boost'"
      */
     name: string | null;
+    /** The payment method assigned to this wallet transaction for processing the payment. */
+    payment_method?: PaymentMethodReference;
 }
 export interface WalletTransactions {
     wallet_transactions: WalletTransactionObject[];
@@ -7062,7 +7661,7 @@ export interface TriggeredAlertObject {
      * The subscription external unique identifier (provided by your own application).
      * @example "sub_1234567890"
      */
-    subscription_external_id: string;
+    external_subscription_id: string;
     /**
      * The code of the billable metric associated with the alert. Only for alerts based on a billable metric.
      * @example "storage_usage"
@@ -7183,9 +7782,6 @@ export type CustomerViesCheckObject = CustomerBaseObject & {
         valid?: boolean;
     };
 };
-export type CreditNoteExtendedObject = CreditNoteObject & {
-    customer?: CustomerBaseObject;
-};
 export interface CreditNotePaymentProviderRefundError {
     /**
      * Unique identifier assigned to the credit note within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the credit note record within the Lago system.
@@ -7226,7 +7822,7 @@ export interface DunningCampaignFinishedObject {
      * The customer external unique identifier (provided by your own application).
      * @example "cus_0987654321"
      */
-    customer_external_id: string;
+    external_customer_id: string;
     /**
      * Identifier of the dunning campaign.
      * @example "dun_code_1234"
@@ -7295,6 +7891,9 @@ export interface FeeTaxProviderErrorObject {
     event_transaction_id: string | null;
     provider_error: string | Record<string, any>;
 }
+export type InvoicePaymentDisputeLostObject = InvoiceObjectExtended & {
+    provider_error?: string | Record<string, any>;
+};
 export interface InvoicePaymentFailureObject {
     /**
      * Unique identifier assigned to the invoice within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the invoice's record within the Lago system.
@@ -7526,7 +8125,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 1.36.0
+ * @version 1.42.0
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -8230,7 +8829,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/credit_notes
          * @secure
          */
-        createCreditNote: (data: CreditNoteCreateInput, params?: RequestParams) => Promise<HttpResponse<CreditNote, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest>>;
+        createCreditNote: (data: CreditNoteCreateInput, params?: RequestParams) => Promise<HttpResponse<CreditNoteExtended, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest>>;
         /**
          * @description This endpoint list all existing credit notes.
          *
@@ -8319,7 +8918,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request PUT:/credit_notes/{lago_id}
          * @secure
          */
-        updateCreditNote: (lagoId: string, data: CreditNoteUpdateInput, params?: RequestParams) => Promise<HttpResponse<CreditNote, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
+        updateCreditNote: (lagoId: string, data: CreditNoteUpdateInput, params?: RequestParams) => Promise<HttpResponse<CreditNoteExtended, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
         /**
          * @description This endpoint retrieves an existing credit note.
          *
@@ -8329,7 +8928,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request GET:/credit_notes/{lago_id}
          * @secure
          */
-        findCreditNote: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNote, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        findCreditNote: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNoteExtended, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description This endpoint downloads the PDF of an existing credit note.
          *
@@ -8359,7 +8958,47 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request PUT:/credit_notes/{lago_id}/void
          * @secure
          */
-        voidCreditNote: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNote, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
+        voidCreditNote: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNoteExtended, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
+        /**
+         * @description This endpoint replaces all existing metadata on a credit note with the provided key-value pairs. Any existing metadata keys not included in the request will be removed.
+         *
+         * @tags credit_notes
+         * @name ReplaceCreditNoteMetadata
+         * @summary Replace credit note metadata
+         * @request POST:/credit_notes/{lago_id}/metadata
+         * @secure
+         */
+        replaceCreditNoteMetadata: (lagoId: string, data: CreditNoteMetadataResponse, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint merges the provided metadata with existing metadata on the credit note. Existing keys not in the request are preserved. New keys are added, existing keys are updated.
+         *
+         * @tags credit_notes
+         * @name MergeCreditNoteMetadata
+         * @summary Merge credit note metadata
+         * @request PATCH:/credit_notes/{lago_id}/metadata
+         * @secure
+         */
+        mergeCreditNoteMetadata: (lagoId: string, data: CreditNoteMetadataResponse, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes all metadata from a credit note.
+         *
+         * @tags credit_notes
+         * @name DeleteAllCreditNoteMetadata
+         * @summary Delete all credit note metadata
+         * @request DELETE:/credit_notes/{lago_id}/metadata
+         * @secure
+         */
+        deleteAllCreditNoteMetadata: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a single metadata key from a credit note.
+         *
+         * @tags credit_notes
+         * @name DeleteCreditNoteMetadataKey
+         * @summary Delete a metadata key
+         * @request DELETE:/credit_notes/{lago_id}/metadata/{key}
+         * @secure
+         */
+        deleteCreditNoteMetadataKey: (lagoId: string, key: string, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     customers: {
         /**
@@ -8860,6 +9499,47 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         generateCustomerCheckoutUrl: (externalCustomerId: string, params?: RequestParams) => Promise<HttpResponse<CustomerCheckoutUrl, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves all payment methods of a Customer.
+         *
+         * @tags payment_methods
+         * @name FindAllCustomersPaymentMethods
+         * @summary List all customer payment methods
+         * @request GET:/customers/{external_customer_id}/payment_methods
+         * @secure
+         */
+        findAllCustomersPaymentMethods: (externalCustomerId: string, query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+        }, params?: RequestParams) => Promise<HttpResponse<PaymentMethodsPaginated, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description Use the payment method as default when not selected a payment method
+         *
+         * @tags payment_methods
+         * @name PaymentMethodSetAsDefault
+         * @summary Set the payment method as default
+         * @request PUT:/customers/{external_customer_id}/payment_methods/{lago_id}/set_as_default
+         * @secure
+         */
+        paymentMethodSetAsDefault: (lagoId: string, externalCustomerId: string, params?: RequestParams) => Promise<HttpResponse<PaymentMethod, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint deletes a specific payment method for a customer.
+         *
+         * @tags payment_methods
+         * @name DestroyPaymentMethod
+         * @summary Delete a payment method
+         * @request DELETE:/customers/{external_customer_id}/payment_methods/{lago_id}
+         * @secure
+         */
+        destroyPaymentMethod: (lagoId: string, externalCustomerId: string, params?: RequestParams) => Promise<HttpResponse<PaymentMethod, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     events: {
         /**
@@ -8961,7 +9641,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         eventBatchEstimateInstantFees: (data: EventBatchEstimateInstantFeesInput, params?: RequestParams) => Promise<HttpResponse<FeesEstimate, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorForbidden | ApiErrorNotFound>>;
         /**
-         * @description This endpoint is used for retrieving a specific usage measurement event that has been sent to a customer or a subscription.
+         * @description This endpoint is used for retrieving a specific usage measurement event that has been sent to a customer or a subscription. Note that transaction_id is unique per external_subscription_id so multiple subscriptions can share the same transaction_id. This endpoint will only return the first event found with the given transaction_id. WARNING: If your Lago organization is configured to use the Clickhouse-based event pipeline, multiple events can share the same `transaction_id` (with different timestamps). This endpoint will only return the first event found.
          *
          * @tags events
          * @name FindEvent
@@ -9303,7 +9983,10 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/invoices/{lago_id}/retry_payment
          * @secure
          */
-        retryPayment: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<void, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
+        retryPayment: (lagoId: string, data?: {
+            /** Reference to a specific payment method for processing the payment. */
+            payment_method?: PaymentMethodReference;
+        }, params?: RequestParams) => Promise<HttpResponse<void, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
         /**
          * @description This endpoint is used for voiding an invoice. • When no body parameters are provided, the invoice can be voided only if it is in a `finalized` status and its payment status is NOT `succeeded`. • When `generate_credit_note` is provided (optionally with `refund_amount` and/or `credit_amount`), this validation is bypassed: the invoice is forcibly voided and a credit note is generated. If the specified refund/credit amounts do not cover the full invoice total, the remainder is issued on a second credit note that is created and immediately voided.
          *
@@ -9594,6 +10277,46 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         removeEntitlementPrivilege: (code: string, featureCode: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<PlanEntitlement, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint replaces all existing metadata on a plan with the provided key-value pairs. Any existing metadata keys not included in the request will be removed.
+         *
+         * @tags plans
+         * @name ReplacePlanMetadata
+         * @summary Replace plan metadata
+         * @request POST:/plans/{code}/metadata
+         * @secure
+         */
+        replacePlanMetadata: (code: string, data: PlanMetadataResponse, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint merges the provided metadata with existing metadata on the plan. Existing keys not in the request are preserved. New keys are added, existing keys are updated.
+         *
+         * @tags plans
+         * @name MergePlanMetadata
+         * @summary Merge plan metadata
+         * @request PATCH:/plans/{code}/metadata
+         * @secure
+         */
+        mergePlanMetadata: (code: string, data: PlanMetadataResponse, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes all metadata from a plan.
+         *
+         * @tags plans
+         * @name DeleteAllPlanMetadata
+         * @summary Delete all plan metadata
+         * @request DELETE:/plans/{code}/metadata
+         * @secure
+         */
+        deleteAllPlanMetadata: (code: string, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a single metadata key from a plan.
+         *
+         * @tags plans
+         * @name DeletePlanMetadataKey
+         * @summary Delete a metadata key
+         * @request DELETE:/plans/{code}/metadata/{key}
+         * @secure
+         */
+        deletePlanMetadataKey: (code: string, key: string, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     subscriptions: {
         /**
@@ -9746,15 +10469,25 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getSubscriptionAlerts: (externalId: string, params?: RequestParams) => Promise<HttpResponse<Alerts, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
-         * @description This endpoint allows you to create a new alert for a subscription.
+         * @description This endpoint allows you to create alerts for a subscription. Send a single alert object wrapped in `alert` key to create one alert, or an array of alert objects wrapped in `alerts` key to create multiple alerts atomically.
          *
          * @tags subscriptions
          * @name CreateSubscriptionAlert
-         * @summary Create a subscription alert
+         * @summary Create subscription alert(s)
          * @request POST:/subscriptions/{external_id}/alerts
          * @secure
          */
-        createSubscriptionAlert: (externalId: string, data: AlertCreateInput, params?: RequestParams) => Promise<HttpResponse<Alert, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
+        createSubscriptionAlert: (externalId: string, data: AlertCreateInput | AlertBatchCreateInput, params?: RequestParams) => Promise<HttpResponse<Alerts | Alert, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint allows you to delete all alerts for a subscription.
+         *
+         * @tags subscriptions
+         * @name DeleteAllSubscriptionAlerts
+         * @summary Delete all subscription alerts
+         * @request DELETE:/subscriptions/{external_id}/alerts
+         * @secure
+         */
+        deleteAllSubscriptionAlerts: (externalId: string, params?: RequestParams) => Promise<HttpResponse<void, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description This endpoint enables the retrieval of a specific alert for a subscription.
          *
@@ -9825,6 +10558,16 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         destroySubscriptionEntitlementPrivilege: (externalId: string, featureCode: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<SubscriptionEntitlement, ApiErrorUnauthorized | ApiErrorBadRequest | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves all fixed charges for a specific subscription.
+         *
+         * @tags subscriptions
+         * @name FindAllSubscriptionFixedCharges
+         * @summary List subscription fixed charges
+         * @request GET:/subscriptions/{external_id}/fixed_charges
+         * @secure
+         */
+        findAllSubscriptionFixedCharges: (externalId: string, params?: RequestParams) => Promise<HttpResponse<FixedCharges, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     taxes: {
         /**
@@ -9956,6 +10699,46 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         destroyWallet: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Wallet, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint replaces all existing metadata on a wallet with the provided key-value pairs. Any existing metadata keys not included in the request will be removed.
+         *
+         * @tags wallets
+         * @name ReplaceWalletMetadata
+         * @summary Replace wallet metadata
+         * @request POST:/wallets/{lago_id}/metadata
+         * @secure
+         */
+        replaceWalletMetadata: (lagoId: string, data: WalletMetadataResponse, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint merges the provided metadata with existing metadata on the wallet. Existing keys not in the request are preserved. New keys are added, existing keys are updated.
+         *
+         * @tags wallets
+         * @name MergeWalletMetadata
+         * @summary Merge wallet metadata
+         * @request PATCH:/wallets/{lago_id}/metadata
+         * @secure
+         */
+        mergeWalletMetadata: (lagoId: string, data: WalletMetadataResponse, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes all metadata from a wallet.
+         *
+         * @tags wallets
+         * @name DeleteAllWalletMetadata
+         * @summary Delete all wallet metadata
+         * @request DELETE:/wallets/{lago_id}/metadata
+         * @secure
+         */
+        deleteAllWalletMetadata: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a single metadata key from a wallet.
+         *
+         * @tags wallets
+         * @name DeleteWalletMetadataKey
+         * @summary Delete a metadata key
+         * @request DELETE:/wallets/{lago_id}/metadata/{key}
+         * @secure
+         */
+        deleteWalletMetadataKey: (lagoId: string, key: string, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description This endpoint is used to list all wallet transactions.
          *