stripe 22.5.0-alpha.2 → 22.5.0

package/esm/resources/V2/Billing/Cadences.d.ts

@@ -1,1011 +0,0 @@
-import { StripeResource } from '../../../StripeResource.js';
-import { MetadataParam, OtherString, Metadata, Decimal } from '../../../shared.js';
-import { RequestOptions, V2ListPromise, Response } from '../../../lib.js';
-import { SpendModifierRuleResource } from './Cadences/SpendModifierRules.js';
-import { Stripe } from '../../../stripe.core.js';
-export declare class CadenceResource extends StripeResource {
-    private readonly stripe;
-    spendModifierRules: SpendModifierRuleResource;
-    constructor(stripe: Stripe);
-    /**
-     * List Billing Cadences.
-     */
-    list(params?: V2.Billing.CadenceListParams, options?: RequestOptions): V2ListPromise<Cadence>;
-    /**
-     * Create a Billing Cadence object.
-     */
-    create(params: V2.Billing.CadenceCreateParams, options?: RequestOptions): Promise<Response<Cadence>>;
-    /**
-     * Retrieve a Billing Cadence object.
-     */
-    retrieve(id: string, params?: V2.Billing.CadenceRetrieveParams, options?: RequestOptions): Promise<Response<Cadence>>;
-    /**
-     * Update a Billing Cadence object.
-     */
-    update(id: string, params?: V2.Billing.CadenceUpdateParams, options?: RequestOptions): Promise<Response<Cadence>>;
-    /**
-     * Cancel the Billing Cadence.
-     */
-    cancel(id: string, params?: V2.Billing.CadenceCancelParams, options?: RequestOptions): Promise<Response<Cadence>>;
-}
-export interface Cadence {
-    /**
-     * Unique identifier for the object.
-     */
-    id: string;
-    /**
-     * String representing the object's type. Objects of the same type share the same value of the object field.
-     */
-    object: 'v2.billing.cadence';
-    /**
-     * The billing cycle is the object that defines future billing cycle dates.
-     */
-    billing_cycle: Cadence.BillingCycle;
-    /**
-     * Timestamp of when the object was created.
-     */
-    created: string;
-    /**
-     * The discount rules applied to all invoices for the cadence.
-     */
-    invoice_discount_rules?: Array<Cadence.InvoiceDiscountRule>;
-    /**
-     * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
-     */
-    livemode: boolean;
-    /**
-     * A lookup key used to retrieve cadences dynamically from a static string. Maximum length of 200 characters.
-     */
-    lookup_key?: string;
-    /**
-     * Set of [key-value pairs](https://docs.stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
-     */
-    metadata?: Metadata;
-    /**
-     * The date that the billing cadence will next bill. Null if the cadence is not active.
-     */
-    next_billing_date?: string;
-    /**
-     * The payer determines the entity financially responsible for the bill.
-     */
-    payer: Cadence.Payer;
-    /**
-     * The settings associated with the cadence.
-     */
-    settings?: Cadence.Settings;
-    /**
-     * Settings data that contains expanded billing settings configuration with actual values.
-     */
-    settings_data?: Cadence.SettingsData;
-    /**
-     * The current status of the cadence.
-     */
-    status: Cadence.Status;
-    /**
-     * The ID of the Test Clock.
-     */
-    test_clock?: string;
-}
-export declare namespace Cadence {
-    interface BillingCycle {
-        /**
-         * Specific configuration for determining billing dates when type=day.
-         */
-        day?: BillingCycle.Day;
-        /**
-         * The number of intervals (specified in the interval attribute) between cadence billings. For example, type=month and interval_count=3 bills every 3 months.
-         */
-        interval_count: number;
-        /**
-         * Specific configuration for determining billing dates when type=month.
-         */
-        month?: BillingCycle.Month;
-        /**
-         * The frequency at which a cadence bills.
-         */
-        type: BillingCycle.Type;
-        /**
-         * Specific configuration for determining billing dates when type=week.
-         */
-        week?: BillingCycle.Week;
-        /**
-         * Specific configuration for determining billing dates when type=year.
-         */
-        year?: BillingCycle.Year;
-    }
-    interface InvoiceDiscountRule {
-        /**
-         * Unique identifier for the object.
-         */
-        id: string;
-        /**
-         * Details if the discount is a percentage off.
-         */
-        percent_off?: InvoiceDiscountRule.PercentOff;
-        /**
-         * The type of the discount.
-         */
-        type: 'percent_off';
-    }
-    interface Payer {
-        /**
-         * The ID of the Billing Profile object which determines how a bill is paid.
-         */
-        billing_profile: string;
-        /**
-         * The ID of the Customer object.
-         */
-        customer?: string;
-        /**
-         * A string identifying the type of the payer. Currently the only supported value is `customer`.
-         */
-        type: 'customer';
-    }
-    interface Settings {
-        /**
-         * Settings that configure bills generation, which includes calculating totals, tax, and presenting invoices.
-         */
-        bill?: Settings.Bill;
-        /**
-         * Settings that configure and manage the behavior of collecting payments.
-         */
-        collection?: Settings.Collection;
-    }
-    interface SettingsData {
-        /**
-         * Expanded bill settings data with actual configuration values.
-         */
-        bill: SettingsData.Bill;
-        /**
-         * Expanded collection settings data with actual configuration values.
-         */
-        collection: SettingsData.Collection;
-    }
-    type Status = 'active' | 'canceled' | OtherString;
-    namespace BillingCycle {
-        interface Day {
-            /**
-             * The time at which the billing cycle ends.
-             */
-            time: Day.Time;
-        }
-        interface Month {
-            /**
-             * The day to anchor the billing on for a type="month" billing cycle from 1-31.
-             * If this number is greater than the number of days in the month being billed,
-             * this anchors to the last day of the month.
-             */
-            day_of_month: number;
-            /**
-             * The month to anchor the billing on for a type="month" billing cycle from
-             * 1-12. Occurrences are calculated from the month anchor.
-             */
-            month_of_year?: number;
-            /**
-             * The time at which the billing cycle ends.
-             */
-            time: Month.Time;
-        }
-        type Type = 'day' | 'month' | 'week' | 'year' | OtherString;
-        interface Week {
-            /**
-             * The day of the week to bill the type=week billing cycle on.
-             * Numbered from 1-7 for Monday to Sunday respectively, based on the ISO-8601 week day numbering.
-             */
-            day_of_week: number;
-            /**
-             * The time at which the billing cycle ends.
-             */
-            time: Week.Time;
-        }
-        interface Year {
-            /**
-             * The day to anchor the billing on for a type="month" billing cycle from 1-31.
-             * If this number is greater than the number of days in the month being billed,
-             * this anchors to the last day of the month.
-             */
-            day_of_month: number;
-            /**
-             * The month to bill on from 1-12. If not provided, this defaults to the month the cadence was created.
-             */
-            month_of_year: number;
-            /**
-             * The time at which the billing cycle ends.
-             */
-            time: Year.Time;
-        }
-        namespace Day {
-            interface Time {
-                /**
-                 * The hour at which the billing cycle ends.
-                 * This must be an integer between 0 and 23, inclusive.
-                 * 0 represents midnight, and 23 represents 11 PM.
-                 */
-                hour: number;
-                /**
-                 * The minute at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                minute: number;
-                /**
-                 * The second at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                second?: number;
-            }
-        }
-        namespace Month {
-            interface Time {
-                /**
-                 * The hour at which the billing cycle ends.
-                 * This must be an integer between 0 and 23, inclusive.
-                 * 0 represents midnight, and 23 represents 11 PM.
-                 */
-                hour: number;
-                /**
-                 * The minute at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                minute: number;
-                /**
-                 * The second at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                second?: number;
-            }
-        }
-        namespace Week {
-            interface Time {
-                /**
-                 * The hour at which the billing cycle ends.
-                 * This must be an integer between 0 and 23, inclusive.
-                 * 0 represents midnight, and 23 represents 11 PM.
-                 */
-                hour: number;
-                /**
-                 * The minute at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                minute: number;
-                /**
-                 * The second at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                second?: number;
-            }
-        }
-        namespace Year {
-            interface Time {
-                /**
-                 * The hour at which the billing cycle ends.
-                 * This must be an integer between 0 and 23, inclusive.
-                 * 0 represents midnight, and 23 represents 11 PM.
-                 */
-                hour: number;
-                /**
-                 * The minute at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                minute: number;
-                /**
-                 * The second at which the billing cycle ends.
-                 * Must be an integer between 0 and 59, inclusive.
-                 */
-                second?: number;
-            }
-        }
-    }
-    namespace InvoiceDiscountRule {
-        interface PercentOff {
-            /**
-             * The maximum applications configuration for this discount.
-             */
-            maximum_applications: PercentOff.MaximumApplications;
-            /**
-             * Percent that is taken off the amount. For example, a percent_off of 50.0 reduces a 100 USD amount to 50 USD.
-             */
-            percent_off: Decimal;
-        }
-        namespace PercentOff {
-            interface MaximumApplications {
-                /**
-                 * Max applications type of this discount, ex: indefinite.
-                 */
-                type: 'indefinite';
-            }
-        }
-    }
-    namespace Settings {
-        interface Bill {
-            /**
-             * The ID of the referenced settings object.
-             */
-            id: string;
-            /**
-             * Returns the Settings Version when the cadence is pinned to a specific version.
-             */
-            version?: string;
-        }
-        interface Collection {
-            /**
-             * The ID of the referenced settings object.
-             */
-            id: string;
-            /**
-             * Returns the Settings Version when the cadence is pinned to a specific version.
-             */
-            version?: string;
-        }
-    }
-    namespace SettingsData {
-        interface Bill {
-            /**
-             * Settings related to calculating a bill.
-             */
-            calculation: Bill.Calculation;
-            /**
-             * Settings related to invoice behavior.
-             */
-            invoice: Bill.Invoice;
-            /**
-             * The ID of the invoice rendering template to be used when generating invoices.
-             */
-            invoice_rendering_template?: string;
-        }
-        interface Collection {
-            /**
-             * Either automatic, or send_invoice. When charging automatically, Stripe attempts to pay this
-             * bill at the end of the period using the payment method attached to the billing profile. When sending an invoice,
-             * Stripe emails your billing profile an invoice with payment instructions.
-             * Defaults to automatic.
-             */
-            collection_method: Collection.CollectionMethod;
-            /**
-             * Email delivery settings.
-             */
-            email_delivery: Collection.EmailDelivery;
-            /**
-             * The ID of the PaymentMethodConfiguration object, which controls which payment methods are displayed to your customers.
-             */
-            payment_method_configuration: string;
-            /**
-             * Payment Method specific configuration stored on the object.
-             */
-            payment_method_options: Collection.PaymentMethodOptions;
-        }
-        namespace Bill {
-            interface Calculation {
-                /**
-                 * Settings for calculating tax.
-                 */
-                tax?: Calculation.Tax;
-            }
-            interface Invoice {
-                /**
-                 * The amount of time until the invoice is overdue for payment.
-                 */
-                time_until_due?: Invoice.TimeUntilDue;
-            }
-            namespace Calculation {
-                interface Tax {
-                    /**
-                     * Determines if tax is calculated automatically based on a PTC or manually based on rules defined by the business. Defaults to "manual".
-                     */
-                    type: Tax.Type;
-                }
-                namespace Tax {
-                    type Type = 'automatic' | 'manual' | OtherString;
-                }
-            }
-            namespace Invoice {
-                interface TimeUntilDue {
-                    /**
-                     * The interval unit for the time until due.
-                     */
-                    interval: TimeUntilDue.Interval;
-                    /**
-                     * The number of interval units. For example, if interval=day and interval_count=30,
-                     * the invoice is due in 30 days.
-                     */
-                    interval_count: number;
-                }
-                namespace TimeUntilDue {
-                    type Interval = 'day' | 'month' | 'week' | 'year';
-                }
-            }
-        }
-        namespace Collection {
-            type CollectionMethod = 'automatic' | 'send_invoice';
-            interface EmailDelivery {
-                /**
-                 * Controls emails for when the payment is due. For example after the invoice is finalized and transitions to Open state.
-                 */
-                payment_due?: EmailDelivery.PaymentDue;
-            }
-            interface PaymentMethodOptions {
-                /**
-                 * This sub-hash contains details about the Canadian pre-authorized debit payment method options.
-                 */
-                acss_debit?: PaymentMethodOptions.AcssDebit;
-                /**
-                 * This sub-hash contains details about the Bancontact payment method.
-                 */
-                bancontact?: PaymentMethodOptions.Bancontact;
-                /**
-                 * This sub-hash contains details about the Card payment method options.
-                 */
-                card?: PaymentMethodOptions.Card;
-                /**
-                 * This sub-hash contains details about the Bank transfer payment method options.
-                 */
-                customer_balance?: PaymentMethodOptions.CustomerBalance;
-                /**
-                 * This sub-hash contains details about the Konbini payment method options.
-                 */
-                konbini?: PaymentMethodOptions.Konbini;
-                /**
-                 * This sub-hash contains details about the SEPA Direct Debit payment method options.
-                 */
-                sepa_debit?: PaymentMethodOptions.SepaDebit;
-                /**
-                 * This sub-hash contains details about the ACH direct debit payment method options.
-                 */
-                us_bank_account?: PaymentMethodOptions.UsBankAccount;
-            }
-            namespace EmailDelivery {
-                interface PaymentDue {
-                    /**
-                     * If true an email for the invoice would be generated and sent out.
-                     */
-                    enabled: boolean;
-                    /**
-                     * If true the payment link to hosted invoice page would be included in email and PDF of the invoice.
-                     */
-                    include_payment_link: boolean;
-                }
-            }
-            namespace PaymentMethodOptions {
-                interface AcssDebit {
-                    /**
-                     * Additional fields for Mandate creation.
-                     */
-                    mandate_options?: AcssDebit.MandateOptions;
-                    /**
-                     * Verification method.
-                     */
-                    verification_method?: AcssDebit.VerificationMethod;
-                }
-                interface Bancontact {
-                    /**
-                     * Preferred language of the Bancontact authorization page that the customer is redirected to.
-                     */
-                    preferred_language?: Bancontact.PreferredLanguage;
-                }
-                interface Card {
-                    /**
-                     * Configuration options for setting up an eMandate for cards issued in India.
-                     */
-                    mandate_options?: Card.MandateOptions;
-                    /**
-                     * Selected network to process the payment on. Depends on the available networks of the card.
-                     */
-                    network?: string;
-                    /**
-                     * An advanced option 3D Secure. We strongly recommend that you rely on our SCA Engine to automatically prompt your customers
-                     * for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication).
-                     * However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option.
-                     * Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
-                     */
-                    request_three_d_secure?: Card.RequestThreeDSecure;
-                }
-                interface CustomerBalance {
-                    /**
-                     * Configuration for the bank transfer funding type, if the `funding_type` is set to `bank_transfer`.
-                     */
-                    bank_transfer?: CustomerBalance.BankTransfer;
-                    /**
-                     * The funding method type to be used when there are not enough funds in the customer balance. Currently the only supported value is `bank_transfer`.
-                     */
-                    funding_type?: 'bank_transfer';
-                }
-                interface Konbini {
-                }
-                interface SepaDebit {
-                }
-                interface UsBankAccount {
-                    /**
-                     * Additional fields for Financial Connections Session creation.
-                     */
-                    financial_connections: UsBankAccount.FinancialConnections;
-                    /**
-                     * Verification method.
-                     */
-                    verification_method: UsBankAccount.VerificationMethod;
-                }
-                namespace AcssDebit {
-                    interface MandateOptions {
-                        /**
-                         * Transaction type of the mandate.
-                         */
-                        transaction_type?: MandateOptions.TransactionType;
-                    }
-                    type VerificationMethod = 'automatic' | 'instant' | 'microdeposits' | OtherString;
-                    namespace MandateOptions {
-                        type TransactionType = 'business' | 'personal' | OtherString;
-                    }
-                }
-                namespace Bancontact {
-                    type PreferredLanguage = 'de' | 'en' | 'fr' | 'nl' | OtherString;
-                }
-                namespace Card {
-                    interface MandateOptions {
-                        /**
-                         * Amount to be charged for future payments.
-                         */
-                        amount?: bigint;
-                        /**
-                         * The AmountType for the mandate. One of `fixed` or `maximum`.
-                         */
-                        amount_type?: MandateOptions.AmountType;
-                        /**
-                         * A description of the mandate that is meant to be displayed to the customer.
-                         */
-                        description?: string;
-                    }
-                    type RequestThreeDSecure = 'any' | 'automatic' | 'challenge' | OtherString;
-                    namespace MandateOptions {
-                        type AmountType = 'fixed' | 'maximum' | OtherString;
-                    }
-                }
-                namespace CustomerBalance {
-                    interface BankTransfer {
-                        /**
-                         * Configuration for `eu_bank_transfer` funding type. Required if `type` is `eu_bank_transfer`.
-                         */
-                        eu_bank_transfer?: BankTransfer.EuBankTransfer;
-                        /**
-                         * The bank transfer type that can be used for funding.
-                         */
-                        type?: BankTransfer.Type;
-                    }
-                    namespace BankTransfer {
-                        interface EuBankTransfer {
-                            /**
-                             * The desired country code of the bank account information.
-                             */
-                            country: EuBankTransfer.Country;
-                        }
-                        type Type = 'eu_bank_transfer' | 'gb_bank_transfer' | 'jp_bank_transfer' | 'mx_bank_transfer' | 'us_bank_transfer' | OtherString;
-                        namespace EuBankTransfer {
-                            type Country = 'BE' | 'DE' | 'ES' | 'FR' | 'IE' | 'NL' | OtherString;
-                        }
-                    }
-                }
-                namespace UsBankAccount {
-                    interface FinancialConnections {
-                        /**
-                         * Provide filters for the linked accounts that the customer can select for the payment method.
-                         */
-                        filters?: FinancialConnections.Filters;
-                        /**
-                         * The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included.
-                         */
-                        permissions: Array<FinancialConnections.Permission>;
-                        /**
-                         * List of data features that you would like to retrieve upon account creation.
-                         */
-                        prefetch: Array<FinancialConnections.Prefetch>;
-                    }
-                    type VerificationMethod = 'automatic' | 'instant' | 'microdeposits' | OtherString;
-                    namespace FinancialConnections {
-                        interface Filters {
-                            /**
-                             * The account subcategories to use to filter for selectable accounts.
-                             */
-                            account_subcategories: Array<Filters.AccountSubcategory>;
-                        }
-                        type Permission = 'balances' | 'ownership' | 'payment_method' | 'transactions' | OtherString;
-                        type Prefetch = 'balances' | 'ownership' | 'transactions' | OtherString;
-                        namespace Filters {
-                            type AccountSubcategory = 'checking' | 'savings' | OtherString;
-                        }
-                    }
-                }
-            }
-        }
-    }
-}
-export declare namespace V2 {
-    namespace Billing {
-        interface CadenceCreateParams {
-            /**
-             * The billing cycle is the object that defines future billing cycle dates.
-             */
-            billing_cycle: CadenceCreateParams.BillingCycle;
-            /**
-             * The payer determines the entity financially responsible for the bill.
-             */
-            payer: CadenceCreateParams.Payer;
-            /**
-             * Additional resource to include in the response.
-             */
-            include?: Array<CadenceCreateParams.Include>;
-            /**
-             * A lookup key used to retrieve cadences dynamically from a static string. Maximum length of 200 characters.
-             */
-            lookup_key?: string;
-            /**
-             * Set of [key-value pairs](https://docs.stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
-             */
-            metadata?: MetadataParam;
-            /**
-             * The settings associated with the cadence.
-             */
-            settings?: CadenceCreateParams.Settings;
-        }
-        namespace CadenceCreateParams {
-            interface BillingCycle {
-                /**
-                 * Specific configuration for determining billing dates when type=day.
-                 */
-                day?: BillingCycle.Day;
-                /**
-                 * The number of intervals (specified in the interval attribute) between
-                 * cadence billings. For example, type=month and interval_count=3 bills every
-                 * 3 months. If not provided, this defaults to 1.
-                 */
-                interval_count?: number;
-                /**
-                 * Specific configuration for determining billing dates when type=month.
-                 */
-                month?: BillingCycle.Month;
-                /**
-                 * The frequency at which a cadence bills.
-                 */
-                type: BillingCycle.Type;
-                /**
-                 * Specific configuration for determining billing dates when type=week.
-                 */
-                week?: BillingCycle.Week;
-                /**
-                 * Specific configuration for determining billing dates when type=year.
-                 */
-                year?: BillingCycle.Year;
-            }
-            interface Payer {
-                /**
-                 * The ID of the Billing Profile object which determines how a bill is paid.
-                 */
-                billing_profile: string;
-            }
-            type Include = 'invoice_discount_rules' | 'settings_data' | OtherString;
-            interface Settings {
-                /**
-                 * Settings that configure bill generation, which includes calculating totals, tax, and presenting invoices.
-                 * If no setting is provided here, the settings from the customer referenced on the payer will be used.
-                 * If no customer settings are present, the merchant default settings will be used.
-                 */
-                bill?: Settings.Bill;
-                /**
-                 * Settings that configure and manage the behavior of collecting payments.
-                 * If no setting is provided here, the settings from the customer referenced from the payer will be used if they exist.
-                 * If no customer settings are present, the merchant default settings will be used.
-                 */
-                collection?: Settings.Collection;
-            }
-            namespace BillingCycle {
-                interface Day {
-                    /**
-                     * The time at which the billing cycle ends.
-                     * This field is optional, and if not provided, it defaults to
-                     * the time at which the cadence was created in UTC timezone.
-                     */
-                    time?: Day.Time;
-                }
-                interface Month {
-                    /**
-                     * The day to anchor the billing on for a type="month" billing cycle from
-                     * 1-31. If this number is greater than the number of days in the month being
-                     * billed, this anchors to the last day of the month. If not provided,
-                     * this defaults to the day the cadence was created.
-                     */
-                    day_of_month: number;
-                    /**
-                     * The month to anchor the billing on for a type="month" billing cycle from
-                     * 1-12. If not provided, this defaults to the month the cadence was created.
-                     * This setting can only be used for monthly billing cycles with `interval_count` of 2, 3, 4 or 6.
-                     * All occurrences are calculated from the month provided.
-                     */
-                    month_of_year?: number;
-                    /**
-                     * The time at which the billing cycle ends.
-                     * This field is optional, and if not provided, it defaults to
-                     * the time at which the cadence was created in UTC timezone.
-                     */
-                    time?: Month.Time;
-                }
-                type Type = 'day' | 'month' | 'week' | 'year' | OtherString;
-                interface Week {
-                    /**
-                     * The day of the week to bill the type=week billing cycle on.
-                     * Numbered from 1-7 for Monday to Sunday respectively, based on the ISO-8601
-                     * week day numbering. If not provided, this defaults to the day the
-                     * cadence was created.
-                     */
-                    day_of_week: number;
-                    /**
-                     * The time at which the billing cycle ends.
-                     * This field is optional, and if not provided, it defaults to
-                     * the time at which the cadence was created in UTC timezone.
-                     */
-                    time?: Week.Time;
-                }
-                interface Year {
-                    /**
-                     * The day to anchor the billing on for a type="month" billing cycle from
-                     * 1-31. If this number is greater than the number of days in the month being
-                     * billed, this anchors to the last day of the month. If not provided,
-                     * this defaults to the day the cadence was created.
-                     */
-                    day_of_month?: number;
-                    /**
-                     * The month to bill on from 1-12. If not provided, this defaults to the
-                     * month the cadence was created.
-                     */
-                    month_of_year?: number;
-                    /**
-                     * The time at which the billing cycle ends.
-                     * This field is optional, and if not provided, it defaults to
-                     * the time at which the cadence was created in UTC timezone.
-                     */
-                    time?: Year.Time;
-                }
-                namespace Day {
-                    interface Time {
-                        /**
-                         * The hour at which the billing cycle ends.
-                         * This must be an integer between 0 and 23, inclusive.
-                         * 0 represents midnight, and 23 represents 11 PM.
-                         */
-                        hour: number;
-                        /**
-                         * The minute at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        minute: number;
-                        /**
-                         * The second at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        second: number;
-                    }
-                }
-                namespace Month {
-                    interface Time {
-                        /**
-                         * The hour at which the billing cycle ends.
-                         * This must be an integer between 0 and 23, inclusive.
-                         * 0 represents midnight, and 23 represents 11 PM.
-                         */
-                        hour: number;
-                        /**
-                         * The minute at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        minute: number;
-                        /**
-                         * The second at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        second: number;
-                    }
-                }
-                namespace Week {
-                    interface Time {
-                        /**
-                         * The hour at which the billing cycle ends.
-                         * This must be an integer between 0 and 23, inclusive.
-                         * 0 represents midnight, and 23 represents 11 PM.
-                         */
-                        hour: number;
-                        /**
-                         * The minute at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        minute: number;
-                        /**
-                         * The second at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        second: number;
-                    }
-                }
-                namespace Year {
-                    interface Time {
-                        /**
-                         * The hour at which the billing cycle ends.
-                         * This must be an integer between 0 and 23, inclusive.
-                         * 0 represents midnight, and 23 represents 11 PM.
-                         */
-                        hour: number;
-                        /**
-                         * The minute at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        minute: number;
-                        /**
-                         * The second at which the billing cycle ends.
-                         * Must be an integer between 0 and 59, inclusive.
-                         */
-                        second: number;
-                    }
-                }
-            }
-            namespace Settings {
-                interface Bill {
-                    /**
-                     * The ID of the referenced settings object.
-                     */
-                    id: string;
-                    /**
-                     * An optional field to specify the version of the Settings to use.
-                     * If not provided, this defaults to the live version any time the settings are used.
-                     */
-                    version?: string;
-                }
-                interface Collection {
-                    /**
-                     * The ID of the referenced settings object.
-                     */
-                    id: string;
-                    /**
-                     * An optional field to specify the version of the Settings to use.
-                     * If not provided, this defaults to the live version any time the settings are used.
-                     */
-                    version?: string;
-                }
-            }
-        }
-    }
-}
-export declare namespace V2 {
-    namespace Billing {
-        interface CadenceRetrieveParams {
-            /**
-             * Additional resource to include in the response.
-             */
-            include?: Array<CadenceRetrieveParams.Include>;
-        }
-        namespace CadenceRetrieveParams {
-            type Include = 'invoice_discount_rules' | 'settings_data' | OtherString;
-        }
-    }
-}
-export declare namespace V2 {
-    namespace Billing {
-        interface CadenceUpdateParams {
-            /**
-             * Additional resource to include in the response.
-             */
-            include?: Array<CadenceUpdateParams.Include>;
-            /**
-             * A lookup key used to retrieve cadences dynamically from a static string. Maximum length of 200 characters.
-             */
-            lookup_key?: string;
-            /**
-             * Set of [key-value pairs](https://docs.stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
-             */
-            metadata?: MetadataParam;
-            /**
-             * The payer determines the entity financially responsible for the bill.
-             */
-            payer?: CadenceUpdateParams.Payer;
-            /**
-             * The settings associated with the cadence.
-             */
-            settings?: CadenceUpdateParams.Settings;
-        }
-        namespace CadenceUpdateParams {
-            type Include = 'invoice_discount_rules' | 'settings_data' | OtherString;
-            interface Payer {
-                /**
-                 * The ID of the Billing Profile object which determines how a bill is paid.
-                 */
-                billing_profile?: string;
-            }
-            interface Settings {
-                /**
-                 * Settings that configure bills generation, which includes calculating totals, tax, and presenting invoices. If null is provided, the current bill settings will be removed from the billing cadence.
-                 */
-                bill?: Settings.Bill;
-                /**
-                 * Settings that configure and manage the behavior of collecting payments. If null is provided, the current collection settings will be removed from the billing cadence.
-                 */
-                collection?: Settings.Collection;
-            }
-            namespace Settings {
-                interface Bill {
-                    /**
-                     * The ID of the referenced settings object.
-                     */
-                    id: string;
-                    /**
-                     * An optional field to specify the version of Settings to use.
-                     * If not provided, this defaults to the `live_version` specified on the setting, any time the settings are used.
-                     * Using a specific version here prevents the settings from updating, and is discouraged for cadences.
-                     * To clear a pinned version, set the version to null.
-                     */
-                    version?: string;
-                }
-                interface Collection {
-                    /**
-                     * The ID of the referenced settings object.
-                     */
-                    id: string;
-                    /**
-                     * An optional field to specify the version of Settings to use.
-                     * If not provided, this defaults to the `live_version` specified on the setting, any time the settings are used.
-                     * Using a specific version here prevents the settings from updating, and is discouraged for cadences.
-                     * To clear a pinned version, set the version to null.
-                     */
-                    version?: string;
-                }
-            }
-        }
-    }
-}
-export declare namespace V2 {
-    namespace Billing {
-        interface CadenceListParams {
-            /**
-             * Additional resource to include in the response.
-             */
-            include?: Array<CadenceListParams.Include>;
-            /**
-             * Optionally set the maximum number of results per page. Defaults to 20.
-             */
-            limit?: number;
-            /**
-             * Only return the cadences with these lookup_keys, if any exist. You can specify up to 10 lookup_keys.
-             * Mutually exclusive with `test_clock` and `payer`.
-             */
-            lookup_keys?: Array<string>;
-            /**
-             * If provided, only cadences that specifically reference the payer will be returned. Mutually exclusive with `test_clock` and `lookup_keys`.
-             */
-            payer?: CadenceListParams.Payer;
-            /**
-             * If provided, only cadences that specifically reference the provided test clock ID (via the
-             * customer's test clock) will be returned.
-             * Mutually exclusive with `payer`.
-             */
-            test_clock?: string;
-        }
-        namespace CadenceListParams {
-            type Include = 'invoice_discount_rules' | 'settings_data' | OtherString;
-            interface Payer {
-                /**
-                 * The ID of the Customer object. If provided, only cadences that specifically reference the provided customer ID will be returned.
-                 */
-                customer?: string;
-                /**
-                 * A string identifying the type of the payer. Currently the only supported value is `customer`.
-                 */
-                type: 'customer';
-            }
-        }
-    }
-}
-export declare namespace V2 {
-    namespace Billing {
-        interface CadenceCancelParams {
-            /**
-             * Additional resource to include in the response.
-             */
-            include?: Array<CadenceCancelParams.Include>;
-        }
-        namespace CadenceCancelParams {
-            type Include = 'invoice_discount_rules' | 'settings_data' | OtherString;
-        }
-    }
-}