Update generated code for private-preview (#2106)

* Update generated code (#2088)

* Update generated code for v1865 and 2025-07-30.basil

* Update generated code for v1868 and 2025-07-30.basil

* Update generated code for v1868 and 2025-07-30.basil

---------

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

* Bump version to 82.4.0

* Use Go 1.24 in CI (#2097)

* Bug fixes for `V1BankAccounts` and `V1Cards` services (#2098)

* Add tests

* Add hand-written fixes

* Fixed services

* Add missing parameters to Card and BankAccount services (#2102)

* Add tests

* Add generated code

* Bump version to 82.4.1

* add missing expand param in `get /v1/accounts/{account}/external_accounts` (#2107)

* add missing expand param in v1/external_accounts

* Revert accidential change

* Update generated code (#2101)

* Update generated code for v1882 and 2025-07-30.basil

* Update generated code for v1928 and 2025-08-27.basil

* Update generated code for v1930 and 2025-08-27.basil

* Update generated code for v1931 and 2025-08-27.basil

* Update generated code for v1932 and 2025-08-27.basil

* Update generated code for v1932 and 2025-08-27.basil

---------

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

* Add section on private preview SDKs in readme (#2108)

* Bump version to 82.5.0

* Trigger CI after workflow update

---------

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

Author: 4 people

.github/workflows/ci.yml

@@ -45,7 +45,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.23'
+          go-version: '1.24'
           check-latest: true
       - name: Install govulncheck
         run: go install golang.org/x/vuln/cmd/govulncheck@latest
@@ -57,6 +57,7 @@ jobs:
     strategy:
       matrix:
         go:
+          - "1.24"
           - "1.23"
           - "1.22"
           - "1.21"

API_VERSION

@@ -1 +1 @@
-2025-07-30.preview
+2025-08-27.basil

CHANGELOG.md

@@ -1,10 +1,30 @@
 # Changelog
 
+## 82.5.0 - 2025-08-27
+* [#2108](https://github.com/stripe/stripe-go/pull/2108) Add section on private preview SDKs in readme
+* [#2101](https://github.com/stripe/stripe-go/pull/2101) Update generated code. This release changes the pinned API version to `2025-08-27.basil`.
+  * Add support for `BalanceReport`, `PayoutDetails`, and `PayoutReconciliationReport` on `AccountSessionComponentsParams` and `AccountSessionComponents`
+  * Add support for `Name` on `BillingPortalConfigurationParams` and `BillingPortalConfiguration`
+  * Add support for `Installments` on `ChargePaymentMethodDetailsAlma`
+  * Add support for `TransactionID` on `ChargePaymentMethodDetailsAlma`, `ChargePaymentMethodDetailsAmazonPay`, `ChargePaymentMethodDetailsBillie`, `ChargePaymentMethodDetailsKakaoPay`, `ChargePaymentMethodDetailsKrCard`, `ChargePaymentMethodDetailsNaverPay`, `ChargePaymentMethodDetailsPayco`, `ChargePaymentMethodDetailsRevolutPay`, `ChargePaymentMethodDetailsSamsungPay`, and `ChargePaymentMethodDetailsSatispay`
+  * Add support for `Location` and `Reader` on `ChargePaymentMethodDetailsPaynow`
+  * Add support for `AmountIncludesIof` on `CheckoutSessionPaymentMethodOptionsPixParams`, `CheckoutSessionPaymentMethodOptionsPix`, `PaymentIntentConfirmPaymentMethodOptionsPixParams`, `PaymentIntentPaymentMethodOptionsPixParams`, and `PaymentIntentPaymentMethodOptionsPix`
+  * Add support for new values `block` and `resolution` on enum `DisputePaymentMethodDetailsCard.CaseType`
+  * Add support for new value `terminal_android_apk` on enum `File.Purpose`
+  * Add support for `Metadata` and `Period` on `InvoiceCreatePreviewScheduleDetailsPhaseAddInvoiceItemParams`, `SubscriptionAddInvoiceItemParams`, `SubscriptionSchedulePhaseAddInvoiceItemParams`, and `SubscriptionSchedulePhaseAddInvoiceItem`
+  * Add support for `ExpMonth` and `ExpYear` on `IssuingCardParams`
+  * Add support for `ExcludedPaymentMethodTypes` on `PaymentIntentParams` and `PaymentIntent`
+  * Add support for `PayoutMethod` on `PayoutParams` and `Payout`
+  * Add support for `Mxn` on `TerminalConfigurationTippingParams` and `TerminalConfigurationTipping`
+  * Add support for `Card` on `TestHelpersTerminalReaderPresentPaymentMethodParams`
+  * Add support for error codes `customer_session_expired` and `india_recurring_payment_mandate_canceled` on `Error`, `InvoiceLastFinalizationError`, `PaymentIntentLastPaymentError`, `SetupAttemptSetupError`, `SetupIntentLastSetupError`, and `StripeError`
+* [#2107](https://github.com/stripe/stripe-go/pull/2107) Add support for `Expand` on `BankAccountListParams` and `CardListParams`
+
 ## 82.5.0-beta.2 - 2025-08-08
 * [#2103](https://github.com/stripe/stripe-go/pull/2103) Bring back invoice payments APIs that were missing in the public preview SDKs
    * Add support for new resource `InvoicePayment`
    * Add support for `Get` and `List` methods on resource `InvoicePayment`
-  
+
 ## 82.5.0-beta.1 - 2025-07-30
 This release changes the pinned API version to `2025-07-30.preview`.
 
@@ -33,6 +53,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 `V2PaymentsOffSessionPayment`
 
+## 82.4.1 - 2025-08-11
+* [#2102](https://github.com/stripe/stripe-go/pull/2102) Add missing parameters to Card and BankAccount services
+  * Fixes bugs in `V1Cards` and `V1BankAccounts` services: ensures the new `stripe.Client` pattern supports all parameters previously available in `client.API` for those two services.
+* [#2098](https://github.com/stripe/stripe-go/pull/2098) Bug fixes for `V1BankAccounts` and `V1Cards` services
+  * Fixes bugs in `Create` and `List` methods in `V1BankAccounts` and `V1Cards` services in the `stripe.Client` pattern, which were previously returning errors on any valid inputs.
+
+## 82.4.0 - 2025-07-30
+This release changes the pinned API version to `2025-07-30.basil`.
+
+* [#2088](https://github.com/stripe/stripe-go/pull/2088) Update generated code
+  * Add support for `InstantPayoutsPromotion` on `AccountSessionComponentsParams` and `AccountSessionComponents`
+  * Add support for `AdjustableQuantity` on `BillingPortalConfigurationFeaturesSubscriptionUpdateProductsParams` and `BillingPortalConfigurationFeaturesSubscriptionUpdateProducts`
+  * Remove support for value `disabled` from enum `Capability.Status`
+  * Add support for `TransactionID` on `ChargePaymentMethodDetailsCashapp`
+  * Add support for `OriginContext` on `CheckoutSessionParams` and `CheckoutSession`
+  * Add support for `Template` on `CheckoutSessionInvoiceCreationInvoiceDataRenderingOptionsParams`, `CheckoutSessionInvoiceCreationInvoiceDataRenderingOptions`, `PaymentLinkInvoiceCreationInvoiceDataRenderingOptionsParams`, and `PaymentLinkInvoiceCreationInvoiceDataRenderingOptions`
+  * Add support for `SetupFutureUsage` on `CheckoutSessionPaymentMethodOptionsPixParams` and `CheckoutSessionPaymentMethodOptionsPix`
+  * Add support for `Duration` on `InvoiceCreatePreviewScheduleDetailsPhaseParams` and `SubscriptionSchedulePhaseParams`
+  * Change type of `InvoiceCreatePreviewSubscriptionDetailsParams.CancelAt` and `SubscriptionParams.CancelAt` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
+  * Add support for `PriceData` on `PaymentLinkLineItemParams`
+  * Add support for `Standard` on `TaxRegistrationCountryOptionsAeParams`, `TaxRegistrationCountryOptionsAe`, `TaxRegistrationCountryOptionsAlParams`, `TaxRegistrationCountryOptionsAoParams`, `TaxRegistrationCountryOptionsAuParams`, `TaxRegistrationCountryOptionsAu`, `TaxRegistrationCountryOptionsAwParams`, `TaxRegistrationCountryOptionsBaParams`, `TaxRegistrationCountryOptionsBbParams`, `TaxRegistrationCountryOptionsBdParams`, `TaxRegistrationCountryOptionsBfParams`, `TaxRegistrationCountryOptionsBhParams`, `TaxRegistrationCountryOptionsBsParams`, `TaxRegistrationCountryOptionsCdParams`, `TaxRegistrationCountryOptionsChParams`, `TaxRegistrationCountryOptionsCh`, `TaxRegistrationCountryOptionsEtParams`, `TaxRegistrationCountryOptionsGbParams`, `TaxRegistrationCountryOptionsGb`, `TaxRegistrationCountryOptionsGnParams`, `TaxRegistrationCountryOptionsIsParams`, `TaxRegistrationCountryOptionsJpParams`, `TaxRegistrationCountryOptionsJp`, `TaxRegistrationCountryOptionsMeParams`, `TaxRegistrationCountryOptionsMkParams`, `TaxRegistrationCountryOptionsMrParams`, `TaxRegistrationCountryOptionsNoParams`, `TaxRegistrationCountryOptionsNo`, `TaxRegistrationCountryOptionsNzParams`, `TaxRegistrationCountryOptionsNz`, `TaxRegistrationCountryOptionsOmParams`, `TaxRegistrationCountryOptionsRsParams`, `TaxRegistrationCountryOptionsSgParams`, `TaxRegistrationCountryOptionsSg`, `TaxRegistrationCountryOptionsSrParams`, `TaxRegistrationCountryOptionsUyParams`, `TaxRegistrationCountryOptionsZaParams`, and `TaxRegistrationCountryOptionsZwParams`
+  * Add support for new value `inbound_goods` on enums `TaxRegistrationCountryOptionsAtStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsBeStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsBgStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsCyStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsCzStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsDeStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsDkStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsEeStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsEsStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsFiStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsFrStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsGrStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsHrStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsHuStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsIeStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsItStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsLtStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsLuStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsLvStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsMtStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsNlStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsPlStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsPtStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsRoStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsSeStandard.PlaceOfSupplyScheme`, `TaxRegistrationCountryOptionsSiStandard.PlaceOfSupplyScheme`, and `TaxRegistrationCountryOptionsSkStandard.PlaceOfSupplyScheme`
+  * Add support for `Aed`, `Bgn`, `Huf`, and `Ron` on `TerminalConfigurationTippingParams` and `TerminalConfigurationTipping`
+* [#2086](https://github.com/stripe/stripe-go/pull/2086) update changelog example to feature APIs that are not part of a preview
+
 ## 82.4.0-beta.2 - 2025-07-09
 * [#2084](https://github.com/stripe/stripe-go/pull/2084) Pull in V2 FinancialAccount changes for June release
   * Add support for `Close` and `New` methods on resource `V2MoneyManagementFinancialAccount`
@@ -81,6 +126,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`
 
 ## 82.3.0 - 2025-07-01
+This release changes the pinned API version to `2025-06-30.basil`.
+
 * [#2078](https://github.com/stripe/stripe-go/pull/2078) Update generated code
   * Add support for `Migrate` method on resource `Subscription`
   * Add support for `CollectPaymentMethod` and `ConfirmPaymentIntent` methods on resource `TerminalReader`
@@ -109,7 +156,7 @@ This release changes the pinned API version to `2025-06-30.preview`.
   * Add support for new values `collect_payment_method` and `confirm_payment_intent` on enum `TerminalReaderAction.Type`
   * Add support for `Status` on `TreasuryFinancialAccountListParams`
   * Add support for snapshot event `EventTypeTerminalReaderActionUpdated` with resource `TerminalReader`
-* [#2082](https://github.com/stripe/stripe-go/pull/2082) Add form information to amount
+* [#2082](https://github.com/stripe/stripe-go/pull/2082) Add form information to amount. Fixes a bug on v2 endpoints that uses the amount type
 * [#2076](https://github.com/stripe/stripe-go/pull/2076) Switch to use generated API versions and add major/monthly version constants
   * Export constants for the major and monthly API versions
     * e.g. `2025-05-28.basil` has major version `basil` and monthly version `2025-05-28`

OPENAPI_VERSION

@@ -1 +1 @@
-807a16a9736d4ffa95356bf7651c2eeca326ae6f
+f4b80890ea17e89a543a77a389f29ca9be6fe615

README.md

@@ -490,7 +490,7 @@ func UseMockedStripeClient(t *testing.T) {
 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 `82.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-go/releases/) and use it in your `go.mod` file:
+To install, pick the latest version with the `beta` suffix by reviewing the [releases page](https://github.com/stripe/stripe-go/releases/) and use it in your `go.mod` file:
 
 ```
 require (
@@ -508,6 +508,9 @@ Some preview features require a name and version to be set in the `Stripe-Versio
 ```go
 stripe.AddBetaVersion("feature_beta", "v3")
 ```
+### 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 `82.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-go?tab=readme-ov-file#public-preview-sdks) above and replacing the term `beta` with `alpha`.
 
 ### Custom Request
 

account.go

@@ -4193,13 +4193,13 @@ type AccountCompanyRegistrationDate struct {
 	Year int64 `json:"year"`
 }
 type AccountCompanyVerificationDocument struct {
-	// 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).
 	Back *File `json:"back"`
 	// A user-displayable string describing the verification state of this document.
 	Details string `json:"details"`
 	// One of `document_corrupt`, `document_expired`, `document_failed_copy`, `document_failed_greyscale`, `document_failed_other`, `document_failed_test_mode`, `document_fraudulent`, `document_incomplete`, `document_invalid`, `document_manipulated`, `document_not_readable`, `document_not_uploaded`, `document_type_not_supported`, or `document_too_large`. A machine-readable code specifying the verification state for this document.
 	DetailsCode AccountCompanyVerificationDocumentDetailsCode `json:"details_code"`
-	// 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).
 	Front *File `json:"front"`
 }