github stripe/stripe-node v20.2.0-beta.1
on GitHub

pre-release11 hours ago

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

  • #2498 Add EventNotificationHandler
  • #2509 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 Billing.CreditBalanceSummary.customer_account, Billing.CreditGrant.customer_account, BillingPortal.Session.customer_account, CashBalance.customer_account, Checkout.Session.customer_account, ConfirmationToken.payment_method_preview.customer_account, CreditNote.customer_account, CustomerBalanceTransaction.customer_account, CustomerCashBalanceTransaction.customer_account, CustomerSession.customer_account, Discount.customer_account, Invoice.customer_account, InvoiceItem.customer_account, PaymentIntent.customer_account, PaymentMethod.customer_account, PromotionCode.customer_account, Quote.customer_account, QuotePreviewInvoice.customer_account, QuotePreviewSubscriptionSchedule.customer_account, SetupAttempt.customer_account, Subscription.customer_account, SubscriptionSchedule.customer_account, TaxId.customer_account, and TaxId.owner.customer_account to be required
    • Change type of V2.FinancialAddressGeneratedMicrodeposits.amounts from amount to an object
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount, 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, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.amount from longInteger to emptyable(longInteger)
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount_type, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amount_type, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amount_type, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amount_type, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amount_type, SetupIntentCreateParams.payment_method_options.payto.mandate_options.amount_type, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.amount_type from enum('fixed'|'maximum') to emptyable(enum('fixed'|'maximum'))
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.end_date, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.end_date, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.end_date, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.end_date, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.end_date, SetupIntentCreateParams.payment_method_options.payto.mandate_options.end_date, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.end_date from string to emptyable(string)
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.payment_schedule, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.payment_schedule, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.payment_schedule, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.payment_schedule, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.payment_schedule, SetupIntentCreateParams.payment_method_options.payto.mandate_options.payment_schedule, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.payment_schedule from enum to emptyable(enum)
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.payments_per_period, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.payments_per_period, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.payments_per_period, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.payments_per_period, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.payments_per_period, SetupIntentCreateParams.payment_method_options.payto.mandate_options.payments_per_period, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.payments_per_period from longInteger to emptyable(longInteger)
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.purpose, 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, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.purpose from enum to emptyable(enum)
    • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.start_date, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.start_date, SetupIntentCreateParams.payment_method_options.payto.mandate_options.start_date, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.start_date from string to emptyable(string)
    • Change Identity.VerificationSession.related_customer_account to be required
    • Add support for async_workflows on PaymentIntent
    • Add support for payto on QuotePreviewInvoice.payment_settings.payment_method_options
    • Add support for new value payto on enum QuotePreviewInvoice.payment_settings.payment_method_types
    • 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
    • Add support for new values al_bank_account, am_bank_account, bn_bank_account, bw_bank_account, dz_bank_account, gy_bank_account, jm_bank_account, jo_bank_account, kw_bank_account, lk_bank_account, ma_bank_account, om_bank_account, and tz_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
    • Change type of 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.FinancialAddressCreditSimulationCreditParams.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 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.Account.identity.business_details.id_numbers[].type, 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.Account.identity.business_details.id_numbers[].type, 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.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.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.Account.defaults.responsibilities to be required
    • Change V2.Core.Account.defaults.responsibilities.fees_collector to be optional
    • Change V2.Core.Account.defaults.responsibilities.losses_collector to be optional
    • Add support for financial_connections_account 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.inbound_pending, V2.MoneyManagement.Transaction.balance_impact.inbound_pending, and V2.MoneyManagement.TransactionEntry.balance_impact.inbound_pending from amount to an object
    • Change type of V2.MoneyManagement.FinancialAccount.balance.outbound_pending, V2.MoneyManagement.Transaction.balance_impact.outbound_pending, and V2.MoneyManagement.TransactionEntry.balance_impact.outbound_pending 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 value transfer on enum V2.MoneyManagement.ReceivedCredit.balance_transfer.type
    • Change V2.Core.AccountTokenCreateParams.identity to be optional
    • Change type of V2.Core.AccountListParams.applied_configurations 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 ControlledByAlternateResourceError
    • Remove support for error type RateLimitError
    • Add support for error code account_token_required_for_v2_account on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

Check out latest releases or
releases around stripe/stripe-node v20.2.0-beta.1

Don't miss a new stripe-node release

NewReleases is sending notifications on new releases.

Get notifications