stripe 18.5.0-beta.2 → 18.6.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,113 @@
 # Changelog
 
+## 18.6.0-alpha.1 - 2025-08-27
+* [#2393](https://github.com/stripe/stripe-node/pull/2393) Use the right API version 2025-08-27.preview
+* [#2390](https://github.com/stripe/stripe-node/pull/2390) Update generated code for private-preview
+  * Add support for `attach_cadence` method on resource `Subscription`
+  * Add support for `currency` and `external_customer_id` on `Billing.AlertTriggered`
+  * Add support for `custom_pricing_unit` on `Billing.AlertTriggered`, `Billing.CreditBalanceSummary.balances[].available_balance`, `Billing.CreditBalanceSummary.balances[].ledger_balance`, `Billing.CreditBalanceTransaction.credit.amount`, `Billing.CreditBalanceTransaction.debit.amount`, `Billing.CreditGrant.amount`, and `Billing.CreditGrantCreateParams.amount`
+  * Add support for `customer` on `Billing.AlertListParams`
+  * Change type of `Billing.Alert.alert_type`, `Billing.AlertCreateParams.alert_type`, and `Billing.AlertListParams.alert_type` from `literal('usage_threshold')` to `enum('credit_balance_threshold'|'usage_threshold')`
+  * Add support for `credit_balance_threshold` on `Billing.AlertCreateParams` and `Billing.Alert`
+  * Add support for `billable_items` on `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, and `Billing.CreditGrantCreateParams.applicability_config.scope`
+  * Change type of `Billing.CreditBalanceSummary.balances[].available_balance.type`, `Billing.CreditBalanceSummary.balances[].ledger_balance.type`, `Billing.CreditBalanceTransaction.credit.amount.type`, `Billing.CreditBalanceTransaction.debit.amount.type`, `Billing.CreditGrant.amount.type`, and `Billing.CreditGrantCreateParams.amount.type` from `literal('monetary')` to `enum('custom_pricing_unit'|'monetary')`
+  * Add support for `license_fee_subscription_details` and `rate_card_subscription_details` on `InvoiceItem.parent` and `InvoiceLineItem.parent`
+  * Change type of `InvoiceItem.parent.type` from `literal('subscription_details')` to `enum('license_fee_subscription_details'|'rate_card_subscription_details'|'subscription_details')`
+  * Add support for `license_fee_details` and `rate_card_rate_details` on `InvoiceItem.pricing` and `InvoiceLineItem.pricing`
+  * Change type of `InvoiceItem.pricing.type` and `InvoiceLineItem.pricing.type` from `literal('price_details')` to `enum('license_fee_details'|'price_details'|'rate_card_rate_details')`
+  * Add support for `billing_cadence` on `InvoiceCreatePreviewParams`, `SubscriptionCreateParams`, and `Subscription`
+  * Add support for `billing_cadence_details` on `Invoice.parent` and `QuotePreviewInvoice.parent`
+  * Add support for new value `billing_cadence_details` on enums `Invoice.parent.type` and `QuotePreviewInvoice.parent.type`
+  * Add support for new values `license_fee_subscription_details` and `rate_card_subscription_details` on enum `InvoiceLineItem.parent.type`
+  * Add support for new resources `V2.Billing.BillSettingVersion`, `V2.Billing.BillSetting`, `V2.Billing.Cadence`, `V2.Billing.CollectionSettingVersion`, `V2.Billing.CollectionSetting`, `V2.Billing.CustomPricingUnit`, `V2.Billing.IntentAction`, `V2.Billing.Intent`, `V2.Billing.LicenseFeeSubscription`, `V2.Billing.LicenseFeeVersion`, `V2.Billing.LicenseFee`, `V2.Billing.LicensedItem`, `V2.Billing.MeteredItem`, `V2.Billing.PricingPlanComponent`, `V2.Billing.PricingPlanSubscription`, `V2.Billing.PricingPlanVersion`, `V2.Billing.PricingPlan`, `V2.Billing.Profile`, `V2.Billing.RateCardRate`, `V2.Billing.RateCardSubscription`, `V2.Billing.RateCardVersion`, `V2.Billing.RateCard`, `V2.Billing.ServiceAction`, `V2.Core.ClaimableSandbox`, `V2.Reporting.ReportRun`, `V2.Reporting.Report`, and `V2.Tax.AutomaticRule`
+  * Add support for `create`, `deactivate`, `find`, `retrieve`, and `update` methods on resource `V2.Tax.AutomaticRule`
+  * Add support for `create` and `retrieve` methods on resources `V2.Billing.ServiceAction` and `V2.Reporting.ReportRun`
+  * Add support for `retrieve` method on resources `V2.Billing.LicenseFeeSubscription` and `V2.Reporting.Report`
+  * Add support for `create` method on resources `V2.Core.ClaimableSandbox`
+  * Add support for `cancel`, `create`, `list`, `retrieve`, and `update` methods on resources `V2.Billing.Cadence` and `V2.Billing.RateCardSubscription`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resources `V2.Billing.BillSetting`, `V2.Billing.CollectionSetting`, `V2.Billing.CustomPricingUnit`, `V2.Billing.LicenseFee`, `V2.Billing.LicensedItem`, `V2.Billing.MeteredItem`, `V2.Billing.PricingPlan`, `V2.Billing.Profile`, and `V2.Billing.RateCard`
+  * Add support for `list` and `retrieve` methods on resources `V2.Billing.BillSettingVersion`, `V2.Billing.CollectionSettingVersion`, `V2.Billing.IntentAction`, `V2.Billing.LicenseFeeVersion`, `V2.Billing.PricingPlanSubscription`, `V2.Billing.PricingPlanVersion`, and `V2.Billing.RateCardVersion`
+  * Add support for `create`, `del`, `list`, and `retrieve` methods on resource `V2.Billing.RateCardRate`
+  * Add support for `create`, `del`, `list`, `retrieve`, and `update` methods on resource `V2.Billing.PricingPlanComponent`
+  * Add support for `cancel`, `commit`, `create`, `list`, `release_reservation`, `reserve`, and `retrieve` methods on resource `V2.Billing.Intent`
+  * Add support for `changes` on `V2.Event`
+  * Add support for thin events `V2BillingCadenceBilledEvent`, `V2BillingCadenceCanceledEvent`, `V2BillingCadenceCreatedEvent`, and `V2BillingCadenceErroredEvent` with related object `V2.Billing.Cadence`
+  * Add support for thin events `V2BillingLicenseFeeCreatedEvent` and `V2BillingLicenseFeeUpdatedEvent` with related object `V2.Billing.LicenseFee`
+  * Add support for thin event `V2BillingLicenseFeeVersionCreatedEvent` with related object `V2.Billing.LicenseFeeVersion`
+  * Add support for thin events `V2BillingLicensedItemCreatedEvent` and `V2BillingLicensedItemUpdatedEvent` with related object `V2.Billing.LicensedItem`
+  * Add support for thin events `V2BillingMeteredItemCreatedEvent` and `V2BillingMeteredItemUpdatedEvent` with related object `V2.Billing.MeteredItem`
+  * Add support for thin events `V2BillingPricingPlanCreatedEvent` and `V2BillingPricingPlanUpdatedEvent` with related object `V2.Billing.PricingPlan`
+  * Add support for thin events `V2BillingPricingPlanComponentCreatedEvent` and `V2BillingPricingPlanComponentUpdatedEvent` with related object `V2.Billing.PricingPlanComponent`
+  * Add support for thin events `V2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEvent`, `V2BillingPricingPlanSubscriptionCollectionCurrentEvent`, `V2BillingPricingPlanSubscriptionCollectionPastDueEvent`, `V2BillingPricingPlanSubscriptionCollectionPausedEvent`, `V2BillingPricingPlanSubscriptionCollectionUnpaidEvent`, `V2BillingPricingPlanSubscriptionServicingActivatedEvent`, `V2BillingPricingPlanSubscriptionServicingCanceledEvent`, and `V2BillingPricingPlanSubscriptionServicingPausedEvent` with related object `V2.Billing.PricingPlanSubscription`
+  * Add support for thin event `V2BillingPricingPlanVersionCreatedEvent` with related object `V2.Billing.PricingPlanVersion`
+  * Add support for thin events `V2BillingRateCardCreatedEvent` and `V2BillingRateCardUpdatedEvent` with related object `V2.Billing.RateCard`
+  * Add support for thin event `V2BillingRateCardRateCreatedEvent` with related object `V2.Billing.RateCardRate`
+  * Add support for thin events `V2BillingRateCardSubscriptionActivatedEvent`, `V2BillingRateCardSubscriptionCanceledEvent`, `V2BillingRateCardSubscriptionCollectionAwaitingCustomerActionEvent`, `V2BillingRateCardSubscriptionCollectionCurrentEvent`, `V2BillingRateCardSubscriptionCollectionPastDueEvent`, `V2BillingRateCardSubscriptionCollectionPausedEvent`, `V2BillingRateCardSubscriptionCollectionUnpaidEvent`, `V2BillingRateCardSubscriptionServicingActivatedEvent`, `V2BillingRateCardSubscriptionServicingCanceledEvent`, and `V2BillingRateCardSubscriptionServicingPausedEvent` with related object `V2.Billing.RateCardSubscription`
+  * Add support for thin event `V2BillingRateCardVersionCreatedEvent` with related object `V2.Billing.RateCardVersion`
+  * Add support for thin events `V2CoreHealthApiErrorFiringEvent`, `V2CoreHealthApiErrorResolvedEvent`, `V2CoreHealthApiLatencyFiringEvent`, `V2CoreHealthApiLatencyResolvedEvent`, `V2CoreHealthAuthorizationRateDropFiringEvent`, `V2CoreHealthAuthorizationRateDropResolvedEvent`, `V2CoreHealthEventGenerationFailureResolvedEvent`, `V2CoreHealthFraudRateIncreasedEvent`, `V2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent`, `V2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent`, `V2CoreHealthPaymentMethodErrorFiringEvent`, `V2CoreHealthPaymentMethodErrorResolvedEvent`, `V2CoreHealthTrafficVolumeDropFiringEvent`, `V2CoreHealthTrafficVolumeDropResolvedEvent`, `V2CoreHealthWebhookLatencyFiringEvent`, and `V2CoreHealthWebhookLatencyResolvedEvent`
+  * Add support for thin events `V2ReportingReportRunCreatedEvent`, `V2ReportingReportRunFailedEvent`, `V2ReportingReportRunSucceededEvent`, and `V2ReportingReportRunUpdatedEvent` with related object `V2.Reporting.ReportRun`
+  * Add support for error type `RateLimitError`
+
+## 18.6.0-beta.1 - 2025-08-27
+This release changes the pinned API version to `2025-08-27.preview`.
+
+* [#2381](https://github.com/stripe/stripe-node/pull/2381) Update generated code for beta
+  * Add support for `list` and `retrieve` methods on resource `InvoicePayment`
+  * Add support for `list` method on resource `Mandate`
+  * Add support for `applied` on `V2.Core.Account.configuration.customer`, `V2.Core.Account.configuration.merchant`, `V2.Core.Account.configuration.recipient`, `V2.Core.Account.configuration.storer`, `V2.Core.AccountUpdateParams.configuration.customer`, `V2.Core.AccountUpdateParams.configuration.merchant`, `V2.Core.AccountUpdateParams.configuration.recipient`, and `V2.Core.AccountUpdateParams.configuration.storer`
+  * Add support for new values `ao_nif`, `az_tin`, `bd_etin`, `cr_cpj`, `cr_nite`, `do_rcn`, `gt_nit`, `kz_bin`, `mz_nuit`, `pe_ruc`, `pk_ntn`, `sa_crn`, and `sa_tin` on enums `V2.Core.Account.identity.business_details.id_numbers[].type`, `V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type`, and `V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type`
+  * Add support for new values `ao_nif`, `az_tin`, `bd_brc`, `bd_etin`, `bd_nid`, `cr_cpf`, `cr_dimex`, `cr_nite`, `do_rcn`, `gt_nit`, `kz_iin`, `mz_nuit`, `pe_dni`, `pk_cnic`, `pk_snic`, and `sa_tin` on enums `V2.Core.Account.identity.individual.id_numbers[].type`, `V2.Core.AccountCreateParams.identity.individual.id_numbers[].type`, `V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type`, `V2.Core.Person.id_numbers[].type`, `V2.Core.PersonCreateParams.id_numbers[].type`, and `V2.Core.PersonUpdateParams.id_numbers[].type`
+  * Change type of `Billing.AlertTriggered.value` from `longInteger` to `decimal_string`
+  * Add support for `display_name` on `V2.MoneyManagement.FinancialAccountCreateParams` and `V2.MoneyManagement.FinancialAccount`
+  * Add support for new value `currency_conversion` on enums `V2.MoneyManagement.Transaction.category` and `V2.MoneyManagement.TransactionEntry.transaction_details.category`
+  * Add support for `currency_conversion` on `V2.MoneyManagement.Transaction.flow` and `V2.MoneyManagement.TransactionEntry.transaction_details.flow`
+  * Add support for new value `currency_conversion` on enums `V2.MoneyManagement.Transaction.flow.type` and `V2.MoneyManagement.TransactionEntry.transaction_details.flow.type`
+  * Add support for `payments` on `BalanceSettingUpdateParams` and `BalanceSettings`
+  * Remove support for `debit_negative_balances`, `payouts`, and `settlement_timing` on `BalanceSettingUpdateParams` and `BalanceSettings`
+  * Add support for `mandate` on `Charge.payment_method_details.pix`, `PaymentAttemptRecord.payment_method_details.pix`, and `PaymentRecord.payment_method_details.pix`
+  * Add support for `coupon_data` on `Checkout.SessionCreateParams.discounts[]`
+  * Add support for `mandate_options` on `Checkout.Session.payment_method_options.pix`, `Checkout.SessionCreateParams.payment_method_options.pix`, `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, and `PaymentIntentUpdateParams.payment_method_options.pix`
+  * Change type of `Checkout.Session.payment_method_options.pix.setup_future_usage`, `Checkout.SessionCreateParams.payment_method_options.pix.setup_future_usage`, `PaymentIntent.payment_method_options.pix.setup_future_usage`, `PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage`, `PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage`, and `PaymentIntentUpdateParams.payment_method_options.pix.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+  * Add support for `amount` on `Mandate.multi_use`, `PaymentAttemptRecord`, and `PaymentRecord`
+  * Add support for `currency` on `Mandate.multi_use`
+  * Add support for `pix` on `Mandate.payment_method_details`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
+  * Add support for `limit` on `PaymentAttemptRecordListParams`
+  * Add support for `amount_authorized`, `amount_refunded`, and `application` on `PaymentAttemptRecord` and `PaymentRecord`
+  * Add support for `processor_details` on `PaymentAttemptRecord`, `PaymentRecordReportPaymentParams`, and `PaymentRecord`
+  * Remove support for `payment_reference` on `PaymentAttemptRecord`, `PaymentRecordReportPaymentParams`, and `PaymentRecord`
+  * Add support for `installments` on `PaymentAttemptRecord.payment_method_details.alma` and `PaymentRecord.payment_method_details.alma`
+  * Add support for `transaction_id` on `PaymentAttemptRecord.payment_method_details.alma`, `PaymentAttemptRecord.payment_method_details.amazon_pay`, `PaymentAttemptRecord.payment_method_details.billie`, `PaymentAttemptRecord.payment_method_details.kakao_pay`, `PaymentAttemptRecord.payment_method_details.kr_card`, `PaymentAttemptRecord.payment_method_details.naver_pay`, `PaymentAttemptRecord.payment_method_details.payco`, `PaymentAttemptRecord.payment_method_details.revolut_pay`, `PaymentAttemptRecord.payment_method_details.samsung_pay`, `PaymentAttemptRecord.payment_method_details.satispay`, `PaymentRecord.payment_method_details.alma`, `PaymentRecord.payment_method_details.amazon_pay`, `PaymentRecord.payment_method_details.billie`, `PaymentRecord.payment_method_details.kakao_pay`, `PaymentRecord.payment_method_details.kr_card`, `PaymentRecord.payment_method_details.naver_pay`, `PaymentRecord.payment_method_details.payco`, `PaymentRecord.payment_method_details.revolut_pay`, `PaymentRecord.payment_method_details.samsung_pay`, and `PaymentRecord.payment_method_details.satispay`
+  * Add support for `location` and `reader` on `PaymentAttemptRecord.payment_method_details.paynow` and `PaymentRecord.payment_method_details.paynow`
+  * Add support for `latest_active_mandate` on `PaymentMethod`
+  * Change `Payout.payout_method` to be required
+  * Add support for `metadata` and `period` on `QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]`
+  * Add support for `pix_display_qr_code` on `SetupIntent.next_action`
+  * Add support for `reader_security` on `Terminal.ConfigurationCreateParams`, `Terminal.ConfigurationUpdateParams`, and `Terminal.Configuration`
+  * Add support for error codes `customer_session_expired` and `india_recurring_payment_mandate_canceled` on `QuotePreviewInvoice.last_finalization_error`
+
+## 18.5.0 - 2025-08-27
+* [#2392](https://github.com/stripe/stripe-node/pull/2392) Add section on private preview SDKs in readme
+* [#2384](https://github.com/stripe/stripe-node/pull/2384) Update generated code. This release changes the pinned API version to `2025-08-27.basil`.
+  * Add support for `balance_report`, `payout_details`, and `payout_reconciliation_report` on `AccountSession.components` and `AccountSessionCreateParams.components`
+  * Add support for `name` on `BillingPortal.ConfigurationCreateParams`, `BillingPortal.ConfigurationUpdateParams`, and `BillingPortal.Configuration`
+  * Add support for `installments` on `Charge.payment_method_details.alma`
+  * Add support for `transaction_id` on `Charge.payment_method_details.alma`, `Charge.payment_method_details.amazon_pay`, `Charge.payment_method_details.billie`, `Charge.payment_method_details.kakao_pay`, `Charge.payment_method_details.kr_card`, `Charge.payment_method_details.naver_pay`, `Charge.payment_method_details.payco`, `Charge.payment_method_details.revolut_pay`, `Charge.payment_method_details.samsung_pay`, and `Charge.payment_method_details.satispay`
+  * Add support for `location` and `reader` on `Charge.payment_method_details.paynow`
+  * Add support for `amount_includes_iof` on `Checkout.Session.payment_method_options.pix`, `Checkout.SessionCreateParams.payment_method_options.pix`, `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, and `PaymentIntentUpdateParams.payment_method_options.pix`
+  * Add support for new values `block` and `resolution` on enum `Dispute.payment_method_details.card.case_type`
+  * Add support for new value `terminal_android_apk` on enums `File.purpose` and `FileListParams.purpose`
+  * Add support for new value `terminal_android_apk` on enum `FileCreateParams.purpose`
+  * Add support for `metadata` and `period` on `InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[]`, `SubscriptionCreateParams.add_invoice_items[]`, `SubscriptionSchedule.phases[].add_invoice_items[]`, `SubscriptionScheduleCreateParams.phases[].add_invoice_items[]`, `SubscriptionScheduleUpdateParams.phases[].add_invoice_items[]`, and `SubscriptionUpdateParams.add_invoice_items[]`
+  * Add support for `exp_month` and `exp_year` on `Issuing.CardCreateParams`
+  * Add support for `excluded_payment_method_types` on `PaymentIntentCreateParams` and `PaymentIntent`
+  * Add support for `payout_method` on `PayoutCreateParams` and `Payout`
+  * Add support for `mxn` on `Terminal.Configuration.tipping`, `Terminal.ConfigurationCreateParams.tipping`, and `Terminal.ConfigurationUpdateParams.tipping`
+  * Add support for `card` on `Terminal.ReaderPresentPaymentMethodParams.testHelpers`
+  * Add support for new value `card` on enum `Terminal.ReaderPresentPaymentMethodParams.testHelpers.type`
+  * Add support for new value `2025-08-27.basil` on enum `WebhookEndpointCreateParams.api_version`
+  * Add support for error codes `customer_session_expired` and `india_recurring_payment_mandate_canceled` on `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
+* [#2389](https://github.com/stripe/stripe-node/pull/2389) fix(example): expires_at is in milliseconds
+
 ## 18.5.0-beta.2 - 2025-08-06
 * [#2383](https://github.com/stripe/stripe-node/pull/2383) Bring back GA invoice payments APIs that were missing in the public preview SDKs
     * Add support for new resource `InvoicePayment`

package/OPENAPI_VERSION

@@ -1 +1 @@
-v1868
+f4b80890ea17e89a543a77a389f29ca9be6fe615

package/README.md

@@ -528,7 +528,7 @@ const stripe = new Stripe('sk_test_...', {
 Stripe has features in the [public preview phase](https://docs.stripe.com/release-phases) that can be accessed via versions of this package that have the `-beta.X` suffix like `15.2.0-beta.2`.
 We would love for you to try these as we incrementally release new features and improve them based on your feedback.
 
-To install, choose the version that includes support for the preview feature you are interested in by reviewing the [releases page](https://github.com/stripe/stripe-node/releases/) and use it in the below command
+To install, pick the latest version with the `beta` suffix by reviewing the [releases page](https://github.com/stripe/stripe-node/releases/) and use it in the below command
 
 ```
 npm install stripe@<replace-with-the-version-of-your-choice> --save
@@ -537,8 +537,6 @@ npm install stripe@<replace-with-the-version-of-your-choice> --save
 > **Note**
 > There can be breaking changes between two versions of the public preview SDKs without a bump in the major version. Therefore we recommend pinning the package version to a specific version in your package.json file. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest public preview SDK.
 
-The versions tab on the [stripe page on npm](https://www.npmjs.com/package/stripe) lists the current tags in use. The `beta` tag here corresponds to the the latest public preview SDK.
-
 Some preview features require a name and version to be set in the `Stripe-Version` header like `feature_beta=v3`. If your preview feature has this requirement, use the `apiVersion` property of `config` object to set it:
 
 ```js
@@ -547,6 +545,10 @@ const stripe = new Stripe('sk_test_...', {
 });
 ```
 
+### Private Preview SDKs
+
+Stripe has features in the [private preview phase](https://docs.stripe.com/release-phases) that can be accessed via versions of this package that have the `-alpha.X` suffix like `15.2.0-alpha.2`. These are invite-only features. Once invited, you can install the private preview SDKs by following the same instructions as for the [public preview SDKs](https://github.com/stripe/stripe-node?tab=readme-ov-file#public-preview-sdks) above and replacing the term `beta` with `alpha`.
+
 ### Custom requests
 
 If you would like to send a request to an undocumented API (for example you are in a private beta), or if you prefer to bypass the method definitions in the library and specify your request details directly, you can use the `rawRequest` method on the StripeClient object.

package/VERSION

@@ -1 +1 @@
-18.5.0-beta.2
+18.6.0-alpha.1

package/cjs/Error.js

@@ -2,7 +2,7 @@
 /* eslint-disable camelcase */
 /* eslint-disable no-warning-comments */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidPaymentMethodError = exports.ControlledByDashboardError = exports.InvalidPayoutMethodError = exports.RecipientNotNotifiableError = exports.QuotaExceededError = exports.InsufficientFundsError = exports.NotCancelableError = exports.AlreadyCanceledError = exports.BlockedByStripeError = exports.FinancialAccountNotOpenError = exports.FeatureNotEnabledError = exports.AlreadyExistsError = exports.NonZeroBalanceError = exports.TemporarySessionExpiredError = exports.StripeUnknownError = exports.StripeInvalidGrantError = exports.StripeIdempotencyError = exports.StripeSignatureVerificationError = exports.StripeConnectionError = exports.StripeRateLimitError = exports.StripePermissionError = exports.StripeAuthenticationError = exports.StripeAPIError = exports.StripeInvalidRequestError = exports.StripeCardError = exports.StripeError = exports.generateV2Error = exports.generateV1Error = void 0;
+exports.TemporarySessionExpiredError = exports.RecipientNotNotifiableError = exports.RateLimitError = exports.QuotaExceededError = exports.NotCancelableError = exports.NonZeroBalanceError = exports.InvalidPayoutMethodError = exports.InvalidPaymentMethodError = exports.InsufficientFundsError = exports.FinancialAccountNotOpenError = exports.FeatureNotEnabledError = exports.ControlledByDashboardError = exports.BlockedByStripeError = exports.AlreadyExistsError = exports.AlreadyCanceledError = exports.StripeUnknownError = exports.StripeInvalidGrantError = exports.StripeIdempotencyError = exports.StripeSignatureVerificationError = exports.StripeConnectionError = exports.StripeRateLimitError = exports.StripePermissionError = exports.StripeAuthenticationError = exports.StripeAPIError = exports.StripeInvalidRequestError = exports.StripeCardError = exports.StripeError = exports.generateV2Error = exports.generateV1Error = void 0;
 const generateV1Error = (rawStripeError) => {
     switch (rawStripeError.type) {
         case 'card_error':
@@ -28,34 +28,36 @@ exports.generateV1Error = generateV1Error;
 const generateV2Error = (rawStripeError) => {
     switch (rawStripeError.type) {
         // switchCases: The beginning of the section generated from our OpenAPI spec
-        case 'temporary_session_expired':
-            return new TemporarySessionExpiredError(rawStripeError);
-        case 'non_zero_balance':
-            return new NonZeroBalanceError(rawStripeError);
+        case 'already_canceled':
+            return new AlreadyCanceledError(rawStripeError);
         case 'already_exists':
             return new AlreadyExistsError(rawStripeError);
+        case 'blocked_by_stripe':
+            return new BlockedByStripeError(rawStripeError);
+        case 'controlled_by_dashboard':
+            return new ControlledByDashboardError(rawStripeError);
         case 'feature_not_enabled':
             return new FeatureNotEnabledError(rawStripeError);
         case 'financial_account_not_open':
             return new FinancialAccountNotOpenError(rawStripeError);
-        case 'blocked_by_stripe':
-            return new BlockedByStripeError(rawStripeError);
-        case 'already_canceled':
-            return new AlreadyCanceledError(rawStripeError);
-        case 'not_cancelable':
-            return new NotCancelableError(rawStripeError);
         case 'insufficient_funds':
             return new InsufficientFundsError(rawStripeError);
+        case 'invalid_payment_method':
+            return new InvalidPaymentMethodError(rawStripeError);
+        case 'invalid_payout_method':
+            return new InvalidPayoutMethodError(rawStripeError);
+        case 'non_zero_balance':
+            return new NonZeroBalanceError(rawStripeError);
+        case 'not_cancelable':
+            return new NotCancelableError(rawStripeError);
         case 'quota_exceeded':
             return new QuotaExceededError(rawStripeError);
+        case 'rate_limit':
+            return new RateLimitError(rawStripeError);
         case 'recipient_not_notifiable':
             return new RecipientNotNotifiableError(rawStripeError);
-        case 'invalid_payout_method':
-            return new InvalidPayoutMethodError(rawStripeError);
-        case 'controlled_by_dashboard':
-            return new ControlledByDashboardError(rawStripeError);
-        case 'invalid_payment_method':
-            return new InvalidPaymentMethodError(rawStripeError);
+        case 'temporary_session_expired':
+            return new TemporarySessionExpiredError(rawStripeError);
         // switchCases: The end of the section generated from our OpenAPI spec
     }
     // Special handling for requests with missing required fields in V2 APIs.
@@ -220,24 +222,30 @@ class StripeUnknownError extends StripeError {
 }
 exports.StripeUnknownError = StripeUnknownError;
 // classDefinitions: The beginning of the section generated from our OpenAPI spec
-class TemporarySessionExpiredError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'TemporarySessionExpiredError');
-    }
-}
-exports.TemporarySessionExpiredError = TemporarySessionExpiredError;
-class NonZeroBalanceError extends StripeError {
+class AlreadyCanceledError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'NonZeroBalanceError');
+        super(rawStripeError, 'AlreadyCanceledError');
     }
 }
-exports.NonZeroBalanceError = NonZeroBalanceError;
+exports.AlreadyCanceledError = AlreadyCanceledError;
 class AlreadyExistsError extends StripeError {
     constructor(rawStripeError = {}) {
         super(rawStripeError, 'AlreadyExistsError');
     }
 }
 exports.AlreadyExistsError = AlreadyExistsError;
+class BlockedByStripeError extends StripeError {
+    constructor(rawStripeError = {}) {
+        super(rawStripeError, 'BlockedByStripeError');
+    }
+}
+exports.BlockedByStripeError = BlockedByStripeError;
+class ControlledByDashboardError extends StripeError {
+    constructor(rawStripeError = {}) {
+        super(rawStripeError, 'ControlledByDashboardError');
+    }
+}
+exports.ControlledByDashboardError = ControlledByDashboardError;
 class FeatureNotEnabledError extends StripeError {
     constructor(rawStripeError = {}) {
         super(rawStripeError, 'FeatureNotEnabledError');
@@ -250,60 +258,60 @@ class FinancialAccountNotOpenError extends StripeError {
     }
 }
 exports.FinancialAccountNotOpenError = FinancialAccountNotOpenError;
-class BlockedByStripeError extends StripeError {
+class InsufficientFundsError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'BlockedByStripeError');
+        super(rawStripeError, 'InsufficientFundsError');
     }
 }
-exports.BlockedByStripeError = BlockedByStripeError;
-class AlreadyCanceledError extends StripeError {
+exports.InsufficientFundsError = InsufficientFundsError;
+class InvalidPaymentMethodError extends StripeError {
+    constructor(rawStripeError) {
+        super(rawStripeError, 'InvalidPaymentMethodError');
+        // @ts-ignore
+        this.invalid_param = this.raw.invalid_param;
+    }
+}
+exports.InvalidPaymentMethodError = InvalidPaymentMethodError;
+class InvalidPayoutMethodError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'AlreadyCanceledError');
+        super(rawStripeError, 'InvalidPayoutMethodError');
     }
 }
-exports.AlreadyCanceledError = AlreadyCanceledError;
-class NotCancelableError extends StripeError {
+exports.InvalidPayoutMethodError = InvalidPayoutMethodError;
+class NonZeroBalanceError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'NotCancelableError');
+        super(rawStripeError, 'NonZeroBalanceError');
     }
 }
-exports.NotCancelableError = NotCancelableError;
-class InsufficientFundsError extends StripeError {
+exports.NonZeroBalanceError = NonZeroBalanceError;
+class NotCancelableError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'InsufficientFundsError');
+        super(rawStripeError, 'NotCancelableError');
     }
 }
-exports.InsufficientFundsError = InsufficientFundsError;
+exports.NotCancelableError = NotCancelableError;
 class QuotaExceededError extends StripeError {
     constructor(rawStripeError = {}) {
         super(rawStripeError, 'QuotaExceededError');
     }
 }
 exports.QuotaExceededError = QuotaExceededError;
-class RecipientNotNotifiableError extends StripeError {
+class RateLimitError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'RecipientNotNotifiableError');
+        super(rawStripeError, 'RateLimitError');
     }
 }
-exports.RecipientNotNotifiableError = RecipientNotNotifiableError;
-class InvalidPayoutMethodError extends StripeError {
+exports.RateLimitError = RateLimitError;
+class RecipientNotNotifiableError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'InvalidPayoutMethodError');
+        super(rawStripeError, 'RecipientNotNotifiableError');
     }
 }
-exports.InvalidPayoutMethodError = InvalidPayoutMethodError;
-class ControlledByDashboardError extends StripeError {
+exports.RecipientNotNotifiableError = RecipientNotNotifiableError;
+class TemporarySessionExpiredError extends StripeError {
     constructor(rawStripeError = {}) {
-        super(rawStripeError, 'ControlledByDashboardError');
-    }
-}
-exports.ControlledByDashboardError = ControlledByDashboardError;
-class InvalidPaymentMethodError extends StripeError {
-    constructor(rawStripeError) {
-        super(rawStripeError, 'InvalidPaymentMethodError');
-        // @ts-ignore
-        this.invalid_param = this.raw.invalid_param;
+        super(rawStripeError, 'TemporarySessionExpiredError');
     }
 }
-exports.InvalidPaymentMethodError = InvalidPaymentMethodError;
+exports.TemporarySessionExpiredError = TemporarySessionExpiredError;
 // classDefinitions: The end of the section generated from our OpenAPI spec

package/cjs/RequestSender.js

@@ -285,7 +285,7 @@ class RequestSender {
             }
         }
     }
-    _rawRequest(method, path, params, options) {
+    _rawRequest(method, path, params, options, usage) {
         const requestPromise = new Promise((resolve, reject) => {
             let opts;
             try {
@@ -313,7 +313,8 @@ class RequestSender {
                     host: calculatedOptions.host,
                     streaming: !!calculatedOptions.streaming,
                     settings: {},
-                    usage: ['raw_request'],
+                    // If used internally for a non raw_request, overwrite the usage
+                    usage: usage || ['raw_request'],
                 };
             }
             catch (err) {
@@ -417,6 +418,7 @@ class RequestSender {
             }
             requestData = data;
             this._stripe.getClientUserAgent((clientUserAgent) => {
+                var _a, _b;
                 const apiVersion = this._stripe.getApiField('version');
                 const headers = this._makeHeaders({
                     contentType: apiMode == 'v2'
@@ -426,8 +428,9 @@ class RequestSender {
                     apiVersion: apiVersion,
                     clientUserAgent,
                     method,
-                    userSuppliedHeaders: options.headers,
-                    userSuppliedSettings: options.settings,
+                    // other callers expect null, but .headers being optional means it's undefined if not supplied. So we normalize to null.
+                    userSuppliedHeaders: (_a = options.headers) !== null && _a !== void 0 ? _a : null,
+                    userSuppliedSettings: (_b = options.settings) !== null && _b !== void 0 ? _b : {},
                     stripeAccount: apiMode == 'v2' ? null : this._stripe.getApiField('stripeAccount'),
                     stripeContext: apiMode == 'v2' ? this._stripe.getApiField('stripeContext') : null,
                     apiMode: apiMode,

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-07-30.preview';
+exports.ApiVersion = '2025-08-27.preview';

package/cjs/resources/Mandates.js

@@ -6,4 +6,9 @@ const StripeResource_js_1 = require("../StripeResource.js");
 const stripeMethod = StripeResource_js_1.StripeResource.method;
 exports.Mandates = StripeResource_js_1.StripeResource.extend({
     retrieve: stripeMethod({ method: 'GET', fullPath: '/v1/mandates/{mandate}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/mandates',
+        methodType: 'list',
+    }),
 });

package/cjs/resources/Subscriptions.js

@@ -19,6 +19,10 @@ exports.Subscriptions = StripeResource_js_1.StripeResource.extend({
         fullPath: '/v1/subscriptions',
         methodType: 'list',
     }),
+    attachCadence: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/subscriptions/{subscription}/attach_cadence',
+    }),
     cancel: stripeMethod({
         method: 'DELETE',
         fullPath: '/v1/subscriptions/{subscription_exposed_id}',

package/cjs/resources/V2/Billing/BillSettings/Versions.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Versions = void 0;
+const StripeResource_js_1 = require("../../../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Versions = StripeResource_js_1.StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/bill_settings/{bill_setting_id}/versions/{id}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/bill_settings/{bill_setting_id}/versions',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/V2/Billing/BillSettings.js

@@ -0,0 +1,27 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillSettings = void 0;
+const StripeResource_js_1 = require("../../../StripeResource.js");
+const Versions_js_1 = require("./BillSettings/Versions.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.BillSettings = StripeResource_js_1.StripeResource.extend({
+    constructor: function (...args) {
+        StripeResource_js_1.StripeResource.apply(this, args);
+        this.versions = new Versions_js_1.Versions(...args);
+    },
+    create: stripeMethod({ method: 'POST', fullPath: '/v2/billing/bill_settings' }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/bill_settings/{id}',
+    }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/bill_settings/{id}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/bill_settings',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/V2/Billing/Cadences.js

@@ -0,0 +1,23 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cadences = void 0;
+const StripeResource_js_1 = require("../../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Cadences = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v2/billing/cadences' }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/cadences/{id}',
+    }),
+    update: stripeMethod({ method: 'POST', fullPath: '/v2/billing/cadences/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/cadences',
+        methodType: 'list',
+    }),
+    cancel: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/cadences/{id}/cancel',
+    }),
+});

package/cjs/resources/V2/Billing/CollectionSettings/Versions.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Versions = void 0;
+const StripeResource_js_1 = require("../../../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Versions = StripeResource_js_1.StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/collection_settings/{collection_setting_id}/versions/{id}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/collection_settings/{collection_setting_id}/versions',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/V2/Billing/CollectionSettings.js

@@ -0,0 +1,30 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionSettings = void 0;
+const StripeResource_js_1 = require("../../../StripeResource.js");
+const Versions_js_1 = require("./CollectionSettings/Versions.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.CollectionSettings = StripeResource_js_1.StripeResource.extend({
+    constructor: function (...args) {
+        StripeResource_js_1.StripeResource.apply(this, args);
+        this.versions = new Versions_js_1.Versions(...args);
+    },
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/collection_settings',
+    }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/collection_settings/{id}',
+    }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/collection_settings/{id}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/collection_settings',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/V2/Billing/CustomPricingUnits.js

@@ -0,0 +1,25 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomPricingUnits = void 0;
+const StripeResource_js_1 = require("../../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.CustomPricingUnits = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/custom_pricing_units',
+    }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/custom_pricing_units/{id}',
+    }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/custom_pricing_units/{id}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/custom_pricing_units',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/V2/Billing/Intents/Actions.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Actions = void 0;
+const StripeResource_js_1 = require("../../../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Actions = StripeResource_js_1.StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/intents/{intent_id}/actions/{id}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/intents/{intent_id}/actions',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/V2/Billing/Intents.js

@@ -0,0 +1,36 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Intents = void 0;
+const StripeResource_js_1 = require("../../../StripeResource.js");
+const Actions_js_1 = require("./Intents/Actions.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Intents = StripeResource_js_1.StripeResource.extend({
+    constructor: function (...args) {
+        StripeResource_js_1.StripeResource.apply(this, args);
+        this.actions = new Actions_js_1.Actions(...args);
+    },
+    create: stripeMethod({ method: 'POST', fullPath: '/v2/billing/intents' }),
+    retrieve: stripeMethod({ method: 'GET', fullPath: '/v2/billing/intents/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/billing/intents',
+        methodType: 'list',
+    }),
+    cancel: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/intents/{id}/cancel',
+    }),
+    commit: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/intents/{id}/commit',
+    }),
+    releaseReservation: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/intents/{id}/release_reservation',
+    }),
+    reserve: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/intents/{id}/reserve',
+    }),
+});