stripe · stripe-openapi · Jul 30, 2025 · Jul 29, 2025
@@ -1 +1 @@
-2025-06-30.basil
+2025-07-30.basil
@@ -1 +1 @@
-v1819
+v1868
@@ -132,7 +132,7 @@ class SupportAddress(StripeObject):
             ]
         ]
         """
-        Whether the business is a minority-owned, women-owned, and/or LGBTQI+-owned business.
+        Whether the business is a minority-owned, women-owned, and/or LGBTQI+ -owned business.
         """
         monthly_estimated_revenue: Optional[MonthlyEstimatedRevenue]
         name: Optional[str]
@@ -1561,7 +1561,7 @@ class CreateParamsBusinessProfile(TypedDict):
             ]
         ]
         """
-        Whether the business is a minority-owned, women-owned, and/or LGBTQI+-owned business.
+        Whether the business is a minority-owned, women-owned, and/or LGBTQI+ -owned business.
         """
         monthly_estimated_revenue: NotRequired[
             "Account.CreateParamsBusinessProfileMonthlyEstimatedRevenue"
@@ -4628,7 +4628,7 @@ def _cls_delete(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4652,7 +4652,7 @@ def delete(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4665,7 +4665,7 @@ def delete(self, **params: Unpack["Account.DeleteParams"]) -> "Account":
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4680,7 +4680,7 @@ def delete(  # pyright: ignore[reportGeneralTypeIssues]
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4699,7 +4699,7 @@ async def _cls_delete_async(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4723,7 +4723,7 @@ async def delete_async(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4738,7 +4738,7 @@ async def delete_async(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -4753,7 +4753,7 @@ async def delete_async(  # pyright: ignore[reportGeneralTypeIssues]
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """

@@ -45,7 +45,9 @@ class CreateParams(RequestOptions):
         """
         type: Literal["account_onboarding", "account_update"]
         """
-        The type of account link the user is requesting. Possible values are `account_onboarding` or `account_update`.
+        The type of account link the user is requesting.
+
+        You can create Account Links of type `account_update` only for connected accounts where your platform is responsible for collecting requirements, including Custom accounts. You can't create them for accounts that have access to a Stripe-hosted Dashboard. If you use [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components), you can include components that allow your connected accounts to update their own information. For an account without Stripe-hosted Dashboard access where Stripe is liable for negative balances, you must use embedded components.
         """
 
     class CreateParamsCollectionOptions(TypedDict):

@@ -37,7 +37,9 @@ class CreateParams(TypedDict):
         """
         type: Literal["account_onboarding", "account_update"]
         """
-        The type of account link the user is requesting. Possible values are `account_onboarding` or `account_update`.
+        The type of account link the user is requesting.
+
+        You can create Account Links of type `account_update` only for connected accounts where your platform is responsible for collecting requirements, including Custom accounts. You can't create them for accounts that have access to a Stripe-hosted Dashboard. If you use [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components), you can include components that allow your connected accounts to update their own information. For an account without Stripe-hosted Dashboard access where Stripe is liable for negative balances, you must use embedded components.
         """
 
     class CreateParamsCollectionOptions(TypedDict):

@@ -166,7 +166,7 @@ class CreateParamsBusinessProfile(TypedDict):
             ]
         ]
         """
-        Whether the business is a minority-owned, women-owned, and/or LGBTQI+-owned business.
+        Whether the business is a minority-owned, women-owned, and/or LGBTQI+ -owned business.
         """
         monthly_estimated_revenue: NotRequired[
             "AccountService.CreateParamsBusinessProfileMonthlyEstimatedRevenue"
@@ -2122,7 +2122,7 @@ class UpdateParamsBusinessProfile(TypedDict):
             ]
         ]
         """
-        Whether the business is a minority-owned, women-owned, and/or LGBTQI+-owned business.
+        Whether the business is a minority-owned, women-owned, and/or LGBTQI+ -owned business.
         """
         monthly_estimated_revenue: NotRequired[
             "AccountService.UpdateParamsBusinessProfileMonthlyEstimatedRevenue"
@@ -3856,7 +3856,7 @@ def delete(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """
@@ -3882,7 +3882,7 @@ async def delete_async(
 
         Test-mode accounts can be deleted at any time.
 
-        Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
+        Live-mode accounts that have access to the standard dashboard and Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. All other Live-mode accounts, can be deleted when all [balances](https://docs.stripe.com/api/balance/balance_object) are zero.
 
         If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead.
         """

@@ -164,6 +164,28 @@ class Features(StripeObject):
             features: Features
             _inner_class_types = {"features": Features}
 
+        class InstantPayoutsPromotion(StripeObject):
+            class Features(StripeObject):
+                disable_stripe_user_authentication: bool
+                """
+                Whether Stripe user authentication is disabled. This value can only be `true` for accounts where `controller.requirement_collection` is `application` for the account. The default value is the opposite of the `external_account_collection` value. For example, if you don't set `external_account_collection`, it defaults to `true` and `disable_stripe_user_authentication` defaults to `false`.
+                """
+                external_account_collection: bool
+                """
+                Whether external account collection is enabled. This feature can only be `false` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
+                """
+                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`.
+                """
+
+            enabled: bool
+            """
+            Whether the embedded component is enabled.
+            """
+            features: Features
+            _inner_class_types = {"features": Features}
+
         class IssuingCard(StripeObject):
             class Features(StripeObject):
                 card_management: bool
@@ -382,6 +404,7 @@ class Features(StripeObject):
         documents: Documents
         financial_account: FinancialAccount
         financial_account_transactions: FinancialAccountTransactions
+        instant_payouts_promotion: InstantPayoutsPromotion
         issuing_card: IssuingCard
         issuing_cards_list: IssuingCardsList
         notification_banner: NotificationBanner
@@ -400,6 +423,7 @@ class Features(StripeObject):
             "documents": Documents,
             "financial_account": FinancialAccount,
             "financial_account_transactions": FinancialAccountTransactions,
+            "instant_payouts_promotion": InstantPayoutsPromotion,
             "issuing_card": IssuingCard,
             "issuing_cards_list": IssuingCardsList,
             "notification_banner": NotificationBanner,
@@ -467,6 +491,12 @@ class CreateParamsComponents(TypedDict):
         """
         Configuration for the [financial account transactions](https://docs.stripe.com/connect/supported-embedded-components/financial-account-transactions/) embedded component.
         """
+        instant_payouts_promotion: NotRequired[
+            "AccountSession.CreateParamsComponentsInstantPayoutsPromotion"
+        ]
+        """
+        Configuration for the [instant payouts promotion](https://docs.stripe.com/connect/supported-embedded-components/instant-payouts-promotion/) embedded component.
+        """
         issuing_card: NotRequired[
             "AccountSession.CreateParamsComponentsIssuingCard"
         ]
@@ -697,6 +727,32 @@ class CreateParamsComponentsFinancialAccountTransactionsFeatures(
         Whether to allow card spend dispute management features.
         """
 
+    class CreateParamsComponentsInstantPayoutsPromotion(TypedDict):
+        enabled: bool
+        """
+        Whether the embedded component is enabled.
+        """
+        features: NotRequired[
+            "AccountSession.CreateParamsComponentsInstantPayoutsPromotionFeatures"
+        ]
+        """
+        The list of features enabled in the embedded component.
+        """
+
+    class CreateParamsComponentsInstantPayoutsPromotionFeatures(TypedDict):
+        disable_stripe_user_authentication: NotRequired[bool]
+        """
+        Whether Stripe user authentication is disabled. This value can only be `true` for accounts where `controller.requirement_collection` is `application` for the account. The default value is the opposite of the `external_account_collection` value. For example, if you don't set `external_account_collection`, it defaults to `true` and `disable_stripe_user_authentication` defaults to `false`.
+        """
+        external_account_collection: NotRequired[bool]
+        """
+        Whether external account collection is enabled. This feature can only be `false` for accounts where you're responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
+        """
+        instant_payouts: NotRequired[bool]
+        """
+        Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+        """
+
     class CreateParamsComponentsIssuingCard(TypedDict):
         enabled: bool
         """