github stripe/stripe-java v31.2.0-beta.1
on GitHub

pre-release14 hours ago

This release changes the pinned API version to 2025-12-15.preview.

  • #2104 Add EventNotificationHandler
  • #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

See the changelog for more details.

Check out latest releases or
releases around stripe/stripe-java v31.2.0-beta.1

Don't miss a new stripe-java release

NewReleases is sending notifications on new releases.

Get notifications