Bump version to 31.2.0-beta.1

Author: ramya-stripe

CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 31.2.0-beta.1 - 2025-12-16
+This release changes the pinned API version to `2025-12-15.preview`.
+
+* [#2104](https://github.com/stripe/stripe-java/pull/2104) Add EventNotificationHandler
+* [#2117](https://github.com/stripe/stripe-java/pull/2117) Update generated code for beta
+  * Add support for new resources `reserve.Hold`, `reserve.Plan`, and `reserve.Release`
+  * Add support for `list` and `retrieve` methods on resources `reserve.Hold` and `reserve.Release`
+  * Add support for `retrieve` method on resource `reserve.Plan`
+  * Change type of `v2.FinancialAddressGeneratedMicrodeposits.amounts` from `amount` to `an object`
+  * Change type of `PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amount`, `PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amount`, `PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amount`, `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amount`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.amount`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.amount`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount` from `longInteger` to `emptyable(longInteger)`
+  * Change type of `PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amountType`, `PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amountType`, `PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amountType`, `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amountType`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.amountType`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.amountType`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amountType` from `enum('fixed'|'maximum')` to `emptyable(enum('fixed'|'maximum'))`
+  * Change type of `PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.endDate`, `PaymentIntentCreateParams.payment_method_options.payto.mandate_options.endDate`, `PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.endDate`, `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.endDate`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.endDate`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.endDate`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.endDate` from `string` to `emptyable(string)`
+  * Change type of `PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.paymentSchedule`, `PaymentIntentCreateParams.payment_method_options.payto.mandate_options.paymentSchedule`, `PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.paymentSchedule`, `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.paymentSchedule`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.paymentSchedule`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.paymentSchedule`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.paymentSchedule` from `enum` to `emptyable(enum)`
+  * Change type of `PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.paymentsPerPeriod`, `PaymentIntentCreateParams.payment_method_options.payto.mandate_options.paymentsPerPeriod`, `PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.paymentsPerPeriod`, `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.paymentsPerPeriod`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.paymentsPerPeriod`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.paymentsPerPeriod`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.paymentsPerPeriod` from `longInteger` to `emptyable(longInteger)`
+  * Change type of `PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.purpose`, `PaymentIntentCreateParams.payment_method_options.payto.mandate_options.purpose`, `PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.purpose`, `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.purpose`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.purpose`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.purpose`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.purpose` from `enum` to `emptyable(enum)`
+  * Change type of `SetupIntentConfirmParams.payment_method_options.payto.mandate_options.startDate`, `SetupIntentCreateParams.payment_method_options.payto.mandate_options.startDate`, `SetupIntentUpdateParams.payment_method_options.payto.mandate_options.startDate`, and `checkout.SessionCreateParams.payment_method_options.payto.mandate_options.startDate` from `string` to `emptyable(string)`
+  * Add support for `asyncWorkflows` on `PaymentIntent`
+  * Add support for `payto` on `QuotePreviewInvoice.payment_settings.payment_method_options`
+  * Remove support for `requested` on `v2.core.Account.configuration.customer.capabilities.automatic_indirect_tax`, `v2.core.Account.configuration.merchant.capabilities.ach_debit_payments`, `v2.core.Account.configuration.merchant.capabilities.acss_debit_payments`, `v2.core.Account.configuration.merchant.capabilities.affirm_payments`, `v2.core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments`, `v2.core.Account.configuration.merchant.capabilities.alma_payments`, `v2.core.Account.configuration.merchant.capabilities.amazon_pay_payments`, `v2.core.Account.configuration.merchant.capabilities.au_becs_debit_payments`, `v2.core.Account.configuration.merchant.capabilities.bacs_debit_payments`, `v2.core.Account.configuration.merchant.capabilities.bancontact_payments`, `v2.core.Account.configuration.merchant.capabilities.blik_payments`, `v2.core.Account.configuration.merchant.capabilities.boleto_payments`, `v2.core.Account.configuration.merchant.capabilities.card_payments`, `v2.core.Account.configuration.merchant.capabilities.cartes_bancaires_payments`, `v2.core.Account.configuration.merchant.capabilities.cashapp_payments`, `v2.core.Account.configuration.merchant.capabilities.eps_payments`, `v2.core.Account.configuration.merchant.capabilities.fpx_payments`, `v2.core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments`, `v2.core.Account.configuration.merchant.capabilities.grabpay_payments`, `v2.core.Account.configuration.merchant.capabilities.ideal_payments`, `v2.core.Account.configuration.merchant.capabilities.jcb_payments`, `v2.core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments`, `v2.core.Account.configuration.merchant.capabilities.kakao_pay_payments`, `v2.core.Account.configuration.merchant.capabilities.klarna_payments`, `v2.core.Account.configuration.merchant.capabilities.konbini_payments`, `v2.core.Account.configuration.merchant.capabilities.kr_card_payments`, `v2.core.Account.configuration.merchant.capabilities.link_payments`, `v2.core.Account.configuration.merchant.capabilities.mobilepay_payments`, `v2.core.Account.configuration.merchant.capabilities.multibanco_payments`, `v2.core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments`, `v2.core.Account.configuration.merchant.capabilities.naver_pay_payments`, `v2.core.Account.configuration.merchant.capabilities.oxxo_payments`, `v2.core.Account.configuration.merchant.capabilities.p24_payments`, `v2.core.Account.configuration.merchant.capabilities.pay_by_bank_payments`, `v2.core.Account.configuration.merchant.capabilities.payco_payments`, `v2.core.Account.configuration.merchant.capabilities.paynow_payments`, `v2.core.Account.configuration.merchant.capabilities.promptpay_payments`, `v2.core.Account.configuration.merchant.capabilities.revolut_pay_payments`, `v2.core.Account.configuration.merchant.capabilities.samsung_pay_payments`, `v2.core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments`, `v2.core.Account.configuration.merchant.capabilities.sepa_debit_payments`, `v2.core.Account.configuration.merchant.capabilities.stripe_balance.payouts`, `v2.core.Account.configuration.merchant.capabilities.swish_payments`, `v2.core.Account.configuration.merchant.capabilities.twint_payments`, `v2.core.Account.configuration.merchant.capabilities.us_bank_transfer_payments`, `v2.core.Account.configuration.merchant.capabilities.zip_payments`, `v2.core.Account.configuration.recipient.capabilities.bank_accounts.local`, `v2.core.Account.configuration.recipient.capabilities.bank_accounts.wire`, `v2.core.Account.configuration.recipient.capabilities.cards`, `v2.core.Account.configuration.recipient.capabilities.stripe_balance.payouts`, `v2.core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers`, `v2.core.Account.configuration.storer.capabilities.financial_addresses.bank_accounts`, `v2.core.Account.configuration.storer.capabilities.holds_currencies.eur`, `v2.core.Account.configuration.storer.capabilities.holds_currencies.gbp`, `v2.core.Account.configuration.storer.capabilities.holds_currencies.usd`, `v2.core.Account.configuration.storer.capabilities.inbound_transfers.bank_accounts`, `v2.core.Account.configuration.storer.capabilities.outbound_payments.bank_accounts`, `v2.core.Account.configuration.storer.capabilities.outbound_payments.cards`, `v2.core.Account.configuration.storer.capabilities.outbound_payments.financial_accounts`, `v2.core.Account.configuration.storer.capabilities.outbound_transfers.bank_accounts`, and `v2.core.Account.configuration.storer.capabilities.outbound_transfers.financial_accounts`
+  * Change type of `v2.FinancialAddressCreditSimulationCreditParams.amount`, `v2.core.Account.identity.business_details.annual_revenue.amount`, `v2.core.Account.identity.business_details.monthly_estimated_revenue.amount`, `v2.core.AccountCreateParams.identity.business_details.annual_revenue.amount`, `v2.core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount`, `v2.core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount`, `v2.core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount`, `v2.core.AccountUpdateParams.identity.business_details.annual_revenue.amount`, `v2.core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount`, `v2.moneymanagement.Adjustment.amount`, `v2.moneymanagement.InboundTransfer.amount`, `v2.moneymanagement.InboundTransferCreateParams.amount`, `v2.moneymanagement.OutboundPayment.amount`, `v2.moneymanagement.OutboundPaymentCreateParams.amount`, `v2.moneymanagement.OutboundPaymentQuote.amount`, `v2.moneymanagement.OutboundPaymentQuote.estimated_fees[].amount`, `v2.moneymanagement.OutboundPaymentQuoteCreateParams.amount`, `v2.moneymanagement.OutboundTransfer.amount`, `v2.moneymanagement.OutboundTransferCreateParams.amount`, `v2.moneymanagement.ReceivedCredit.amount`, `v2.moneymanagement.ReceivedDebit.amount`, and `v2.moneymanagement.Transaction.amount` from `amount` to `an object`
+  * Add support for `financialConnectionsAccount` on `v2.core.vault.UsBankAccount` and `v2.moneymanagement.PayoutMethod.bank_account`
+  * Change type of `v2.moneymanagement.FinancialAccount.balance.available`, `v2.moneymanagement.Transaction.balance_impact.available`, and `v2.moneymanagement.TransactionEntry.balance_impact.available` from `amount` to `an object`
+  * Change type of `v2.moneymanagement.FinancialAccount.balance.inboundPending`, `v2.moneymanagement.Transaction.balance_impact.inboundPending`, and `v2.moneymanagement.TransactionEntry.balance_impact.inboundPending` from `amount` to `an object`
+  * Change type of `v2.moneymanagement.FinancialAccount.balance.outboundPending`, `v2.moneymanagement.Transaction.balance_impact.outboundPending`, and `v2.moneymanagement.TransactionEntry.balance_impact.outboundPending` from `amount` to `an object`
+  * Change type of `v2.moneymanagement.InboundTransfer.from.debited`, `v2.moneymanagement.OutboundPayment.from.debited`, `v2.moneymanagement.OutboundPaymentQuote.from.debited`, and `v2.moneymanagement.OutboundTransfer.from.debited` from `amount` to `an object`
+  * Change type of `v2.moneymanagement.InboundTransfer.to.credited`, `v2.moneymanagement.OutboundPayment.to.credited`, `v2.moneymanagement.OutboundPaymentQuote.to.credited`, and `v2.moneymanagement.OutboundTransfer.to.credited` from `amount` to `an object`
+  * Add support for `transfer` on `v2.moneymanagement.ReceivedCredit.balance_transfer`
+  * Add support for new values `at_stn`, `at_vat`, `be_vat`, `bg_vat`, `ca_gst_hst`, `cy_he`, `cy_vat`, `cz_vat`, `de_stn`, `dk_vat`, `ee_vat`, `es_vat`, `fi_vat`, `fr_rna`, `gr_afm`, `gr_vat`, `hr_mbs`, `hr_oib`, `hr_vat`, `hu_tin`, `hu_vat`, `ie_trn`, `ie_vat`, `lt_vat`, `lu_nif`, `lu_vat`, `lv_vat`, `mt_tin`, `mt_vat`, `my_itn`, `nl_rsin`, `nl_vat`, `nz_ird`, `pl_nip`, `pl_vat`, `ro_orc`, `ro_vat`, `se_vat`, `si_tin`, `si_vat`, `sk_dic`, and `sk_vat` on enums `v2.core.AccountCreateParams.identity.business_details.id_numbers[].type`, `v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type`, and `v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type`
+  * Remove support for value `hk_mbs` from enums `v2.core.AccountCreateParams.identity.business_details.id_numbers[].type`, `v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type`, and `v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type`
+  * Add support for new values `ar_cuil`, `at_stn`, `be_nrn`, `bg_ucn`, `bn_nric`, `ca_sin`, `ch_oasi`, `cl_rut`, `cn_pp`, `co_nuip`, `cr_ci`, `cy_tic`, `cz_rc`, `dk_cpr`, `do_cie`, `ec_ci`, `ee_ik`, `es_nif`, `fi_hetu`, `fr_nir`, `gb_nino`, `gr_afm`, `hr_oib`, `hu_ad`, `id_nik`, `ie_ppsn`, `is_kt`, `it_cf`, `jp_inc`, `ke_pin`, `li_peid`, `lt_ak`, `lu_nif`, `lv_pk`, `ng_nin`, `no_nin`, `nz_ird`, `pl_pesel`, `pt_nif`, `ro_cnp`, `se_pin`, `sk_dic`, `tr_tin`, `uy_dni`, and `za_id` on enums `v2.core.AccountCreateParams.identity.individual.id_numbers[].type`, `v2.core.AccountPersonCreateParams.id_numbers[].type`, `v2.core.AccountPersonTokenCreateParams.id_numbers[].type`, `v2.core.AccountPersonUpdateParams.id_numbers[].type`, `v2.core.AccountTokenCreateParams.identity.individual.id_numbers[].type`, and `v2.core.AccountUpdateParams.identity.individual.id_numbers[].type`
+  * Change `v2.core.AccountTokenCreateParams.identity` to be optional
+  * Change type of `v2.core.AccountListParams.appliedConfigurations` from `string` to `enum('customer'|'merchant'|'recipient'|'storer')`
+  * Add support for event notification `V2MoneyManagementPayoutMethodCreatedEvent` with related object `v2.moneymanagement.PayoutMethod`
+  * Add support for error type `ControlledByAlternateResourceException`
+  * Remove support for error type `RateLimitException`
+
 ## 31.1.0-beta.1 - 2025-11-18
 This release changes the pinned API version to `2025-11-17.preview`.
 

README.md

@@ -1,6 +1,6 @@
 # Stripe Java client library
 
-[![Maven Central](https://img.shields.io/badge/maven--central-v31.1.0-beta.1-blue)](https://mvnrepository.com/artifact/com.stripe/stripe-java)
+[![Maven Central](https://img.shields.io/badge/maven--central-v31.2.0-beta.1-blue)](https://mvnrepository.com/artifact/com.stripe/stripe-java)
 [![JavaDoc](http://img.shields.io/badge/javadoc-reference-blue.svg)](https://stripe.dev/stripe-java)
 [![Build Status](https://github.com/stripe/stripe-java/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/stripe/stripe-java/actions?query=branch%3Amaster)
 
@@ -23,7 +23,7 @@ We support LTS versions of the JDK. Currently, that's Java versions:
 Add this dependency to your project's build file:
 
 ```groovy
-implementation "com.stripe:stripe-java:31.1.0-beta.1"
+implementation "com.stripe:stripe-java:31.2.0-beta.1"
 ```
 
 ### Maven users
@@ -34,7 +34,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.stripe</groupId>
   <artifactId>stripe-java</artifactId>
-  <version>31.1.0-beta.1</version>
+  <version>31.2.0-beta.1</version>
 </dependency>
 ```
 

VERSION

@@ -1 +1 @@
-31.1.0-beta.1
+31.2.0-beta.1

gradle.properties

@@ -1,5 +1,5 @@
 GROUP=com.stripe
-VERSION_NAME=31.1.0-beta.1
+VERSION_NAME=31.2.0-beta.1
 
 POM_URL=https://github.com/stripe/stripe-java
 POM_SCM_URL=[email protected]:stripe/stripe-java.git

src/main/java/com/stripe/Stripe.java

@@ -15,7 +15,7 @@ public abstract class Stripe {
   public static final String LIVE_API_BASE = "https://api.stripe.com";
   public static final String UPLOAD_API_BASE = "https://files.stripe.com";
   public static final String METER_EVENTS_API_BASE = "https://meter-events.stripe.com";
-  public static final String VERSION = "31.1.0-beta.1";
+  public static final String VERSION = "31.2.0-beta.1";
 
   public static volatile String apiKey;
   public static volatile String clientId;