Merge branch 'master' into RUN_DEVSDK-2440

Author: xavdid

CHANGELOG.md

@@ -1,3 +1,58 @@
+## 15.2.0 - 2026-05-27
+This release changes the pinned API version to 2026-05-27.dahlia.
+
+* [#1816](https://github.com/stripe/stripe-python/pull/1816) Update generated code
+  * Add support for new resource `v2.commerce.ProductCatalogImport`
+  * Add support for `create` and `retrieve` methods on resource `v2.commerce.ProductCatalogImport`
+  * Add support for `bizum_payments` and `scalapay_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
+  * Add support for `automatic_transfer_rules_by_currency` on `BalanceSettings.Payment.Payout` and `BalanceSettingsModifyParamsPaymentPayout`
+  * Add support for `start_of_day` on `BalanceSettings.Payment.SettlementTiming` and `BalanceSettingsModifyParamsPaymentSettlementTiming`
+  * Add support for `description` on `ChargeCreateParamsTransferDatum`, `PaymentIntent.TransferDatum`, `PaymentIntentCreateParamsTransferDatum`, and `PaymentIntentModifyParamsTransferDatum`
+  * Add support for `bizum` on `Charge.PaymentMethodDetail`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `SetupIntent.PaymentMethodOption`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentConfirmParamsPaymentMethodOption`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodOption`, `SetupIntentModifyParamsPaymentMethodDatum`, and `SetupIntentModifyParamsPaymentMethodOption`
+  * Add support for `scalapay` on `Charge.PaymentMethodDetail`, `Checkout.Session.PaymentMethodOption`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `Refund.DestinationDetail`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentModifyParamsPaymentMethodDatum`, and `checkout.SessionCreateParamsPaymentMethodOption`
+  * Add support for `mandate` on `Charge.PaymentMethodDetail.Twint`, `PaymentAttemptRecord.PaymentMethodDetail.Twint`, and `PaymentRecord.PaymentMethodDetail.Twint`
+  * Add support for new values `bizum` and `scalapay` on enums `PaymentIntentConfirmParams.excluded_payment_method_types`, `PaymentIntentCreateParams.excluded_payment_method_types`, `PaymentIntentModifyParams.excluded_payment_method_types`, `SetupIntentCreateParams.excluded_payment_method_types`, `SetupIntentModifyParams.excluded_payment_method_types`, and `checkout.SessionCreateParams.excluded_payment_method_types`
+  * Change type of `PaymentIntentConfirmParamsPaymentMethodOptionTwint.setup_future_usage`, `PaymentIntentCreateParamsPaymentMethodOptionTwint.setup_future_usage`, `PaymentIntentModifyParamsPaymentMethodOptionTwint.setup_future_usage`, and `checkout.SessionCreateParamsPaymentMethodOptionTwint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+  * Add support for new values `bizum` and `scalapay` on enum `checkout.SessionCreateParams.payment_method_types`
+  * ⚠️ Change type of `Checkout.Session.PaymentMethodOption.Twint.setup_future_usage` and `PaymentIntent.PaymentMethodOption.Twint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+  * Add support for new values `bizum` and `scalapay` on enums `ConfirmationTokenCreateParamsPaymentMethodDatum.type`, `PaymentIntentConfirmParamsPaymentMethodDatum.type`, `PaymentIntentCreateParamsPaymentMethodDatum.type`, `PaymentIntentModifyParamsPaymentMethodDatum.type`, `SetupIntentConfirmParamsPaymentMethodDatum.type`, `SetupIntentCreateParamsPaymentMethodDatum.type`, and `SetupIntentModifyParamsPaymentMethodDatum.type`
+  * ⚠️ Add support for new values `bizum` and `scalapay` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+  * Add support for new values `bizum` and `scalapay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+  * Add support for `credited_items` on `InvoiceItem.ProrationDetail`
+  * Add support for new value `twint` on enums `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+  * Add support for `discountable` on `InvoiceCreatePreviewParamsScheduleDetailPhaseAddInvoiceItem`, `SubscriptionCreateParamsAddInvoiceItem`, `SubscriptionModifyParamsAddInvoiceItem`, `SubscriptionSchedule.Phase.AddInvoiceItem`, `SubscriptionScheduleCreateParamsPhaseAddInvoiceItem`, and `SubscriptionScheduleModifyParamsPhaseAddInvoiceItem`
+  * Add support for `billing_schedules` on `InvoiceCreatePreviewParamsSubscriptionDetail`, `SubscriptionCreateParams`, `SubscriptionModifyParams`, and `Subscription`
+  * Add support for new value `max_billed_until` on enums `InvoiceCreatePreviewParamsSubscriptionDetail.cancel_at`, `SubscriptionCreateParams.cancel_at`, and `SubscriptionModifyParams.cancel_at`
+  * Add support for `amount_paid_off_stripe` on `Invoice`
+  * ⚠️ Add support for new value `twint` on enums `Invoice.PaymentSetting.payment_method_types` and `Subscription.PaymentSetting.payment_method_types`
+  * Add support for `twint` on `Mandate.PaymentMethodDetail` and `SetupAttempt.PaymentMethodDetail`
+  * Add support for `metadata` on `PaymentIntent.TransferDatum`, `PaymentIntentCreateParamsTransferDatum`, `PaymentIntentModifyParamsTransferDatum`, and `Subscription.PendingUpdate`
+  * Add support for `payment_data` on `PaymentIntent.TransferDatum`, `PaymentIntentCreateParamsTransferDatum`, and `PaymentIntentModifyParamsTransferDatum`
+  * ⚠️ Add support for new values `bizum` and `scalapay` on enums `PaymentIntent.excluded_payment_method_types` and `SetupIntent.excluded_payment_method_types`
+  * Add support for `blik_authorize` on `PaymentIntent.NextAction` and `SetupIntent.NextAction`
+  * Add support for `payment_method_options` on `PaymentLinkCreateParams`, `PaymentLinkModifyParams`, and `PaymentLink`
+  * Add support for new value `bizum` on enums `PaymentLinkCreateParams.payment_method_types` and `PaymentLinkModifyParams.payment_method_types`
+  * ⚠️ Add support for new value `bizum` on enum `PaymentLink.payment_method_types`
+  * Add support for `active` on `PaymentMethodConfigurationListParams`
+  * Add support for `billed_until` on `SubscriptionItem`
+  * Add support for `discount` and `discounts` on `Subscription.PendingUpdate`
+  * Add support for `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationModifyParams`
+  * Add support for new values `simulated_verifone_m425`, `simulated_verifone_p630`, `simulated_verifone_ux700`, `simulated_verifone_v660p`, `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on enum `terminal.ReaderListParams.device_type`
+  * Add support for `api_error` and `print_content` on `Terminal.Reader.Action`
+  * ⚠️ Add support for new value `print_content` on enum `Terminal.Reader.Action.type`
+  * ⚠️ Add support for new values `simulated_verifone_m425`, `simulated_verifone_p630`, `simulated_verifone_ux700`, `simulated_verifone_v660p`, `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on enum `Terminal.Reader.device_type`
+  * Add support for `customer` on `test_helpers.TestClockCreateParams`
+  * Add support for new value `2026-05-27.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+  * Add support for `signer` on `V2.Core.Account.Identity.BusinessDetail.Document.ProofOfRegistration`, `V2.Core.Account.Identity.BusinessDetail.Document.ProofOfUltimateBeneficialOwnership`, `v2.core.AccountCreateParamsIdentityBusinessDetailDocumentProofOfRegistration`, `v2.core.AccountCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership`, `v2.core.AccountModifyParamsIdentityBusinessDetailDocumentProofOfRegistration`, `v2.core.AccountModifyParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership`, `v2.core.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfRegistration`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership`
+  * Add support for `azure_event_grid` on `V2.Core.EventDestination` and `v2.core.EventDestinationCreateParams`
+  * ⚠️ Add support for new value `no_azure_partner_topic_exists` on enum `V2.Core.EventDestination.StatusDetail.Disabled.reason`
+  * ⚠️ Add support for new value `azure_event_grid` on enum `V2.Core.EventDestination.type`
+  * Add support for new value `azure_event_grid` on enum `v2.core.EventDestinationCreateParams.type`
+  * ⚠️ Add support for new value `meter_event_value_too_many_digits` on enums `EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code` and `EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.code`
+  * Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `v2.commerce.ProductCatalogImport`
+  * Add support for error codes `payment_method_microdeposit_processing_error` and `siret_invalid` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
+* [#1813](https://github.com/stripe/stripe-python/pull/1813) Emit warning when `stripe-notify` header is present in response
+
 ## 15.1.0 - 2026-04-23
 This release changes the pinned API version to 2026-04-22.dahlia.
 

CODEGEN_VERSION

@@ -1 +1 @@
-9aa5ee4ed2b929f65b7fbf7c341f938682888500
+d59a1f4bdea3032b8e282d40badc032cb021fc60

OPENAPI_VERSION

@@ -1 +1 @@
-v2252
+v2277

VERSION

@@ -1 +1 @@
-15.1.0
+15.2.0

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stripe"
-version = "15.1.0"
+version = "15.2.0"
 readme = "README.md"
 description = "Python bindings for the Stripe API"
 authors = [{ name = "Stripe", email = "support@stripe.com" }]

stripe/_account.py

@@ -262,6 +262,10 @@ class Capabilities(StripeObject):
         """
         The status of the Billie capability of the account, or whether the account can directly process Billie payments.
         """
+        bizum_payments: Optional[Literal["active", "inactive", "pending"]]
+        """
+        The status of the Bizum capability of the account, or whether the account can directly process Bizum payments.
+        """
         blik_payments: Optional[Literal["active", "inactive", "pending"]]
         """
         The status of the blik payments capability of the account, or whether the account can directly process blik charges.
@@ -436,6 +440,10 @@ class Capabilities(StripeObject):
         """
         The status of the Satispay capability of the account, or whether the account can directly process Satispay payments.
         """
+        scalapay_payments: Optional[Literal["active", "inactive", "pending"]]
+        """
+        The status of the Scalapay capability of the account, or whether the account can directly process Scalapay payments.
+        """
         sepa_bank_transfer_payments: Optional[
             Literal["active", "inactive", "pending"]
         ]

stripe/_api_version.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
 # File generated from our OpenAPI spec
 class _ApiVersion:
-    CURRENT = "2026-04-22.dahlia"
+    CURRENT = "2026-05-27.dahlia"
     CURRENT_MAJOR = "dahlia"

stripe/_balance_settings.py

@@ -27,6 +27,20 @@ class BalanceSettings(
 
     class Payments(StripeObject):
         class Payouts(StripeObject):
+            class AutomaticTransferRulesByCurrency(StripeObject):
+                payout_method: str
+                """
+                The ID of the FinancialAccount that funds will be transferred to during automatic transfers.
+                """
+                transfer_up_to_amount: Optional[int]
+                """
+                The maximum amount in minor units to transfer to the FinancialAccount. Only applicable when `type` is `transfer_up_to_amount`.
+                """
+                type: Literal["transfer_all", "transfer_up_to_amount"]
+                """
+                The type of automatic transfer rule.
+                """
+
             class Schedule(StripeObject):
                 interval: Optional[
                     Literal["daily", "manual", "monthly", "weekly"]
@@ -53,6 +67,12 @@ class Schedule(StripeObject):
                 The days of the week when available funds are paid out, specified as an array, for example, [`monday`, `tuesday`]. Only shown if `interval` is weekly.
                 """
 
+            automatic_transfer_rules_by_currency: Optional[
+                UntypedStripeObject[List[AutomaticTransferRulesByCurrency]]
+            ]
+            """
+            Configures per-currency rules for automatically transferring funds from the payments balance to a FinancialAccount.
+            """
             minimum_balance_by_currency: Optional[UntypedStripeObject[int]]
             """
             The minimum balance amount to retain per currency after automatic payouts. Only funds that exceed these amounts are paid out. Learn more about the [minimum balances for automatic payouts](https://docs.stripe.com/payouts/minimum-balances-for-automatic-payouts).
@@ -69,9 +89,27 @@ class Schedule(StripeObject):
             """
             Whether the funds in this account can be paid out.
             """
-            _inner_class_types = {"schedule": Schedule}
+            _inner_class_types = {
+                "automatic_transfer_rules_by_currency": AutomaticTransferRulesByCurrency,
+                "schedule": Schedule,
+            }
+            _inner_class_dicts = ["automatic_transfer_rules_by_currency"]
 
         class SettlementTiming(StripeObject):
+            class StartOfDay(StripeObject):
+                hour: int
+                """
+                Hour at which the customized start of day begins according to the given timezone. Must be a [supported customized start of day hour](https://docs.stripe.com/connect/customized-start-of-day#available-timezones-and-cutoffs).
+                """
+                minutes: int
+                """
+                Minutes at which the customized start of day begins according to the given timezone. Must be either 0 or 30.
+                """
+                timezone: str
+                """
+                Timezone for the customized start of day. Must be a [supported customized start of day timezone](https://docs.stripe.com/connect/customized-start-of-day#available-timezones-and-cutoffs).
+                """
+
             delay_days: int
             """
             The number of days charge funds are held before becoming available.
@@ -80,6 +118,11 @@ class SettlementTiming(StripeObject):
             """
             The number of days charge funds are held before becoming available. If present, overrides the default, or minimum available, for the account.
             """
+            start_of_day: Optional[StartOfDay]
+            """
+            Customized start of day configuration for automatic payouts to group and send payments in local timezones with a customized day starting time. For details, see our [Customized start of day](https://docs.stripe.com/connect/customized-start-of-day) documentation.
+            """
+            _inner_class_types = {"start_of_day": StartOfDay}
 
         debit_negative_balances: Optional[bool]
         """

stripe/_charge.py

@@ -456,6 +456,12 @@ class Billie(StripeObject):
             The Billie transaction ID associated with this payment.
             """
 
+        class Bizum(StripeObject):
+            transaction_id: Optional[str]
+            """
+            The Bizum transaction ID associated with this payment.
+            """
+
         class Blik(StripeObject):
             buyer_id: Optional[str]
             """
@@ -1856,6 +1862,12 @@ class Satispay(StripeObject):
             The Satispay transaction ID associated with this payment.
             """
 
+        class Scalapay(StripeObject):
+            transaction_id: Optional[str]
+            """
+            The Scalapay transaction ID associated with this payment.
+            """
+
         class SepaCreditTransfer(StripeObject):
             bank_name: Optional[str]
             """
@@ -1966,7 +1978,10 @@ class Swish(StripeObject):
             """
 
         class Twint(StripeObject):
-            pass
+            mandate: Optional[str]
+            """
+            ID of the multi use Mandate generated by the PaymentIntent
+            """
 
         class Upi(StripeObject):
             vpa: Optional[str]
@@ -2048,6 +2063,7 @@ class Zip(StripeObject):
         bacs_debit: Optional[BacsDebit]
         bancontact: Optional[Bancontact]
         billie: Optional[Billie]
+        bizum: Optional[Bizum]
         blik: Optional[Blik]
         boleto: Optional[Boleto]
         card: Optional[Card]
@@ -2083,6 +2099,7 @@ class Zip(StripeObject):
         revolut_pay: Optional[RevolutPay]
         samsung_pay: Optional[SamsungPay]
         satispay: Optional[Satispay]
+        scalapay: Optional[Scalapay]
         sepa_credit_transfer: Optional[SepaCreditTransfer]
         sepa_debit: Optional[SepaDebit]
         sofort: Optional[Sofort]
@@ -2114,6 +2131,7 @@ class Zip(StripeObject):
             "bacs_debit": BacsDebit,
             "bancontact": Bancontact,
             "billie": Billie,
+            "bizum": Bizum,
             "blik": Blik,
             "boleto": Boleto,
             "card": Card,
@@ -2149,6 +2167,7 @@ class Zip(StripeObject):
             "revolut_pay": RevolutPay,
             "samsung_pay": SamsungPay,
             "satispay": Satispay,
+            "scalapay": Scalapay,
             "sepa_credit_transfer": SepaCreditTransfer,
             "sepa_debit": SepaDebit,
             "sofort": Sofort,