Merge pull request #1719 from stripe/latest-codegen-beta

Update generated code for beta

Author: stripe-openapi[bot]

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 14.2.0 - 2026-01-16
+* [#1720](https://github.com/stripe/stripe-python/pull/1720) Update generated code
+  * Add support for event notifications `V2CoreAccountClosedEvent`, `V2CoreAccountCreatedEvent`, `V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationCustomerUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientUpdatedEvent`, `V2CoreAccountIncludingDefaultsUpdatedEvent`, `V2CoreAccountIncludingFutureRequirementsUpdatedEvent`, `V2CoreAccountIncludingIdentityUpdatedEvent`, `V2CoreAccountIncludingRequirementsUpdatedEvent`, and `V2CoreAccountUpdatedEvent` with related object `v2.core.Account`
+  * Add support for event notification `V2CoreAccountLinkReturnedEvent`
+  * Add support for event notifications `V2CoreAccountPersonCreatedEvent`, `V2CoreAccountPersonDeletedEvent`, and `V2CoreAccountPersonUpdatedEvent` with related object `v2.core.AccountPerson`
+* [#1687](https://github.com/stripe/stripe-python/pull/1687) Fix DeprecationWarning when encoding StripeObject metadata (fixes #1651)
+* [#1703](https://github.com/stripe/stripe-python/pull/1703) Update ci to run on Python 3.14 as well
+
 ## 14.2.0b1 - 2025-12-16
 This release changes the pinned API version to `2025-12-15.preview`.
 

CODEGEN_VERSION

@@ -1 +1 @@
-499f00588b1b41670a44a1e00598db81222ce169
+529796460735eb8ef64a29787291f1b4d4b29f1c

OPENAPI_VERSION

@@ -1 +1 @@
-v2149
+v2160

README.md

@@ -192,6 +192,12 @@ print(customer.last_response.code)
 print(customer.last_response.headers)
 ```
 
+### How to use undocumented parameters and properties
+
+In some cases, you might encounter parameters on an API request or fields on an API response that aren’t available in the SDKs.
+This might happen when they’re undocumented or when they’re in preview and you aren’t using a preview SDK. 
+See [undocumented params and properties](https://docs.stripe.com/sdks/server-side?lang=python#undocumented-params-and-fields) to send those parameters or access those fields.
+
 ### Writing a Plugin
 
 If you're writing a plugin that uses the library, we'd appreciate it if you

stripe/__init__.py

@@ -423,9 +423,6 @@ def add_beta_version(
     from stripe._oauth import OAuth as OAuth
     from stripe._oauth_service import OAuthService as OAuthService
     from stripe._order import Order as Order
-    from stripe._order_line_item_service import (
-        OrderLineItemService as OrderLineItemService,
-    )
     from stripe._order_service import OrderService as OrderService
     from stripe._payment_attempt_record import (
         PaymentAttemptRecord as PaymentAttemptRecord,
@@ -856,7 +853,6 @@ def add_beta_version(
     "OAuth": ("stripe._oauth", False),
     "OAuthService": ("stripe._oauth_service", False),
     "Order": ("stripe._order", False),
-    "OrderLineItemService": ("stripe._order_line_item_service", False),
     "OrderService": ("stripe._order_service", False),
     "PaymentAttemptRecord": ("stripe._payment_attempt_record", False),
     "PaymentAttemptRecordService": (

stripe/_account.py

@@ -1345,16 +1345,6 @@ class Branding(StripeObject):
             A CSS hex color value representing the secondary branding color for this account
             """
 
-        class Capital(StripeObject):
-            payout_destination: Optional[Dict[str, str]]
-            """
-            Per-currency mapping of user-selected destination accounts used to pay out loans.
-            """
-            payout_destination_selector: Optional[Dict[str, List[str]]]
-            """
-            Per-currency mapping of all destination accounts eligible to receive loan payouts.
-            """
-
         class CardIssuing(StripeObject):
             class TosAcceptance(StripeObject):
                 date: Optional[int]
@@ -1492,10 +1482,51 @@ class Schedule(StripeObject):
             _inner_class_types = {"schedule": Schedule}
 
         class PaypayPayments(StripeObject):
+            class Site(StripeObject):
+                class Accessible(StripeObject):
+                    pass
+
+                class InDevelopment(StripeObject):
+                    password_provided: Optional[bool]
+                    """
+                    Field to indicate that the website password has been provided.
+                    """
+                    username: Optional[str]
+                    """
+                    The username needed to access your business's website.
+                    """
+
+                class Restricted(StripeObject):
+                    payment_flow_file: Optional[str]
+                    """
+                    File explaining the payment flow for your business.
+                    """
+
+                accessible: Optional[Accessible]
+                in_development: Optional[InDevelopment]
+                restricted: Optional[Restricted]
+                type: Optional[
+                    Literal["accessible", "in_development", "restricted"]
+                ]
+                """
+                The status of your business's website.
+                """
+                _inner_class_types = {
+                    "accessible": Accessible,
+                    "in_development": InDevelopment,
+                    "restricted": Restricted,
+                }
+
+            additional_files: Optional[List[str]]
+            """
+            Additional files that are required to support the onboarding process of your business.
+            """
             goods_type: Optional[Literal["digital_content", "other"]]
             """
             Whether your business sells digital content or not.
             """
+            site: Optional[Site]
+            _inner_class_types = {"site": Site}
 
         class SepaDebitPayments(StripeObject):
             creditor_id: Optional[str]
@@ -1530,7 +1561,6 @@ class TosAcceptance(StripeObject):
         bacs_debit_payments: Optional[BacsDebitPayments]
         bank_bca_onboarding: Optional[BankBcaOnboarding]
         branding: Branding
-        capital: Optional[Capital]
         card_issuing: Optional[CardIssuing]
         card_payments: CardPayments
         dashboard: Dashboard
@@ -1545,7 +1575,6 @@ class TosAcceptance(StripeObject):
             "bacs_debit_payments": BacsDebitPayments,
             "bank_bca_onboarding": BankBcaOnboarding,
             "branding": Branding,
-            "capital": Capital,
             "card_issuing": CardIssuing,
             "card_payments": CardPayments,
             "dashboard": Dashboard,

stripe/_account_session.py

@@ -77,7 +77,7 @@ class Features(StripeObject):
                 """
                 instant_payouts: bool
                 """
-                Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+                Whether to allow creation of instant payouts. The default value is `enabled` when Stripe is responsible for negative account balances, and `use_dashboard_rules` otherwise.
                 """
                 standard_payouts: bool
                 """
@@ -213,7 +213,7 @@ class Features(StripeObject):
                 """
                 instant_payouts: bool
                 """
-                Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+                Whether to allow creation of instant payouts. The default value is `enabled` when Stripe is responsible for negative account balances, and `use_dashboard_rules` otherwise.
                 """
 
             enabled: bool
@@ -398,7 +398,7 @@ class Features(StripeObject):
                 """
                 instant_payouts: bool
                 """
-                Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+                Whether to allow creation of instant payouts. The default value is `enabled` when Stripe is responsible for negative account balances, and `use_dashboard_rules` otherwise.
                 """
                 standard_payouts: bool
                 """

stripe/_api_requestor.py

@@ -413,6 +413,8 @@ def specific_v2_api_error(self, rbody, rcode, resp, rheaders, error_data):
             return error.NotCancelableError(**error_args)
         elif type == "quota_exceeded":
             return error.QuotaExceededError(**error_args)
+        elif type == "rate_limit":
+            return error.RateLimitError(**error_args)
         elif type == "recipient_not_notifiable":
             return error.RecipientNotNotifiableError(**error_args)
         elif type == "temporary_session_expired":

stripe/_api_version.py

@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 # File generated from our OpenAPI spec
 class _ApiVersion:
-    CURRENT = "2025-12-15.preview"
+    CURRENT = "2026-01-28.preview"

stripe/_balance_transaction.py

@@ -77,7 +77,7 @@ class FeeDetail(StripeObject):
     The date that the transaction's net funds become available in the Stripe balance.
     """
     balance_type: Literal[
-        "issuing", "payments", "refund_and_dispute_prefunding"
+        "issuing", "payments", "refund_and_dispute_prefunding", "risk_reserved"
     ]
     """
     The balance that this transaction impacts.
@@ -183,6 +183,8 @@ class FeeDetail(StripeObject):
         "payout_minimum_balance_release",
         "refund",
         "refund_failure",
+        "reserve_hold",
+        "reserve_release",
         "reserve_transaction",
         "reserved_funds",
         "stripe_balance_payment_debit",
@@ -198,7 +200,7 @@ class FeeDetail(StripeObject):
         "transfer_refund",
     ]
     """
-    Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `stripe_balance_payment_debit`, `stripe_balance_payment_debit_reversal`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
+    Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `reserve_hold`, `reserve_release`, `stripe_fee`, `stripe_fx_fee`, `stripe_balance_payment_debit`, `stripe_balance_payment_debit_reversal`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
     """
 
     @classmethod