Update generated code for private-preview (#1552)

* Update generated code for v1868 and 2025-07-30.basil (#1541)

Co-authored-by: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com>

* Bump version to 12.4.0

* Introduce V1 namespaces in StripeClient (#1549)

* Introduced V1 namespaces

* Updated migration guide link

* Import available http libraries more efficiently (#1553)

* replace import stragety, fix some tests

[skip ci]

* wip fixing tests

[skip ci]

* [claude] fix tests

* formatting

* test cleanup

* tests are fast

* final cleanup

* remove comment

* remove accidential files

* tweak import logic

* Update generated code for v1932 and 2025-08-27.basil (#1544)

Co-authored-by: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com>
Co-authored-by: Ramya Rao <[email protected]>

* Trigger CI after workflow update

* removed manually maintained RateLimitError class as this is now generated

* added private-preview to workflow triggers

* removed duplicate ratelimit import

---------

Co-authored-by: stripe-openapi[bot] <105521251+stripe-openapi[bot]@users.noreply.github.com>
Co-authored-by: Ramya Rao <[email protected]>
Co-authored-by: prathmesh-stripe <[email protected]>
Co-authored-by: David Brownman <[email protected]>
Co-authored-by: Ramya Rao <[email protected]>
Co-authored-by: Michael Broshi <[email protected]>
Co-authored-by: Jesse Rosalia <[email protected]>

Author: 6 people

.github/workflows/ci.yml

@@ -6,6 +6,7 @@ on:
     branches:
       - master
       - beta
+      - private-preview
       - sdk-release/**
       - feature/**
     tags:
@@ -14,6 +15,7 @@ on:
     branches:
       - master
       - beta
+      - private-preview
       - sdk-release/**
       - feature/**
 

CHANGELOG.md

@@ -33,6 +33,31 @@ This release changes the pinned API version to `2025-07-30.preview`.
   * Remove support for thin event `V2CoreAccountLinkCompletedEvent`
   * Remove support for thin event `V2OffSessionPaymentRequiresCaptureEvent` with related object `v2.payments.OffSessionPayment`
 
+## 12.4.0 - 2025-07-30
+This release changes the pinned API version to `2025-07-30.basil`.
+
+* [#1541](https://github.com/stripe/stripe-python/pull/1541) Update generated code
+  * Add support for `instant_payouts_promotion` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
+  * Add support for `adjustable_quantity` on `BillingPortal.Configuration.Feature.SubscriptionUpdate.Product`, `billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdateProduct`, and `billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdateProduct`
+  * Remove support for value `disabled` from enum `Capability.status`
+  * Add support for `transaction_id` on `Charge.PaymentMethodDetail.Cashapp`
+  * Add support for `origin_context` on `Checkout.Session` and `checkout.Session.CreateParams`
+  * Add support for `template` on `Checkout.Session.InvoiceCreation.InvoiceDatum.RenderingOption`, `PaymentLink.CreateParamsInvoiceCreationInvoiceDatumRenderingOption`, `PaymentLink.InvoiceCreation.InvoiceDatum.RenderingOption`, `PaymentLink.ModifyParamsInvoiceCreationInvoiceDatumRenderingOption`, and `checkout.Session.CreateParamsInvoiceCreationInvoiceDatumRenderingOption`
+  * Add support for `setup_future_usage` on `Checkout.Session.PaymentMethodOption.Pix` and `checkout.Session.CreateParamsPaymentMethodOptionPix`
+  * Add support for new value `nz_bank_account` on enum `checkout.Session.CreateParams.payment_method_types`
+  * Change `Identity.VerificationSession.RelatedPerson.account` to be required
+  * Change `Identity.VerificationSession.RelatedPerson.person` to be required
+  * Add support for `duration` on `Invoice.CreatePreviewParamsScheduleDetailPhase`, `SubscriptionSchedule.CreateParamsPhase`, and `SubscriptionSchedule.ModifyParamsPhase`
+  * Change type of `Invoice.CreatePreviewParamsSubscriptionDetail.cancel_at`, `Subscription.CreateParams.cancel_at`, and `Subscription.ModifyParams.cancel_at` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
+  * Add support for `price_data` on `PaymentLink.CreateParamsLineItem`
+  * Change `PaymentLink.CreateParamsLineItem.price` to be optional
+  * Add support for new value `America/Coyhaique` on enum `reporting.ReportRun.CreateParamsParameter.timezone`
+  * Add support for `standard` on `Tax.Registration.CountryOption.Ae`, `Tax.Registration.CountryOption.Au`, `Tax.Registration.CountryOption.Ch`, `Tax.Registration.CountryOption.Gb`, `Tax.Registration.CountryOption.Jp`, `Tax.Registration.CountryOption.No`, `Tax.Registration.CountryOption.Nz`, `Tax.Registration.CountryOption.Sg`, `tax.Registration.CreateParamsCountryOptionAe`, `tax.Registration.CreateParamsCountryOptionAl`, `tax.Registration.CreateParamsCountryOptionAo`, `tax.Registration.CreateParamsCountryOptionAu`, `tax.Registration.CreateParamsCountryOptionAw`, `tax.Registration.CreateParamsCountryOptionB`, `tax.Registration.CreateParamsCountryOptionBa`, `tax.Registration.CreateParamsCountryOptionBb`, `tax.Registration.CreateParamsCountryOptionBd`, `tax.Registration.CreateParamsCountryOptionBf`, `tax.Registration.CreateParamsCountryOptionBh`, `tax.Registration.CreateParamsCountryOptionCd`, `tax.Registration.CreateParamsCountryOptionCh`, `tax.Registration.CreateParamsCountryOptionEt`, `tax.Registration.CreateParamsCountryOptionGb`, `tax.Registration.CreateParamsCountryOptionGn`, `tax.Registration.CreateParamsCountryOptionIs`, `tax.Registration.CreateParamsCountryOptionJp`, `tax.Registration.CreateParamsCountryOptionMe`, `tax.Registration.CreateParamsCountryOptionMk`, `tax.Registration.CreateParamsCountryOptionMr`, `tax.Registration.CreateParamsCountryOptionNo`, `tax.Registration.CreateParamsCountryOptionNz`, `tax.Registration.CreateParamsCountryOptionOm`, `tax.Registration.CreateParamsCountryOptionR`, `tax.Registration.CreateParamsCountryOptionSg`, `tax.Registration.CreateParamsCountryOptionSr`, `tax.Registration.CreateParamsCountryOptionUy`, `tax.Registration.CreateParamsCountryOptionZa`, and `tax.Registration.CreateParamsCountryOptionZw`
+  * Add support for new value `inbound_goods` on enums `Tax.Registration.CountryOption.At.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Be.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Bg.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Cy.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Cz.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.De.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Dk.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.E.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ee.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Fi.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Fr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Gr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Hr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Hu.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ie.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.It.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lu.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lv.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Mt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Nl.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Pl.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Pt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ro.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Se.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Si.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Sk.Standard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionAtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionBeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionBgStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionCyStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionCzStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionDeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionDkStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionEStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionEeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionFiStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionFrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionGrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionHrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionHuStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionIeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionItStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLuStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLvStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionMtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionNlStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionPlStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionPtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionRoStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionSeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionSiStandard.place_of_supply_scheme`, and `tax.Registration.CreateParamsCountryOptionSkStandard.place_of_supply_scheme`
+  * Add support for `aed`, `bgn`, `huf`, and `ron` on `Terminal.Configuration.Tipping`, `terminal.Configuration.CreateParamsTipping`, and `terminal.Configuration.ModifyParamsTipping`
+  * Add support for new value `2025-07-30.basil` on enum `WebhookEndpoint.CreateParams.api_version`
+* [#1537](https://github.com/stripe/stripe-python/pull/1537) Fix timeout type hint in RequestsClient
+
 ## 12.4.0b2 - 2025-07-09
 * [#1536](https://github.com/stripe/stripe-python/pull/1536) Pull in V2 FinancialAccount changes for June release
   * Add support for `close` and `create` methods on resource `v2.money_management.FinancialAccount`
@@ -86,6 +111,8 @@ This release changes the pinned API version to `2025-06-30.preview`.
   * Remove support for error code `outbound_payment_recipient_email_does_not_exist` on `RecipientNotNotifiableError`
 
 ## 12.3.0 - 2025-07-01
+This release changes the pinned API version to `2025-06-30.basil`.
+
 * [#1526](https://github.com/stripe/stripe-python/pull/1526) Update generated code
   * Add support for `migrate` method on resource `Subscription`
   * Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `terminal.Reader`
@@ -121,9 +148,6 @@ This release changes the pinned API version to `2025-06-30.preview`.
   * Add support for new value `2025-06-30.basil` on enum `WebhookEndpoint.CreateParams.api_version`
   * Add support for snapshot event `terminal.reader.action_updated` with resource `terminal.Reader`
 * [#1534](https://github.com/stripe/stripe-python/pull/1534) Fix the link to releases page from readme
-* [#1532](https://github.com/stripe/stripe-python/pull/1532) Added lint ignore instruction for deprecated import
-* [#1524](https://github.com/stripe/stripe-python/pull/1524) Added import for the new deprecated services in stripe_client
-* [#1522](https://github.com/stripe/stripe-python/pull/1522) Add a new deprecated v1 services section
 
 ## 12.3.0b2 - 2025-06-26
 * [#1531](https://github.com/stripe/stripe-python/pull/1531) Pull in OffSessionPayment changes for the May release

OPENAPI_VERSION

@@ -1 +1 @@
-807a16a9736d4ffa95356bf7651c2eeca326ae6f
+84693dc4f6a999082c29261d9db6dcfe1c76dd8d

justfile

@@ -10,9 +10,10 @@ _default:
     just --list --unsorted
 
 # ⭐ run all unit tests
+[positional-arguments]
 test *args: install-test-deps
     # configured in pyproject.toml
-    pytest {{ args }}
+    pytest "$@"
 
 # ⭐ check for potential mistakes
 lint: install-dev-deps

stripe/__init__.py

@@ -224,7 +224,6 @@ def add_beta_version(
 from stripe._error import InvalidRequestError as InvalidRequestError
 from stripe._error import AuthenticationError as AuthenticationError
 from stripe._error import PermissionError as PermissionError
-from stripe._error import RateLimitError as RateLimitError
 from stripe._error import (
     SignatureVerificationError as SignatureVerificationError,
 )
@@ -493,6 +492,9 @@ def __getattr__(name):
     InvoiceLineItemService as InvoiceLineItemService,
 )
 from stripe._invoice_payment import InvoicePayment as InvoicePayment
+from stripe._invoice_payment_service import (
+    InvoicePaymentService as InvoicePaymentService,
+)
 from stripe._invoice_rendering_template import (
     InvoiceRenderingTemplate as InvoiceRenderingTemplate,
 )
@@ -665,6 +667,7 @@ def __getattr__(name):
 )
 from stripe._transfer_service import TransferService as TransferService
 from stripe._treasury_service import TreasuryService as TreasuryService
+from stripe._v1_services import V1Services as V1Services
 from stripe._v2_services import V2Services as V2Services
 from stripe._webhook_endpoint import WebhookEndpoint as WebhookEndpoint
 from stripe._webhook_endpoint_service import (

stripe/_account.py

@@ -642,7 +642,7 @@ class Verification(StripeObject):
             class Document(StripeObject):
                 back: Optional[ExpandableField["File"]]
                 """
-                The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`.
+                The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](https://docs.stripe.com/file-upload#uploading-a-file).
                 """
                 details: Optional[str]
                 """
@@ -654,7 +654,7 @@ class Document(StripeObject):
                 """
                 front: Optional[ExpandableField["File"]]
                 """
-                The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`.
+                The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](https://docs.stripe.com/file-upload#uploading-a-file).
                 """
 
             document: Document