Update generated code for beta

.github/workflows/ci.yml

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

API_VERSION

@@ -1 +1 @@
-2025-08-27.preview
+2025-09-30.preview

CHANGELOG.md

@@ -31,6 +31,22 @@ This release changes the pinned API version to `2025-08-27.preview`.
   * Add support for `PixDisplayQrCode` on `SetupIntent.NextAction`
   * Add support for `ReaderSecurity` on `Terminal.ConfigurationCreateOptions`, `Terminal.ConfigurationUpdateOptions`, and `Terminal.Configuration`
 
+## 48.5.0 - 2025-08-27
+* [#3164](https://github.com/stripe/stripe-dotnet/pull/3164) Add section on private preview SDKs in readme
+* [#3159](https://github.com/stripe/stripe-dotnet/pull/3159) Update generated code. This release changes the pinned API version to `2025-08-27.basil`.
+  * Add support for `BalanceReport`, `PayoutDetails`, and `PayoutReconciliationReport` on `AccountSession.Components` and `AccountSessionComponentsOptions`
+  * Add support for `Name` on `BillingPortal.ConfigurationCreateOptions`, `BillingPortal.ConfigurationUpdateOptions`, and `BillingPortal.Configuration`
+  * Add support for `Installments` on `Charge.PaymentMethodDetails.Alma`
+  * Add support for `TransactionId` on `Charge.PaymentMethodDetails.Alma`, `Charge.PaymentMethodDetails.AmazonPay`, `Charge.PaymentMethodDetails.Billie`, `Charge.PaymentMethodDetails.KakaoPay`, `Charge.PaymentMethodDetails.KrCard`, `Charge.PaymentMethodDetails.NaverPay`, `Charge.PaymentMethodDetails.Payco`, `Charge.PaymentMethodDetails.RevolutPay`, `Charge.PaymentMethodDetails.SamsungPay`, and `Charge.PaymentMethodDetails.Satispay`
+  * Add support for `Location` and `Reader` on `Charge.PaymentMethodDetails.Paynow`
+  * Add support for `AmountIncludesIof` on `Checkout.Session.PaymentMethodOptions.Pix`, `CheckoutSessionPaymentMethodOptionsPixOptions`, `PaymentIntent.PaymentMethodOptions.Pix`, and `PaymentIntentPaymentMethodOptionsPixOptions`
+  * Add support for `Metadata` and `Period` on `InvoiceScheduleDetailsPhaseAddInvoiceItemOptions`, `SubscriptionAddInvoiceItemOptions`, `SubscriptionSchedule.Phase.AddInvoiceItem`, and `SubscriptionSchedulePhaseAddInvoiceItemOptions`
+  * Add support for `ExpMonth` and `ExpYear` on `Issuing.CardCreateOptions`
+  * Add support for `ExcludedPaymentMethodTypes` on `PaymentIntentCreateOptions` and `PaymentIntent`
+  * Add support for `PayoutMethod` on `PayoutCreateOptions` and `Payout`
+  * Add support for `Mxn` on `Terminal.Configuration.Tipping` and `TerminalConfigurationTippingOptions`
+  * Add support for `Card` on `Terminal.TestHelpersReaderPresentPaymentMethodOptions`
+
 ## 48.5.0-beta.2 - 2025-08-08
 * [#3160](https://github.com/stripe/stripe-dotnet/pull/3160) Bring back invoice payments APIs that were missing in the public preview SDKs
     * Add support for new resource `InvoicePayment`

OPENAPI_VERSION

@@ -1 +1 @@
-v1932
+v2020

README.md

@@ -45,7 +45,7 @@ how to use the library.
 
 ### Using StripeClient
 
-In version 46 of the Stripe .NET SDK, we have enhanced the `StripeClient` class to be the entry point to access all services that had to be previously independently instantiated with global configuration. This improves discoverability during IDE auto-completion and creates a more intuitive developer experience for you. 
+In version 46 of the Stripe .NET SDK, we have enhanced the `StripeClient` class to be the entry point to access all services that had to be previously independently instantiated with global configuration. This improves discoverability during IDE auto-completion and creates a more intuitive developer experience for you.
 
 Each client instantiation can have its own configuration so you can access Stripe API with different API keys or different configuration (like number of retries) on a per client basis and without changing a global configuration.
 
@@ -335,7 +335,7 @@ The [RawJObject property](#properties) is ignored on serialization in both Json.
 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 `45.1.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-dotnet/releases/) and then use it in the version parameter with `dotnet add package` command:
+To install, pick the latest version with the `beta` suffix by reviewing the [releases page](https://github.com/stripe/stripe-dotnet/releases/) and then use it in the version parameter with `dotnet add package` command:
 
 ```
 dotnet add package Stripe.net --version <replace-with-the-version-of-your-choice>
@@ -349,6 +349,9 @@ Some preview features require a name and version to be set in the `Stripe-Versio
 ```csharp
 StripeConfiguration.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 `45.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-dotnet?tab=readme-ov-file#public-preview-sdks) above and replacing the term `beta` with `alpha`.
 
 ### Custom requests
 

justfile

@@ -20,7 +20,7 @@ ci-test: (_test "--no-build" "" "Release")
 # ⭐ format all files
 format *args:
     # This sets TargetFramework because of a race condition in dotnet format when it tries to format to multiple targets at a time, which could lead to code with compiler errors after it completes
-    TargetFramework=net5.0 dotnet format src/Stripe.net/Stripe.net.csproj --severity warn {{args}}
+    TargetFramework=net5.0 dotnet format src/Stripe.net.sln --severity warn {{args}}
 
 # verify, but don't modify, the project's formatting
 format-check: (format "--verify-no-changes")

src/Examples/Program.cs

@@ -27,7 +27,7 @@ public Program()
         /// are set before running the example.
         ///
         /// </summary>
-        /// <param name="args">command line args</param>
+        /// <param name="args">command line args.</param>
         /// <returns></returns>
         public static async Task Main(string[] args)
         {

src/Examples/V2/ThinEventWebhookHandler.cs

@@ -22,15 +22,15 @@
     [ApiController]
     public class ThinEventWebhookHandler : ControllerBase
     {
-        private readonly StripeClient _client;
-        private readonly string _webhookSecret;
+        private readonly StripeClient client;
+        private readonly string webhookSecret;
 
         public ThinEventWebhookHandler()
         {
             var apiKey = Environment.GetEnvironmentVariable("STRIPE_API_KEY");
-            _client = new StripeClient(apiKey);
+            client = new StripeClient(apiKey);
 
-            _webhookSecret = Environment.GetEnvironmentVariable("WEBHOOK_SECRET");
+            webhookSecret = Environment.GetEnvironmentVariable("WEBHOOK_SECRET");
         }
 
         [HttpPost]
@@ -39,10 +39,10 @@
             var json = await new StreamReader(HttpContext.Request.Body).ReadToEndAsync();
             try
             {
-                var thinEvent = _client.ParseThinEvent(json, Request.Headers["Stripe-Signature"], _webhookSecret);
+                var thinEvent = client.ParseThinEvent(json, Request.Headers["Stripe-Signature"], webhookSecret);
 
                 // Fetch the event data to understand the failure
-                var baseEvent = await _client.V2.Core.Events.GetAsync(thinEvent.Id);
+                var baseEvent = await client.V2.Core.Events.GetAsync(thinEvent.Id);
                 if (baseEvent is V1BillingMeterErrorReportTriggeredEvent fullEvent)
                 {
                     var meter = await fullEvent.FetchRelatedObjectAsync();

src/Stripe.net/Constants/ApiVersion.cs

@@ -3,6 +3,6 @@ namespace Stripe
 {
     internal class ApiVersion
     {
-        public const string Current = "2025-08-27.preview";
+        public const string Current = "2025-09-30.preview";
     }
 }

src/Stripe.net/Entities/Accounts/AccountCapabilities.cs

@@ -533,6 +533,17 @@ public class AccountCapabilities : StripeEntity<AccountCapabilities>
 #endif
         public string PaypalPayments { get; set; }
 
+        /// <summary>
+        /// The status of the Paypay capability of the account, or whether the account can directly
+        /// process Paypay payments.
+        /// One of: <c>active</c>, <c>inactive</c>, or <c>pending</c>.
+        /// </summary>
+        [JsonProperty("paypay_payments")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("paypay_payments")]
+#endif
+        public string PaypayPayments { get; set; }
+
         /// <summary>
         /// The status of the PayTo capability of the account, or whether the account can directly
         /// process PayTo charges.

src/Stripe.net/Entities/Accounts/AccountFutureRequirementsError.cs

@@ -10,7 +10,8 @@ public class AccountFutureRequirementsError : StripeEntity<AccountFutureRequirem
     {
         /// <summary>
         /// The code for the type of error.
-        /// One of: <c>information_missing</c>, <c>invalid_address_city_state_postal_code</c>,
+        /// One of: <c>external_request</c>, <c>information_missing</c>,
+        /// <c>invalid_address_city_state_postal_code</c>,
         /// <c>invalid_address_highway_contract_box</c>, <c>invalid_address_private_mailbox</c>,
         /// <c>invalid_business_profile_name</c>, <c>invalid_business_profile_name_denylisted</c>,
         /// <c>invalid_company_name_denylisted</c>, <c>invalid_dob_age_over_maximum</c>,
@@ -38,7 +39,8 @@ public class AccountFutureRequirementsError : StripeEntity<AccountFutureRequirem
         /// <c>invalid_url_website_incomplete_terms_and_conditions</c>,
         /// <c>invalid_url_website_incomplete_under_construction</c>,
         /// <c>invalid_url_website_other</c>, <c>invalid_value_other</c>,
-        /// <c>verification_directors_mismatch</c>, <c>verification_document_address_mismatch</c>,
+        /// <c>unsupported_business_type</c>, <c>verification_directors_mismatch</c>,
+        /// <c>verification_document_address_mismatch</c>,
         /// <c>verification_document_address_missing</c>, <c>verification_document_corrupt</c>,
         /// <c>verification_document_country_not_supported</c>,
         /// <c>verification_document_directors_mismatch</c>,

src/Stripe.net/Entities/Accounts/AccountRequirementsError.cs

@@ -10,7 +10,8 @@ public class AccountRequirementsError : StripeEntity<AccountRequirementsError>
     {
         /// <summary>
         /// The code for the type of error.
-        /// One of: <c>information_missing</c>, <c>invalid_address_city_state_postal_code</c>,
+        /// One of: <c>external_request</c>, <c>information_missing</c>,
+        /// <c>invalid_address_city_state_postal_code</c>,
         /// <c>invalid_address_highway_contract_box</c>, <c>invalid_address_private_mailbox</c>,
         /// <c>invalid_business_profile_name</c>, <c>invalid_business_profile_name_denylisted</c>,
         /// <c>invalid_company_name_denylisted</c>, <c>invalid_dob_age_over_maximum</c>,
@@ -38,7 +39,8 @@ public class AccountRequirementsError : StripeEntity<AccountRequirementsError>
         /// <c>invalid_url_website_incomplete_terms_and_conditions</c>,
         /// <c>invalid_url_website_incomplete_under_construction</c>,
         /// <c>invalid_url_website_other</c>, <c>invalid_value_other</c>,
-        /// <c>verification_directors_mismatch</c>, <c>verification_document_address_mismatch</c>,
+        /// <c>unsupported_business_type</c>, <c>verification_directors_mismatch</c>,
+        /// <c>verification_document_address_mismatch</c>,
         /// <c>verification_document_address_missing</c>, <c>verification_document_corrupt</c>,
         /// <c>verification_document_country_not_supported</c>,
         /// <c>verification_document_directors_mismatch</c>,

src/Stripe.net/Entities/Accounts/AccountSettingsPayoutsSchedule.cs

@@ -63,8 +63,8 @@ public class AccountSettingsPayoutsSchedule : StripeEntity<AccountSettingsPayout
         /// <summary>
         /// The days of the week when available funds are paid out, specified as an array, for
         /// example, [<c>monday</c>, <c>tuesday</c>]. Only shown if <c>interval</c> is weekly.
-        /// One of: <c>friday</c>, <c>monday</c>, <c>saturday</c>, <c>sunday</c>, <c>thursday</c>,
-        /// <c>tuesday</c>, or <c>wednesday</c>.
+        /// One of: <c>friday</c>, <c>monday</c>, <c>thursday</c>, <c>tuesday</c>, or
+        /// <c>wednesday</c>.
         /// </summary>
         [JsonProperty("weekly_payout_days")]
 #if NET6_0_OR_GREATER

src/Stripe.net/Entities/BalanceSettings/BalanceSettings.cs

@@ -9,11 +9,6 @@ namespace Stripe
     /// <summary>
     /// Options for customizing account balances and payout settings for a Stripe platform’s
     /// connected accounts.
-    ///
-    /// This API is only available for users enrolled in the public preview for Accounts v2 on
-    /// Stripe Connect. If you are not in this preview, please use the <a
-    /// href="https://docs.stripe.com/api/accounts?api-version=2025-03-31.basil">Accounts v1
-    /// API</a> to manage your connected accounts’ balance settings instead.
     /// </summary>
     public class BalanceSettings : StripeEntity<BalanceSettings>, IHasObject
     {

src/Stripe.net/Entities/BalanceSettings/BalanceSettingsPaymentsPayouts.cs

@@ -1,13 +1,26 @@
 // File generated from our OpenAPI spec
 namespace Stripe
 {
+    using System.Collections.Generic;
     using Newtonsoft.Json;
 #if NET6_0_OR_GREATER
     using STJS = System.Text.Json.Serialization;
 #endif
 
     public class BalanceSettingsPaymentsPayouts : StripeEntity<BalanceSettingsPaymentsPayouts>
     {
+        /// <summary>
+        /// The minimum balance amount to retain per currency after automatic payouts. Only funds
+        /// that exceed these amounts are paid out. Learn more about the <a
+        /// href="https://stripe.com/payouts/minimum-balances-for-automatic-payouts">minimum
+        /// balances for automatic payouts</a>.
+        /// </summary>
+        [JsonProperty("minimum_balance_by_currency")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("minimum_balance_by_currency")]
+#endif
+        public Dictionary<string, long> MinimumBalanceByCurrency { get; set; }
+
         /// <summary>
         /// Details on when funds from charges are available, and when they are paid out to an
         /// external account. See our <a

src/Stripe.net/Entities/BalanceSettings/BalanceSettingsPaymentsPayoutsSchedule.cs

@@ -34,8 +34,8 @@ public class BalanceSettingsPaymentsPayoutsSchedule : StripeEntity<BalanceSettin
         /// <summary>
         /// The days of the week when available funds are paid out, specified as an array, for
         /// example, [<c>monday</c>, <c>tuesday</c>]. Only shown if <c>interval</c> is weekly.
-        /// One of: <c>friday</c>, <c>monday</c>, <c>saturday</c>, <c>sunday</c>, <c>thursday</c>,
-        /// <c>tuesday</c>, or <c>wednesday</c>.
+        /// One of: <c>friday</c>, <c>monday</c>, <c>thursday</c>, <c>tuesday</c>, or
+        /// <c>wednesday</c>.
         /// </summary>
         [JsonProperty("weekly_payout_days")]
 #if NET6_0_OR_GREATER

src/Stripe.net/Entities/BalanceSettings/BalanceSettingsPaymentsSettlementTiming.cs

@@ -16,5 +16,15 @@ public class BalanceSettingsPaymentsSettlementTiming : StripeEntity<BalanceSetti
         [STJS.JsonPropertyName("delay_days")]
 #endif
         public long DelayDays { get; set; }
+
+        /// <summary>
+        /// The number of days charge funds are held before becoming available. If present,
+        /// overrides the default, or minimum available, for the account.
+        /// </summary>
+        [JsonProperty("delay_days_override")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("delay_days_override")]
+#endif
+        public long DelayDaysOverride { get; set; }
     }
 }

src/Stripe.net/Entities/BankAccounts/BankAccountFutureRequirementsError.cs

@@ -10,7 +10,8 @@ public class BankAccountFutureRequirementsError : StripeEntity<BankAccountFuture
     {
         /// <summary>
         /// The code for the type of error.
-        /// One of: <c>information_missing</c>, <c>invalid_address_city_state_postal_code</c>,
+        /// One of: <c>external_request</c>, <c>information_missing</c>,
+        /// <c>invalid_address_city_state_postal_code</c>,
         /// <c>invalid_address_highway_contract_box</c>, <c>invalid_address_private_mailbox</c>,
         /// <c>invalid_business_profile_name</c>, <c>invalid_business_profile_name_denylisted</c>,
         /// <c>invalid_company_name_denylisted</c>, <c>invalid_dob_age_over_maximum</c>,
@@ -38,7 +39,8 @@ public class BankAccountFutureRequirementsError : StripeEntity<BankAccountFuture
         /// <c>invalid_url_website_incomplete_terms_and_conditions</c>,
         /// <c>invalid_url_website_incomplete_under_construction</c>,
         /// <c>invalid_url_website_other</c>, <c>invalid_value_other</c>,
-        /// <c>verification_directors_mismatch</c>, <c>verification_document_address_mismatch</c>,
+        /// <c>unsupported_business_type</c>, <c>verification_directors_mismatch</c>,
+        /// <c>verification_document_address_mismatch</c>,
         /// <c>verification_document_address_missing</c>, <c>verification_document_corrupt</c>,
         /// <c>verification_document_country_not_supported</c>,
         /// <c>verification_document_directors_mismatch</c>,

src/Stripe.net/Entities/BankAccounts/BankAccountRequirementsError.cs

@@ -10,7 +10,8 @@ public class BankAccountRequirementsError : StripeEntity<BankAccountRequirements
     {
         /// <summary>
         /// The code for the type of error.
-        /// One of: <c>information_missing</c>, <c>invalid_address_city_state_postal_code</c>,
+        /// One of: <c>external_request</c>, <c>information_missing</c>,
+        /// <c>invalid_address_city_state_postal_code</c>,
         /// <c>invalid_address_highway_contract_box</c>, <c>invalid_address_private_mailbox</c>,
         /// <c>invalid_business_profile_name</c>, <c>invalid_business_profile_name_denylisted</c>,
         /// <c>invalid_company_name_denylisted</c>, <c>invalid_dob_age_over_maximum</c>,
@@ -38,7 +39,8 @@ public class BankAccountRequirementsError : StripeEntity<BankAccountRequirements
         /// <c>invalid_url_website_incomplete_terms_and_conditions</c>,
         /// <c>invalid_url_website_incomplete_under_construction</c>,
         /// <c>invalid_url_website_other</c>, <c>invalid_value_other</c>,
-        /// <c>verification_directors_mismatch</c>, <c>verification_document_address_mismatch</c>,
+        /// <c>unsupported_business_type</c>, <c>verification_directors_mismatch</c>,
+        /// <c>verification_document_address_mismatch</c>,
         /// <c>verification_document_address_missing</c>, <c>verification_document_corrupt</c>,
         /// <c>verification_document_country_not_supported</c>,
         /// <c>verification_document_directors_mismatch</c>,