releases.shpreview
Stripe/stripe-node

stripe-node

$npx -y @buildinternet/releases show stripe-node
Mon
Wed
Fri
AprMayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases36Avg11/moVersionsv20.2.0-alpha.3 → v22.1.0-beta.3
Dec 16, 2025

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.

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

  • #2522 Update generated code
    • Add support for new resources V2.Core.AccountLink, V2.Core.AccountPersonToken, V2.Core.AccountPerson, V2.Core.AccountToken, and V2.Core.Account
    • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
    • Add support for create method on resource V2.Core.AccountLink
    • Add support for close, create, list, retrieve, and update methods on resource V2.Core.Account
    • Add support for create, del, list, retrieve, and update methods on resource V2.Core.AccountPerson
    • Add support for payto_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
    • Add support for signer on AccountCreateParams.documents.proof_of_registration, AccountCreateParams.documents.proof_of_ultimate_beneficial_ownership, AccountUpdateParams.documents.proof_of_registration, and AccountUpdateParams.documents.proof_of_ultimate_beneficial_ownership
    • Add support for customer_account on Billing.CreditBalanceSummaryRetrieveParams, Billing.CreditBalanceSummary, Billing.CreditBalanceTransactionListParams, Billing.CreditGrantCreateParams, Billing.CreditGrantListParams, Billing.CreditGrant, BillingPortal.SessionCreateParams, BillingPortal.Session, CashBalance, Checkout.SessionCreateParams, Checkout.SessionListParams, Checkout.Session, ConfirmationToken.payment_method_preview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSessionCreateParams, CustomerSession, Customer, Discount, FinancialConnections.Account.account_holder, FinancialConnections.AccountListParams.account_holder, FinancialConnections.Session.account_holder, FinancialConnections.SessionCreateParams.account_holder, InvoiceCreateParams, InvoiceCreatePreviewParams, InvoiceItemCreateParams, InvoiceItemListParams, InvoiceItem, InvoiceListParams, Invoice, PaymentIntentCreateParams, PaymentIntentListParams, PaymentIntentUpdateParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethodListParams, PaymentMethod, PromotionCodeCreateParams, PromotionCodeListParams, PromotionCode, QuoteCreateParams, QuoteListParams, QuoteUpdateParams, Quote, SetupAttempt, SetupIntentCreateParams, SetupIntentListParams, SetupIntentUpdateParams, SetupIntent, SubscriptionCreateParams, SubscriptionListParams, SubscriptionScheduleCreateParams, SubscriptionScheduleListParams, SubscriptionSchedule, Subscription, TaxId.owner, TaxIdCreateParams.owner, TaxIdListParams.owner, and TaxId
    • Add support for metadata on Checkout.SessionCreateParams.line_items[] and LineItem
    • Change Billing.CreditBalanceSummaryRetrieveParams.customer, Billing.CreditBalanceTransactionListParams.customer, Billing.CreditGrantCreateParams.customer, BillingPortal.SessionCreateParams.customer, CustomerSessionCreateParams.customer, InvoiceItemCreateParams.customer, PaymentMethodAttachParams.customer, and SubscriptionCreateParams.customer to be optional
    • Add support for billing_cycle_anchor on BillingPortal.Configuration.features.subscription_update, BillingPortal.ConfigurationCreateParams.features.subscription_update, and BillingPortal.ConfigurationUpdateParams.features.subscription_update
    • Add support for payto on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Mandate.payment_method_details, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethodUpdateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, SetupIntentUpdateParams.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
    • Add support for expected_debit_date on Charge.payment_method_details.acss_debit, Charge.payment_method_details.au_becs_debit, Charge.payment_method_details.bacs_debit, Charge.payment_method_details.nz_bank_account, Charge.payment_method_details.sepa_debit, Charge.payment_method_details.us_bank_account, PaymentAttemptRecord.payment_method_details.acss_debit, PaymentAttemptRecord.payment_method_details.au_becs_debit, PaymentAttemptRecord.payment_method_details.bacs_debit, PaymentAttemptRecord.payment_method_details.nz_bank_account, PaymentAttemptRecord.payment_method_details.sepa_debit, PaymentAttemptRecord.payment_method_details.us_bank_account, PaymentRecord.payment_method_details.acss_debit, PaymentRecord.payment_method_details.au_becs_debit, PaymentRecord.payment_method_details.bacs_debit, PaymentRecord.payment_method_details.nz_bank_account, PaymentRecord.payment_method_details.sepa_debit, and PaymentRecord.payment_method_details.us_bank_account
    • Add support for new value mollie on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
    • Add support for new value MLLENL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
    • Add support for new value payto on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
    • Add support for new value payto on enum Checkout.SessionCreateParams.payment_method_types
    • Add support for line_items on Checkout.SessionUpdateParams
    • Add support for new value payto on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
    • Add support for new value payto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
    • Add support for new value payto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
    • Add support for invoice on CustomerListCustomerBalanceTransactionsParams
    • Add support for related_customer_account on Identity.VerificationSessionCreateParams, Identity.VerificationSessionListParams, and Identity.VerificationSession
    • Change type of InvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable(Price)
    • Add support for new value payto on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
    • Add support for subtotal on InvoiceLineItem
    • Add support for authorization_code, description, iin, installments, issuer, network_advice_code, network_decline_code, and stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
    • Change PaymentIntent.transfer_data to be optional
    • Add support for new value payto on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
    • Add support for allow_redisplay on PaymentMethodListParams
    • Add support for reported_by on PaymentRecord
    • Change Product.tax_code to be optional
    • Add support for new values 2025-12-15.clover and 2026-01-28.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for changes on V2.Core.Event
    • Add support for error code account_token_required_for_v2_account on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

Dec 14, 2025
  • #2520 Update generated code for private-preview
    • Add support for new resources SharedPayment.GrantedToken, V2.Iam.ApiKey, V2.Payments.SettlementAllocationIntentSplit, V2.Payments.SettlementAllocationIntent, and V2.Tax.ManualRule
    • Add support for retrieve method on resource SharedPayment.GrantedToken
    • Add support for create and update test helper methods on resource SharedPayment.GrantedToken
    • Add support for create, deactivate, list, retrieve, and update methods on resource V2.Tax.ManualRule
    • Add support for cancel, create, retrieve, submit, and update methods on resource V2.Payments.SettlementAllocationIntent
    • Add support for cancel, create, and retrieve methods on resource V2.Payments.SettlementAllocationIntentSplit
    • Add support for create, expire, list, retrieve, rotate, and update methods on resource V2.Iam.ApiKey
    • Add support for check_scanning on AccountSessionCreateParams.components
    • Add support for tax_details on Checkout.SessionCreateParams.line_items[].price_data.product_data, Checkout.SessionUpdateParams.line_items[].price_data.product_data, InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, PaymentLinkCreateParams.line_items[].price_data.product_data, ProductCreateParams, and ProductUpdateParams
    • Add support for payment_method_data on DelegatedCheckout.RequestedSessionConfirmParams
    • Add support for product_details on DelegatedCheckout.RequestedSession.line_item_details[]
    • Add support for wallets on Issuing.CardListParams
    • Add support for primary_account_identifier on Issuing.Card.wallets.apple_pay and Issuing.Card.wallets.google_pay
    • Add support for shared_payment_granted_token on PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntent
    • Change ProductCatalog.TrialOffer.duration.relative to be optional
    • 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.Account.configuration.recipient_data.default_outbound_destination.type
    • Add support for instant on V2.Account.configuration.recipient_data.features.bank_accounts, V2.AccountCreateParams.configuration.recipient_data.features.bank_accounts, V2.AccountUpdateParams.configuration.recipient_data.features.bank_accounts, V2.Core.Account.configuration.recipient.capabilities.bank_accounts, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts, and V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts
    • Add support for new value bank_accounts.instant on enum V2.Account.requirements[].impact.required_for_features
    • Add support for collect_at on V2.Billing.IntentAction.deactivate, V2.Billing.IntentAction.modify, V2.Billing.IntentAction.subscribe, V2.Billing.IntentCreateParams.actions[].deactivate, V2.Billing.IntentCreateParams.actions[].modify, and V2.Billing.IntentCreateParams.actions[].subscribe
    • Remove support for billing_details on V2.Billing.IntentAction.deactivate, V2.Billing.IntentAction.modify, V2.Billing.IntentAction.subscribe, V2.Billing.IntentCreateParams.actions[].deactivate, V2.Billing.IntentCreateParams.actions[].modify, and V2.Billing.IntentCreateParams.actions[].subscribe
    • Add support for overrides on V2.Billing.IntentAction.deactivate.pricing_plan_subscription_details, V2.Billing.IntentAction.modify.pricing_plan_subscription_details, V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details, V2.Billing.IntentCreateParams.actions[].deactivate.pricing_plan_subscription_details, V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details, and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details
    • Remove support for requested on V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.Account.configuration.recipient.capabilities.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.Account.configuration.storer.capabilities.outbound_payments.crypto_wallets, and V2.Core.Account.configuration.storer.capabilities.outbound_transfers.crypto_wallets
    • Add support for new value bank_accounts.instant on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • Add support for alternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod
    • Add support for managed_by and payments on V2.MoneyManagement.FinancialAccount
    • Add support for new value payments on enum V2.MoneyManagement.FinancialAccount.type
    • Add support for speed on V2.MoneyManagement.OutboundPayment.delivery_options, V2.MoneyManagement.OutboundPaymentCreateParams.delivery_options, V2.MoneyManagement.OutboundPaymentQuote.delivery_options, and V2.MoneyManagement.OutboundPaymentQuoteCreateParams.delivery_options
    • Add support for new value real_time_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].type
    • Add support for types on V2.MoneyManagement.FinancialAccountListParams
    • Change type of V2.Core.AccountListParams.applied_configurations from string to enum
    • Add support for new value bank_accounts.instant on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
    • Add support for top_impacted_accounts on EventsV2CoreHealthApiErrorFiringEvent.impact, EventsV2CoreHealthApiErrorResolvedEvent.impact, EventsV2CoreHealthApiLatencyFiringEvent.impact, EventsV2CoreHealthApiLatencyResolvedEvent.impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact
    • Add support for event notifications V2CoreHealthSepaDebitDelayedFiringEvent, V2CoreHealthSepaDebitDelayedResolvedEvent, and V2PaymentsSettlementAllocationIntentNotFoundEvent
    • Add support for event notifications V2PaymentsSettlementAllocationIntentCanceledEvent, V2PaymentsSettlementAllocationIntentCreatedEvent, V2PaymentsSettlementAllocationIntentErroredEvent, V2PaymentsSettlementAllocationIntentFundsNotReceivedEvent, V2PaymentsSettlementAllocationIntentMatchedEvent, V2PaymentsSettlementAllocationIntentSettledEvent, and V2PaymentsSettlementAllocationIntentSubmittedEvent with related object V2.Payments.SettlementAllocationIntent
    • Add support for event notifications V2PaymentsSettlementAllocationIntentSplitCanceledEvent, V2PaymentsSettlementAllocationIntentSplitCreatedEvent, and V2PaymentsSettlementAllocationIntentSplitSettledEvent with related object V2.Payments.SettlementAllocationIntentSplit
    • Remove support for error code account_rate_limit_exceeded on RateLimitError

See the changelog for more details.

Dec 4, 2025
  • #2519 Update generated code for private-preview
    • Add support for event notifications V2IamApiKeyCreatedEvent, V2IamApiKeyDefaultSecretRevealedEvent, V2IamApiKeyExpiredEvent, V2IamApiKeyPermissionsUpdatedEvent, V2IamApiKeyRotatedEvent, and V2IamApiKeyUpdatedEvent
  • #2517 Update generated code for private-preview
    • Add support for check_scanning on AccountSession.components
    • Add support for client on V2.Core.Event.reason.request
    • Add support for stripe_balance_payment on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
    • Add support for new value stripe_balance_payment on enum V2.MoneyManagement.ReceivedCredit.type
    • Add support for balance_transfer on V2.MoneyManagement.ReceivedDebit
    • Add support for new values balance_transfer and stripe_balance_payment on enum V2.MoneyManagement.ReceivedDebit.type
    • Add support for include on V2.Core.EventListParams and V2.Core.EventRetrieveParams

See the changelog for more details.

Nov 24, 2025
  • #2512 Update generated code for private-preview
    • Add support for new resource ProductCatalog.TrialOffer
    • Add support for create method on resource ProductCatalog.TrialOffer
    • Remove support for amount_subtotal_after_discount on DelegatedCheckout.RequestedSession.line_item_details[] and DelegatedCheckout.RequestedSession.total_details
    • Remove support for amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.line_item_details[]
    • Add support for amount_cart_discount and amount_items_discount on DelegatedCheckout.RequestedSession.total_details
    • Remove support for amount_discount on DelegatedCheckout.RequestedSession.total_details
    • Add support for payments_orchestration on PaymentIntentCreateParams and PaymentIntent

See the changelog for more details.

Nov 20, 2025

This release changes the pinned API version to 2025-11-17.preview.

  • #2510 Update generated code for private-preview
    • Add support for new resources V2.Core.AccountPersonToken, V2.Core.AccountToken, and V2.MoneyManagement.CurrencyConversion
    • Add support for create, list, and retrieve methods on resource V2.MoneyManagement.CurrencyConversion
    • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
    • Add support for effective_at on InvoiceCreatePreviewParams.schedule_details.amendments[], InvoiceCreatePreviewParams.schedule_details.phases[], QuoteCreateParams.lines[], QuoteLine, QuotePreviewSubscriptionSchedule.phases[], QuoteUpdateParams.lines[], SubscriptionSchedule.phases[], SubscriptionScheduleAmendParams.amendments[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]
    • Add support for trial_offer on InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set, InvoiceCreatePreviewParams.schedule_details.phases[].items[], QuoteCreateParams.lines[].actions[].add_item, QuoteCreateParams.lines[].actions[].set_items[], QuoteLine.actions[].add_item, QuoteLine.actions[].set_items[], QuotePreviewSubscriptionSchedule.phases[].items[], QuoteUpdateParams.lines[].actions[].add_item, QuoteUpdateParams.lines[].actions[].set_items[], SubscriptionSchedule.phases[].items[], SubscriptionScheduleAmendParams.amendments[].item_actions[].add, SubscriptionScheduleAmendParams.amendments[].item_actions[].set, SubscriptionScheduleCreateParams.phases[].items[], and SubscriptionScheduleUpdateParams.phases[].items[]
    • Change type of DelegatedCheckout.RequestedSession.amount_subtotal from longInteger to longInteger | null
    • Change type of DelegatedCheckout.RequestedSession.amount_total from longInteger to longInteger | null
    • Add support for amount_discount, amount_subtotal, amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.line_item_details[]
    • Add support for amount_subtotal_after_discount on DelegatedCheckout.RequestedSession.line_item_details[] and DelegatedCheckout.RequestedSession.total_details
    • Change type of InvoiceCreatePreviewParams.schedule_details.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
    • Remove support for values amendment_end, line_ends_at, schedule_end, and upcoming_invoice from enums InvoiceCreatePreviewParams.subscription_details.billing_schedules[].bill_until.type, Subscription.billing_schedules[].bill_until.type, SubscriptionCreateParams.billing_schedules[].bill_until.type, SubscriptionScheduleCreateParams.billing_schedules[].bill_until.type, SubscriptionScheduleUpdateParams.billing_schedules[].bill_until.type, and SubscriptionUpdateParams.billing_schedules[].bill_until.type
    • Add support for current_trial on InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items[]
    • Change type of QuoteCreateParams.subscription_data.billing_schedules and QuoteCreateParams.subscription_data_overrides[].billing_schedules from emptyable(array(billing_schedules_create_specs)) to array(billing_schedules_create_specs)
    • Add support for new value line_start on enums QuoteCreateParams.subscription_data.phase_effective_at, QuoteCreateParams.subscription_data_overrides[].phase_effective_at, QuoteUpdateParams.subscription_data.phase_effective_at, and QuoteUpdateParams.subscription_data_overrides[].phase_effective_at
    • Remove support for value phase_start from enums QuoteCreateParams.subscription_data.phase_effective_at, QuoteCreateParams.subscription_data_overrides[].phase_effective_at, QuoteUpdateParams.subscription_data.phase_effective_at, and QuoteUpdateParams.subscription_data_overrides[].phase_effective_at
    • Change type of Quote.subscription_data.billing_schedules and Quote.subscription_data_overrides[].billing_schedules from array(SubscriptionsResourceBillingSchedules) | null to array(QuotesResourceSubscriptionDataBillingSchedules)
    • Change type of Quote.subscription_data.phase_effective_at and Quote.subscription_data_overrides[].phase_effective_at from enum('billing_period_start'|'phase_start') | null to enum('billing_period_start'|'line_start')
    • Change type of QuotePreviewSubscriptionSchedule.default_settings.phase_effective_at and SubscriptionSchedule.default_settings.phase_effective_at from enum('billing_period_start'|'phase_start') | null to enum('billing_period_start'|'phase_start')
    • Change type of QuotePreviewSubscriptionSchedule.billing_schedules and SubscriptionSchedule.billing_schedules from array(SubscriptionsResourceBillingSchedules) | null to array(SubscriptionsResourceBillingSchedules)
    • Remove support for amendment_start, line_starts_at, and relative on Subscription.billing_schedules[].bill_from
    • Change type of Subscription.billing_schedules[].bill_from.computed_timestamp from DateTime | null to DateTime
    • Change type of Subscription.billing_schedules[].bill_from.type from enum to literal('timestamp')
    • Remove support for amendment_end and line_ends_at on Subscription.billing_schedules[].bill_until
    • Change type of V2.Billing.ServiceAction.credit_grant.amount.monetary, V2.Billing.ServiceAction.credit_grant_per_tenant.amount.monetary, V2.Billing.ServiceActionCreateParams.credit_grant.amount.monetary, and V2.Billing.ServiceActionCreateParams.credit_grant_per_tenant.amount.monetary from amount to an object
    • Add support for future_requirements on V2.Core.Account
    • Add support for konbini_payments and script_statement_descriptor on V2.Core.Account.configuration.merchant, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchant
    • Add support for eur on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
    • Add support for requirements_collector on V2.Core.Account.defaults.responsibilities
    • Add support for new value ar_cuit on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
    • Add support for new value ar_dni 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.AccountPersonUpdateParams.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
    • Remove support for collector on V2.Core.Account.requirements
    • Add support for new value holds_currencies.eur on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • Add support for new values payment_method and person on enum V2.Core.Account.requirements.entries[].reference.type
    • Remove support for value resource from enum V2.Core.Account.requirements.entries[].reference.type
    • Remove support for value future_requirements from enum V2.Core.Account.requirements.entries[].requested_reasons[].code
    • Remove support for v1_event_id on V2.Core.Event
    • Remove support for amount_details and capture_method on V2.Payments.OffSessionPaymentCreateParams and V2.Payments.OffSessionPayment
    • Change type of V2.Payments.OffSessionPayment.amount_capturable from amount to an object
    • Change type of V2.Payments.OffSessionPayment.amount_requested from amount to an object
    • Change type of V2.Payments.OffSessionPaymentCreateParams.amount from amount to an object
    • Add support for new value best_available on enum V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategy
    • Remove support for values heuristic, scheduled, and smart from enum V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategy
    • Change V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategy to be optional
    • Remove support for destination on V2.Payments.OffSessionPaymentCaptureParams.transfer_data
    • Change V2.Payments.OffSessionPaymentCaptureParams.amount_to_capture to be optional
    • Add support for created on V2.Core.EventListParams
    • Remove support for gt, gte, lt, and lte on V2.Core.EventListParams
    • Add support for account_token on V2.Core.AccountCreateParams and V2.Core.AccountUpdateParams
    • Add support for new value future_requirements on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
    • Add support for person_token on V2.Core.AccountPersonCreateParams and V2.Core.AccountPersonUpdateParams
    • Add support for impacted_requests_percentage on EventsV2CoreHealthApiErrorFiringEvent.impact, EventsV2CoreHealthApiErrorResolvedEvent.impact, EventsV2CoreHealthApiLatencyFiringEvent.impact, EventsV2CoreHealthApiLatencyResolvedEvent.impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact
    • Add support for context and related_object on EventsV2CoreHealthEventGenerationFailureResolvedEvent.impact
    • Remove support for account, livemode, missing_delivery_attempts, and related_object_id on EventsV2CoreHealthEventGenerationFailureResolvedEvent.impact
    • Change type of EventsV2CoreHealthFraudRateIncreasedEvent.impact.realized_fraud_amount from amount to an object
    • Change type of EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.approved_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.approved_amount from amount to an object
    • Change type of EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.declined_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.declined_amount from amount to an object
    • Add support for thin events V2PaymentsOffSessionPaymentAttemptFailedEvent and V2PaymentsOffSessionPaymentAttemptStartedEvent with related object V2.Payments.OffSessionPayment
    • Remove support for thin event V1AccountUpdatedEvent with related object Account
    • Remove support for thin events V1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFee
    • Remove support for thin events V1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object BillingPortal.Configuration
    • Remove support for thin event V1CapabilityUpdatedEvent with related object Capability
    • Remove support for thin events V1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object Charge
    • Remove support for thin events V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object Dispute
    • Remove support for thin events V1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object Refund
    • Remove support for thin events V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object Checkout.Session
    • Remove support for thin events V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object Climate.Order
    • Remove support for thin events V1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object Climate.Product
    • Remove support for thin events V1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object Coupon
    • Remove support for thin events V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNote
    • Remove support for thin events V1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object Customer
    • Remove support for thin events V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object Subscription
    • Remove support for thin events V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxId
    • Remove support for thin event V1FileCreatedEvent with related object File
    • Remove support for thin events V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, and V1FinancialConnectionsAccountRefreshedTransactionsEvent with related object FinancialConnections.Account
    • Remove support for thin events V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object Identity.VerificationSession
    • Remove support for thin events V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object Invoice
    • Remove support for thin event V1InvoicePaymentPaidEvent with related object InvoicePayment
    • Remove support for thin events V1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItem
    • Remove support for thin events V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object Issuing.Authorization
    • Remove support for thin events V1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object Issuing.Card
    • Remove support for thin events V1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object Issuing.Cardholder
    • Remove support for thin events V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object Issuing.Dispute
    • Remove support for thin events V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object Issuing.PersonalizationDesign
    • Remove support for thin events V1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object Issuing.Token
    • Remove support for thin events V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object Issuing.Transaction
    • Remove support for thin event V1MandateUpdatedEvent with related object Mandate
    • Remove support for thin events V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntent
    • Remove support for thin events V1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLink
    • Remove support for thin events V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethod
    • Remove support for thin events V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object Payout
    • Remove support for thin events V1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object Person
    • Remove support for thin events V1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object Plan
    • Remove support for thin events V1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object Price
    • Remove support for thin events V1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object Product
    • Remove support for thin events V1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCode
    • Remove support for thin events V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object Quote
    • Remove support for thin events V1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object Radar.EarlyFraudWarning
    • Remove support for thin events V1ReviewClosedEvent and V1ReviewOpenedEvent with related object Review
    • Remove support for thin events V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntent
    • Remove support for thin event V1SigmaScheduledQueryRunCreatedEvent with related object Sigma.ScheduledQueryRun
    • Remove support for thin events V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object Source
    • Remove support for thin events V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionSchedule
    • Remove support for thin events V1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRate
    • Remove support for thin events V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object Terminal.Reader
    • Remove support for thin events V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object TestHelpers.TestClock
    • Remove support for thin events V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object Topup
    • Remove support for thin events V1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object Transfer

See the changelog for more details.

Nov 18, 2025
  • #2505 Update generated code for private-preview
    • Add support for billing_schedules_actions on InvoiceCreatePreviewParams.schedule_details.amendments[] and SubscriptionScheduleAmendParams.amendments[]
  • #2504 Update generated code for private-preview
    • Add support for new resources BalanceTransfer and Radar.AccountEvaluation
    • Add support for create method on resource BalanceTransfer
    • Add support for create, retrieve, and update methods on resource Radar.AccountEvaluation
    • Add support for specified_commercial_transactions_act_url on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
    • Add support for paypay_payments on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
    • Change Tax.Association.tax_transaction_attempts to be required
    • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].dimension_filters from string to array(string)
    • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].tenant_filters from string to array(string)
    • Add support for payment_method_configuration on BillingPortal.Configuration.features.payment_method_update
    • Add support for car_rental_data, flight_data, and lodging_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
    • Add support for transaction_id on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
    • Add support for new value finom on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
    • Add support for new value FNOMNL22 on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
    • Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reason and PaymentMethod.us_bank_account.status_details.blocked.reason
    • Add support for created on CustomerListCustomerBalanceTransactionsParams and InvoicePaymentListParams
    • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enum Event.type
    • Add support for account_numbers on FinancialConnections.Account
    • Change type of FinancialConnections.Session.client_secret from string to string | null
    • Add support for fraud_risk on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment
    • Add support for latest_fraud_warning on Issuing.Card
    • Add support for supplementary_purchase_data on OrderCreateParams.payment.settings.payment_method_options.klarna, OrderUpdateParams.payment.settings.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
    • Add support for capture_method on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present
    • Add support for allow_redisplay and customer_account on PaymentMethodListParams
    • Add support for mb_way and twint on Refund.destination_details
    • Change type of SubscriptionScheduleUpdateParams.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
    • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
    • Add support for new value 2025-11-17.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for snapshot events FinancialConnectionsAccountAccountNumbersUpdatedEvent and FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent with resource FinancialConnections.Account

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.preview.

  • #2487 Update generated code for beta
    • Add support for new resources V2.Core.AccountPersonToken and V2.Core.AccountToken
    • Remove support for resource V2.Payments.OffSessionPayment
    • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
    • Remove support for cancel, capture, create, list, and retrieve methods on resource V2.Payments.OffSessionPayment
    • Add support for specified_commercial_transactions_act_url on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
    • Add support for paypay_payments on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
    • Change Tax.Association.tax_transaction_attempts to be required
    • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].dimension_filters from string to array(string)
    • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].tenant_filters from string to array(string)
    • Add support for car_rental_data, flight_data, and lodging_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
    • Add support for supplementary_purchase_data on OrderCreateParams.payment.settings.payment_method_options.klarna, OrderUpdateParams.payment.settings.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
    • Add support for allow_redisplay and customer_account on PaymentMethodListParams
    • Add support for future_requirements on V2.Core.Account
    • Add support for konbini_payments and script_statement_descriptor on V2.Core.Account.configuration.merchant, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchant
    • Add support for eur on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
    • Add support for requirements_collector on V2.Core.Account.defaults.responsibilities
    • Add support for new value ar_cuit on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
    • Add support for new value ar_dni 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.AccountPersonUpdateParams.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
    • Remove support for collector on V2.Core.Account.requirements
    • Add support for new value holds_currencies.eur on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • Add support for new values payment_method and person on enum V2.Core.Account.requirements.entries[].reference.type
    • Remove support for value resource from enum V2.Core.Account.requirements.entries[].reference.type
    • Remove support for value future_requirements from enum V2.Core.Account.requirements.entries[].requested_reasons[].code
    • Add support for changes on V2.Core.Event
    • Remove support for value sepa_bank_account from enums V2.MoneyManagement.FinancialAddress.credentials.type and V2.MoneyManagement.FinancialAddressCreateParams.type
    • Add support for account_token on V2.Core.AccountCreateParams and V2.Core.AccountUpdateParams
    • Add support for new value future_requirements on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
    • Add support for person_token on V2.Core.AccountPersonCreateParams and V2.Core.AccountPersonUpdateParams
    • Add support for thin event V2CoreHealthEventGenerationFailureResolvedEvent
    • Remove support for thin events V2PaymentsOffSessionPaymentAuthorizationAttemptFailedEvent, V2PaymentsOffSessionPaymentAuthorizationAttemptStartedEvent, V2PaymentsOffSessionPaymentCanceledEvent, V2PaymentsOffSessionPaymentCreatedEvent, V2PaymentsOffSessionPaymentFailedEvent, V2PaymentsOffSessionPaymentRequiresCaptureEvent, and V2PaymentsOffSessionPaymentSucceededEvent with related object V2.Payments.OffSessionPayment

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.clover.

  • #2502 Update generated code
    • ⚠️ Remove support for gt, gte, lt, and lte on V2.Core.EventListParams in favor of created.
  • #2497 Update v2 array parameter serialization to use indexed format
    • Retrieve and List calls for /v2 endpoints now use indexed format (e.g., ?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g., ?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
  • #2495 Update generated code
    • Add support for new resources Tax.Association and Terminal.OnboardingLink
    • Add support for find method on resource Tax.Association
    • Add support for create method on resource Terminal.OnboardingLink
    • Add support for payment_method_configuration on BillingPortal.Configuration.features.payment_method_update
    • Add support for transaction_id on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
    • Add support for new value finom on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
    • Add support for new value FNOMNL22 on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
    • Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reason and PaymentMethod.us_bank_account.status_details.blocked.reason
    • Add support for created on CustomerListCustomerBalanceTransactionsParams and InvoicePaymentListParams
    • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enum Event.type
    • Add support for account_numbers on FinancialConnections.Account
    • Change type of FinancialConnections.Session.client_secret from string to string | null
    • Add support for fraud_risk on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment
    • Add support for latest_fraud_warning on Issuing.Card
    • Add support for hooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
    • Add support for mb_way and twint on Refund.destination_details
    • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
    • Add support for snapshot events FinancialConnectionsAccountAccountNumbersUpdatedEvent and FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent with resource FinancialConnections.Account

See the changelog for more details.

Nov 13, 2025

This release changes the pinned API version to 2025-10-29.preview.

  • #2501 Update generated code for private-preview
    • Add support for new resource Issuing.Program
    • Add support for create, list, retrieve, and update methods on resource Issuing.Program
    • Add support for schedule on Discount
    • Add support for applicable_fees on DelegatedCheckout.RequestedSession.total_details
    • Add support for schedule_details on Invoice.parent, InvoiceItem.parent, InvoiceLineItem.parent, and QuotePreviewInvoice.parent
    • Add support for new value schedule_details on enum InvoiceItem.parent.type
    • Add support for billing_schedules on InvoiceCreatePreviewParams.schedule_details, QuotePreviewSubscriptionSchedule, SubscriptionScheduleCreateParams, SubscriptionScheduleUpdateParams, and SubscriptionSchedule
    • Add support for new value schedule_details on enums Invoice.parent.type and QuotePreviewInvoice.parent.type
    • Add support for new value schedule_details on enum InvoiceLineItem.parent.type
    • Add support for latest_invoice on QuotePreviewSubscriptionSchedule and SubscriptionSchedule
    • Add support for phase_effective_at on QuotePreviewSubscriptionSchedule.default_settings, SubscriptionSchedule.default_settings, SubscriptionScheduleCreateParams.default_settings, and SubscriptionScheduleUpdateParams.default_settings
  • #2494 Update generated code for private-preview
    • Remove support for resource V2.Tax.AutomaticRule
    • Remove support for create, deactivate, find, retrieve, and update methods on resource V2.Tax.AutomaticRule
    • Add support for self_reported_income and self_reported_monthly_housing_payment on AccountCreateParams.individual, AccountCreatePersonParams, AccountUpdateParams.individual, AccountUpdatePersonParams, Person, TokenCreateParams.account.individual, and TokenCreateParams.person
    • Add support for new values amendment_end, line_ends_at, schedule_end, and upcoming_invoice on enums InvoiceCreatePreviewParams.subscription_details.billing_schedules[].bill_until.type, Subscription.billing_schedules[].bill_until.type, SubscriptionCreateParams.billing_schedules[].bill_until.type, and SubscriptionUpdateParams.billing_schedules[].bill_until.type
    • Add support for billing_schedules and phase_effective_at on Quote.subscription_data_overrides[], Quote.subscription_data, QuoteCreateParams.subscription_data_overrides[], QuoteCreateParams.subscription_data, QuoteUpdateParams.subscription_data_overrides[], and QuoteUpdateParams.subscription_data
    • Add support for bill_from on Subscription.billing_schedules[]
    • Add support for amendment_end and line_ends_at on Subscription.billing_schedules[].bill_until

See the changelog for more details.

Nov 12, 2025
  • #2500 Use TextEncoder instead of Buffer to ensure support in other JS environments
    • Fixes issues like #2499 and #2493 where use of Buffer.byteLength was causing errors in some runtime environments.

See the changelog for more details.

Nov 6, 2025
  • #2489 Update generated code for private-preview
    • Add support for new resources TransitBalance, V2.Reporting.ReportRun, V2.Reporting.Report
    • Add support for create and retrieve methods on resource V2.Reporting.ReportRun
    • Add support for retrieve method on resource V2.Reporting.Report
    • Add support for create and refill test helper methods on resource Capital.FinancingOffer
    • Add support for allocated_funds on Charge, PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntentUpdateParams
    • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object V2.Reporting.ReportRun

See the changelog for more details.

Nov 5, 2025
  • #2488 Update generated code
    • Add support for capture_method on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present

See the changelog for more details.

Nov 4, 2025
  • #2492 Add support for value payment_record to enum InvoicePayment.payment.type
  • #2485 correctly calculate content-length for JSON bodies that contain unicode

See the changelog for more details.

Oct 30, 2025
  • #2484 Update generated code for private-preview
    • Change DelegatedCheckout.RequestedSessionUpdateParams.line_item_details[].quantity to be required
    • Add support for payment_method_preview on DelegatedCheckout.RequestedSession
    • Add support for order_id on DelegatedCheckout.RequestedSession.order_details
    • Add support for lead on V2.Core.Account.configuration.card_creator.capabilities.commercial, V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
    • Add support for global_account_holder on V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
    • Add support for new value commercial.lead.prepaid_card on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • Add support for new value commercial.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

Oct 29, 2025
  • #2476 Update generated code for private-preview
    • Add support for report_refund method on resource PaymentRecord
    • Add support for representative_declaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
    • Add support for new value verification_data_not_found on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].code
    • Add support for tenants on Billing.Analytics.MeterUsageRow
    • Add support for transfer on ApplicationFee.fee_source
    • Add support for new value transfer on enum ApplicationFee.fee_source.type
    • Add support for transit_balances_total on Balance
    • Add support for new value transit on enum BalanceTransaction.balance_type
    • Add support for tenant_group_by_keys on Billing.Analytics.MeterUsageRetrieveParams.meters[]
    • Change Billing.CreditGrantCreateParams.category to be optional
    • Add support for payment_method_configuration on BillingPortal.ConfigurationCreateParams.features.payment_method_update and BillingPortal.ConfigurationUpdateParams.features.payment_method_update
    • Add support for new value solana on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
    • Add support for payment_portal_url on Charge.payment_method_details.rechnung, PaymentAttemptRecord.payment_method_details.rechnung, and PaymentRecord.payment_method_details.rechnung
    • Add support for twint on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
    • Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
    • Change CreditNote.refunds[].payment_record_refund to be required
    • Change CreditNote.refunds[].type to be required
    • Add support for customer_sheet, mobile_payment_element, and tax_id_element on CustomerSession.components and CustomerSessionCreateParams.components
    • Add support for new value custom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
    • Add support for provider on Customer.tax
    • Remove support for risk_details on DelegatedCheckout.RequestedSessionCreateParams
    • Add support for risk_details on DelegatedCheckout.RequestedSessionConfirmParams
    • Add support for new value platform_terms_of_service on enums File.purpose and FileListParams.purpose
    • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
    • Add support for starting_after on PaymentAttemptRecordListParams
    • Add support for reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna, and PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna
    • Add support for allocated_funds on PaymentIntent
    • Change PaymentIntent.payment_details.customer_reference to be required
    • Change PaymentIntent.payment_details.order_reference to be required
    • Add support for subscription_reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna
    • Add support for name_collection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
    • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, and Refund.destination_details
    • Add support for mb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
    • Add support for custom on PaymentMethodCreateParams and PaymentMethod
    • Add support for excluded_payment_method_types on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
    • Change SetupIntent.flow_directions to be optional
    • Add support for tw on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
    • Add support for gip on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
    • Add support for last_seen_at on Terminal.Reader
    • Add support for application_fee_amount on TransferCreateParams and Transfer
    • Add support for application_fee on Transfer
    • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for high_risk_activities_description, high_risk_activities, money_services_description, operates_in_prohibited_countries, participates_in_regulated_activity, purpose_of_funds_description, purpose_of_funds, regulated_activity, source_of_funds_description, and source_of_funds on V2.Core.Account.configuration.storer, V2.Core.AccountCreateParams.configuration.storer, and V2.Core.AccountUpdateParams.configuration.storer
    • Add support for crypto_wallets on V2.Core.Account.configuration.storer.capabilities.financial_addresses, V2.Core.Account.configuration.storer.capabilities.outbound_payments, V2.Core.Account.configuration.storer.capabilities.outbound_transfers, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers
    • Add support for usdc on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
    • Add support for crypto_storer on V2.Core.Account.identity.attestations.terms_of_service and V2.Core.AccountCreateParams.identity.attestations.terms_of_service
    • Add support for compliance_screening_description on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_details
    • Add support for external_amount on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
    • Add support for error code payment_intent_rate_limit_exceeded on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

This release changes the pinned API version to 2025-10-29.preview.

  • #2475 Update generated code for beta
    • Add support for crypto_storer on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • #2443 Update generated code for beta
    • Add support for update method on resource V2.MoneyManagement.FinancialAccount
    • Add support for confirm_microdeposits, list, and send_microdeposits methods on resource V2.Core.Vault.UsBankAccount
    • Add support for list method on resource V2.Core.Vault.GbBankAccount
    • Add support for new value verification_data_not_found on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].code
    • Add support for payment_portal_url on Charge.payment_method_details.rechnung, PaymentAttemptRecord.payment_method_details.rechnung, and PaymentRecord.payment_method_details.rechnung
    • Add support for tax_id_element on CustomerSession.components and CustomerSessionCreateParams.components
    • Add support for starting_after on PaymentAttemptRecordListParams
    • Add support for new value solana on enums PaymentAttemptRecord.payment_method_details.crypto.network and PaymentRecord.payment_method_details.crypto.network
    • Add support for reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna, and PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna
    • Change PaymentIntent.payment_details.customer_reference to be required
    • Change PaymentIntent.payment_details.order_reference to be required
    • Add support for subscription_reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna
    • Add support for closed on V2.Core.AccountListParams and V2.Core.Account
    • Add support for new value payment_method on enums V2.Core.Account.configuration.customer.automatic_indirect_tax.location_source, V2.Core.AccountCreateParams.configuration.customer.automatic_indirect_tax.location_source, and V2.Core.AccountUpdateParams.configuration.customer.automatic_indirect_tax.location_source
    • Add support for usd on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
    • Add support for new values application_custom and application_express on enums V2.Core.Account.defaults.responsibilities.fees_collector, V2.Core.AccountCreateParams.defaults.responsibilities.fees_collector, and V2.Core.AccountUpdateParams.defaults.responsibilities.fees_collector
    • Add support for representative_declaration on V2.Core.Account.identity.attestations, V2.Core.AccountCreateParams.identity.attestations, and V2.Core.AccountUpdateParams.identity.attestations
    • Add support for new value holds_currencies.usd on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • Add support for verification on V2.Core.Vault.UsBankAccount
    • Add support for v1_id on EventsV2MoneyManagementTransactionCreatedEvent
    • Remove support for thin event V2BillingBillSettingUpdatedEvent with related object V2.Billing.BillSetting
    • Add support for error code payment_intent_rate_limit_exceeded on QuotePreviewInvoice.last_finalization_error
    • Add support for error codes blocked_payout_method_crypto_wallet and unsupported_payout_method_crypto_wallet on BlockedByStripeError
    • Add support for error code outbound_flow_from_closed_financial_account_unsupported on FeatureNotEnabledError
    • Add support for error code limit_payout_method_crypto_wallet on QuotaExceededError

See the changelog for more details.

  • #2477 Update generated code
    • Improve docs for PaymentIntent related endpoints
  • #2469 Update generated code
    • Add support for new resources PaymentAttemptRecord, PaymentIntentAmountDetailsLineItem, and PaymentRecord
    • Add support for list and retrieve methods on resource PaymentAttemptRecord
    • Add support for report_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt_informational, report_payment_attempt, report_payment, report_refund, and retrieve methods on resource PaymentRecord
    • Add support for list method on resource PaymentIntentAmountDetailsLineItem
    • Add support for representative_declaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
    • Change Billing.CreditGrantCreateParams.category to be optional
    • Add support for payment_method_configuration on BillingPortal.ConfigurationCreateParams.features.payment_method_update and BillingPortal.ConfigurationUpdateParams.features.payment_method_update
    • Add support for new value solana on enum Charge.payment_method_details.crypto.network
    • Add support for new value mb_way on enum Checkout.SessionCreateParams.excluded_payment_method_types
    • Add support for twint on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
    • Add support for new value mb_way on enum Checkout.SessionCreateParams.payment_method_types
    • Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
    • Add support for payment_record_refund and type on CreditNote.refunds[], CreditNoteCreateParams.refunds[], CreditNotePreviewLinesParams.refunds[], and CreditNotePreviewParams.refunds[]
    • Add support for customer_sheet and mobile_payment_element on CustomerSession.components and CustomerSessionCreateParams.components
    • Add support for new value custom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
    • Add support for provider on Customer.tax
    • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enum Event.type
    • Add support for new value platform_terms_of_service on enums File.purpose and FileListParams.purpose
    • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
    • Add support for payment_record on InvoiceAttachPaymentParams, InvoicePayment.payment, and InvoicePaymentListParams.payment
    • Change type of InvoicePaymentListParams.payment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')
    • Add support for new value custom on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
    • Add support for amount_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentUpdateParams
    • Add support for payment_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
    • Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.amount_details
    • Add support for name_collection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
    • Add support for new value mb_way on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
    • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, and Refund.destination_details
    • Add support for mb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
    • Add support for custom on PaymentMethodCreateParams and PaymentMethod
    • Add support for excluded_payment_method_types on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
    • Add support for tw on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
    • Add support for gip on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
    • Add support for last_seen_at on Terminal.Reader
    • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
    • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for gt, gte, lt, lte, and types on V2.Core.EventListParams
    • Change V2.Core.EventListParams.object_id to be optional
    • Add support for snapshot event BalanceSettingsUpdatedEvent with resource BalanceSettings
    • Add support for snapshot event InvoicePaymentAttemptRequiredEvent with resource Invoice
    • Add support for error code payment_intent_rate_limit_exceeded on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

Oct 23, 2025
  • #2471 Update generated code for private-preview
    • Add support for new resource V2.Billing.PricingPlanSubscriptionComponents
    • Add support for retrieve method on resource V2.Billing.PricingPlanSubscriptionComponents
    • Add support for dimension_payload_keys on Billing.MeterCreateParams and Billing.Meter
    • Add support for dimension_filters and dimension_group_by_keys on Billing.MeterListMeterEventSummariesParams
    • Add support for dimensions on Billing.MeterEventSummary
    • Add support for fulfillment_details and payment_method_data on DelegatedCheckout.RequestedSessionCreateParams and DelegatedCheckout.RequestedSessionUpdateParams
    • Add support for line_item_details, metadata, payment_method, and shared_metadata on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSession
    • Add support for currency, customer, and risk_details on DelegatedCheckout.RequestedSessionCreateParams
    • Add support for seller_details and setup_future_usage on DelegatedCheckout.RequestedSessionCreateParams and DelegatedCheckout.RequestedSession
    • Add support for amount_subtotal, amount_total, created_at, expires_at, order_details, shared_payment_issued_token, status, total_details, and updated_at on DelegatedCheckout.RequestedSession
    • Add support for address, email, fulfillment_options, name, phone, and selected_fulfillment_option on DelegatedCheckout.RequestedSession.fulfillment_details
    • Add support for new values billie, crypto, kr_card, kriya, mb_way, mondu, ng_bank_transfer, ng_bank, ng_card, ng_market, ng_ussd, ng_wallet, payco, paypay, rechnung, samsung_pay, satispay, scalapay, sequra, sunbit, us_bank_account, and vipps on enums EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.payment_method_type, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.payment_method_type, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact.payment_method_type, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact.payment_method_type

See the changelog for more details.

Oct 17, 2025
  • #2463 Update generated code for private-preview
    • Add support for new resources DelegatedCheckout.RequestedSession and Identity.BlocklistEntry
    • Add support for confirm, create, expire, retrieve, and update methods on resource DelegatedCheckout.RequestedSession
    • Add support for create, disable, list, and retrieve methods on resource Identity.BlocklistEntry
    • Add support for blocked_by_entry on Identity.VerificationReport.document, Identity.VerificationReport.selfie, and Identity.VerificationReportListParams

See the changelog for more details.

Latest
v22.1.0-beta.3
Tracking Since
Oct 17, 2023
Last checked Apr 21, 2026