v15.0.1

• #1786 Fix encoding two-dimensional array request params
• #1785 Improve types for metadata and other dict-like types
• #1780 Fix str / repr for StripeObjects with decimals & add support for plain dicts

See the changelog for more details.

v15.1.0b1

This release changes the pinned API version to 2026-03-25.preview. It is built on top of SDK version 15.0.0 which contains breaking changes. Please review the changelog for 15.0.0 if upgrading from older SDK versions.

• #1774 Update generated code for beta
• #1772 Update generated code for beta
  • Release specs are identical.
• #1742 Update generated code for beta
  • Add support for new resources product_catalog.TrialOffer, tax.Location, and v2.core.BatchJob
  • Add support for create method on resource product_catalog.TrialOffer
  • Add support for create, list, and retrieve methods on resource tax.Location
  • Add support for cancel, create, and retrieve methods on resource v2.core.BatchJob
  • Add support for performance_location on Tax.CalculationLineItem and tax.CalculationCreateParamsLineItem
  • ⚠️ Add support for new value performance on enums Tax.Calculation.ShippingCost.TaxBreakdown.sourcing, Tax.CalculationLineItem.TaxBreakdown.sourcing, and Tax.Transaction.ShippingCost.TaxBreakdown.sourcing
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Calculation.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type, Tax.Calculation.TaxBreakdown.TaxRateDetail.tax_type, Tax.CalculationLineItem.TaxBreakdown.TaxRateDetail.tax_type, and Tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type
  • Add support for trial_offer on InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAdd, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSet, InvoiceCreatePreviewParamsScheduleDetailPhaseItem, QuoteCreateParamsLineActionAddItem, QuoteCreateParamsLineActionSetItem, QuoteLine.Action.AddItem, QuoteLine.Action.SetItem, QuoteModifyParamsLineActionAddItem, QuoteModifyParamsLineActionSetItem, QuotePreviewSubscriptionSchedule.Phase.Item, SubscriptionSchedule.Phase.Item, SubscriptionScheduleAmendParamsAmendmentItemActionAdd, SubscriptionScheduleAmendParamsAmendmentItemActionSet, SubscriptionScheduleCreateParamsPhaseItem, and SubscriptionScheduleModifyParamsPhaseItem
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for source_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalance
  • Add support for tax_details on InvoiceAddLinesParamsLinePriceDatumProductDatum, InvoiceLineItemModifyParamsPriceDatumProductDatum, InvoiceUpdateLinesParamsLinePriceDatumProductDatum, PaymentLinkCreateParamsLineItemPriceDatumProductDatum, PlanCreateParamsProduct, PriceCreateParamsProductDatum, ProductCreateParams, ProductModifyParams, checkout.SessionCreateParamsLineItemPriceDatumProductDatum, and checkout.SessionModifyParamsLineItemPriceDatumProductDatum
  • Add support for pending_invoice_item_interval on checkout.SessionModifyParamsSubscriptionDatum
  • Add support for hosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParams
  • Add support for url on FinancialConnections.Session
  • Add support for expires_after_seconds on Invoice.PaymentSetting.PaymentMethodOption.Pix, InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix, InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix, Subscription.PaymentSetting.PaymentMethodOption.Pix, SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionPix
  • Add support for current_trial on InvoiceCreatePreviewParamsSubscriptionDetailItem, SubscriptionCreateParamsItem, SubscriptionItemCreateParams, SubscriptionItemModifyParams, SubscriptionItem, and SubscriptionModifyParamsItem
  • Add support for surcharge on PaymentIntent.AmountDetail, PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetail
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for mandate_options on PaymentIntent.PaymentMethodOption.StripeBalance
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripe_balance on SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, and SetupIntentModifyParamsPaymentMethodOption
  • Add support for billing_cycle_anchor on Subscription.TrialSetting.EndBehavior, SubscriptionCreateParamsTrialSettingEndBehavior, and SubscriptionModifyParamsTrialSettingEndBehavior
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.type
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.CountryOption.Me
  • Add support for requirements on TaxCode
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.Card.MandateOption.amount, V2.Billing.CollectionSetting.PaymentMethodOption.Card.MandateOption.amount, V2.Billing.CollectionSettingVersion.PaymentMethodOption.Card.MandateOption.amount, v2.billing.CollectionSettingCreateParamsPaymentMethodOptionCardMandateOption.amount, and v2.billing.CollectionSettingModifyParamsPaymentMethodOptionCardMandateOption.amount from longInteger to int64_string
  • ⚠️ Add support for new values ar_bank_account, co_bank_account, and eg_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
  • Add support for timezone on V2.Core.Account.Default, v2.core.AccountCreateParamsDefault, and v2.core.AccountModifyParamsDefault
  • Add support for azure_event_grid on V2.Core.EventDestination and v2.core.EventDestinationCreateParams
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.StatusDetail.Disabled.reason
  • ⚠️ Add support for new value azure_event_grid on enums V2.Core.EventDestination.type and v2.core.EventDestinationCreateParams.type
  • Add support for supported_currencies on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.Card
  • ⚠️ Change V2.Core.Vault.GbBankAccount.sort_code and v2.core.vault.GbBankAccountCreateParams.sort_code to be optional
  • Add support for restricted on V2.MoneyManagement.PayoutMethod
  • Add support for currencies on V2.MoneyManagement.PayoutMethodsBankAccountSpec.Country.Field
  • Add support for counterparty and description on V2.MoneyManagement.Transaction
  • ⚠️ Add support for currency on v2.core.vault.GbBankAccountCreateParams, v2.core.vault.UsBankAccountCreateParams, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumBankAccount, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumCard, v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumBankAccount, and v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumCard
  • Add support for iban on v2.core.vault.GbBankAccountCreateParams
  • Change v2.core.vault.GbBankAccountCreateParams.account_number to be optional
  • ⚠️ Add support for new value currency on enum InvalidPaymentMethodError.invalid_param
  • Add support for event notifications V2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object v2.core.BatchJob
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on QuotePreviewInvoice.LastFinalizationError
• #1765 Merge to beta
• #1753 Merge to beta
• #1745 Merge to beta
• #1713 Delete API_VERSION file as it is no longer needed

See the changelog for more details.

v15.1.0a1

This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.

• #1776 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for financial_account_rewards and nesting_demo on AccountSession.Component
  • Add support for upi_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapability
  • Add support for risk_signals on Account
  • Add support for fraud_intent on AccountSignals
  • ⚠️ Add support for new value related_accounts on enum AccountSignals.Delinquency.Indicator.indicator
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for billable_items on Billing.Alert.SpendThreshold.Filter
  • Add support for upi on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, Mandate.PaymentMethodDetail, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOption
  • ⚠️ Add support for new value tempo on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.network
  • ⚠️ Remove support for source_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalance
  • Add support for integration_identifier on Checkout.Session and checkout.SessionCreateParams
  • ⚠️ Add support for new value application on enums Checkout.Session.AutomaticTax.Liability.type, Checkout.Session.InvoiceCreation.InvoiceDatum.Issuer.type, Invoice.AutomaticTax.Liability.type, Invoice.Issuer.type, InvoiceCreateParamsAutomaticTaxLiability.type, InvoiceCreateParamsIssuer.type, InvoiceCreatePreviewParamsAutomaticTaxLiability.type, InvoiceCreatePreviewParamsIssuer.type, InvoiceCreatePreviewParamsScheduleDetailPhaseAutomaticTaxLiability.type, InvoiceCreatePreviewParamsScheduleDetailPhaseInvoiceSettingIssuer.type, InvoiceModifyParamsAutomaticTaxLiability.type, InvoiceModifyParamsIssuer.type, PaymentLink.AutomaticTax.Liability.type, PaymentLink.InvoiceCreation.InvoiceDatum.Issuer.type, PaymentLink.SubscriptionDatum.InvoiceSetting.Issuer.type, PaymentLinkCreateParamsAutomaticTaxLiability.type, PaymentLinkCreateParamsInvoiceCreationInvoiceDatumIssuer.type, PaymentLinkCreateParamsSubscriptionDatumInvoiceSettingIssuer.type, PaymentLinkModifyParamsAutomaticTaxLiability.type, PaymentLinkModifyParamsInvoiceCreationInvoiceDatumIssuer.type, PaymentLinkModifyParamsSubscriptionDatumInvoiceSettingIssuer.type, Quote.AutomaticTax.Liability.type, Quote.InvoiceSetting.Issuer.type, QuoteCreateParamsAutomaticTaxLiability.type, QuoteCreateParamsInvoiceSettingIssuer.type, QuoteModifyParamsAutomaticTaxLiability.type, QuoteModifyParamsInvoiceSettingIssuer.type, QuotePreviewInvoice.AutomaticTax.Liability.type, QuotePreviewInvoice.Issuer.type, QuotePreviewSubscriptionSchedule.DefaultSetting.AutomaticTax.Liability.type, QuotePreviewSubscriptionSchedule.DefaultSetting.InvoiceSetting.Issuer.type, QuotePreviewSubscriptionSchedule.Phase.AutomaticTax.Liability.type, QuotePreviewSubscriptionSchedule.Phase.InvoiceSetting.Issuer.type, Subscription.AutomaticTax.Liability.type, Subscription.InvoiceSetting.Issuer.type, SubscriptionCreateParamsAutomaticTaxLiability.type, SubscriptionCreateParamsInvoiceSettingIssuer.type, SubscriptionModifyParamsAutomaticTaxLiability.type, SubscriptionModifyParamsInvoiceSettingIssuer.type, SubscriptionSchedule.DefaultSetting.AutomaticTax.Liability.type, SubscriptionSchedule.DefaultSetting.InvoiceSetting.Issuer.type, SubscriptionSchedule.Phase.AutomaticTax.Liability.type, SubscriptionSchedule.Phase.InvoiceSetting.Issuer.type, SubscriptionScheduleCreateParamsDefaultSettingAutomaticTaxLiability.type, SubscriptionScheduleCreateParamsDefaultSettingInvoiceSettingIssuer.type, SubscriptionScheduleCreateParamsPhaseAutomaticTaxLiability.type, SubscriptionScheduleCreateParamsPhaseInvoiceSettingIssuer.type, SubscriptionScheduleModifyParamsDefaultSettingAutomaticTaxLiability.type, SubscriptionScheduleModifyParamsDefaultSettingInvoiceSettingIssuer.type, SubscriptionScheduleModifyParamsPhaseAutomaticTaxLiability.type, SubscriptionScheduleModifyParamsPhaseInvoiceSettingIssuer.type, checkout.SessionCreateParamsAutomaticTaxLiability.type, checkout.SessionCreateParamsInvoiceCreationInvoiceDatumIssuer.type, checkout.SessionCreateParamsSubscriptionDatumInvoiceSettingIssuer.type, checkout.SessionModifyParamsAutomaticTaxLiability.type, checkout.SessionModifyParamsInvoiceCreationInvoiceDatumIssuer.type, and checkout.SessionModifyParamsSubscriptionDatumInvoiceSettingIssuer.type
  • Add support for new value upi on enum checkout.SessionCreateParams.excluded_payment_method_types
  • Change type of InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, PlanCreateParamsProductTaxDetail.tax_code, PriceCreateParamsProductDatumTaxDetail.tax_code, ProductCreateParamsTaxDetail.tax_code, ProductModifyParamsTaxDetail.tax_code, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_code from string to emptyable(string)
  • Add support for crypto on checkout.SessionCreateParamsPaymentMethodOption
  • Add support for new value upi on enum checkout.SessionCreateParams.payment_method_types
  • Add support for pending_invoice_item_interval on checkout.SessionCreateParamsSubscriptionDatum and checkout.SessionModifyParamsSubscriptionDatum
  • ⚠️ Add support for new values elements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_mode
  • ⚠️ Remove support for values custom, embedded, and hosted from enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_mode
  • Change InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, PlanCreateParamsProductTaxDetail.tax_code, PriceCreateParamsProductDatumTaxDetail.tax_code, ProductCreateParamsTaxDetail.tax_code, ProductModifyParamsTaxDetail.tax_code, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_code to be optional
  • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.CurrentAttempt.PaymentMethodDetail
  • ⚠️ Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
  • Add support for new value upi on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Add support for new value upi on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for metadata on CreditNoteCreateParamsLine, CreditNoteLineItem, CreditNotePreviewLinesParamsLine, and CreditNotePreviewParamsLine
  • Add support for new value upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.FulfillmentDetail
  • Add support for line_item_keys on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Digital.DigitalOption and ...

v15.0.0

This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

• ⚠️ Breaking change: #1769 Add decimal_string coercion for v1 and v2 API fields

  • All decimal_string fields changed type from str to decimal.Decimal in both request params and response objects. Code that reads or writes these fields as str will need to use Decimal instead. Affected fields across v1 and v2 APIs:
    • checkout.Session: fx_rate
    • climate.Order: metric_tons; climate.Product: metric_tons_available
    • CreditNoteLineItem: unit_amount_decimal
    • InvoiceItem: quantity_decimal, unit_amount_decimal
    • InvoiceLineItem: quantity_decimal, unit_amount_decimal
    • issuing.Authorization / issuing.Transaction (and TestHelpers): quantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimal
    • Plan: amount_decimal, flat_amount_decimal, unit_amount_decimal
    • Price: unit_amount_decimal, flat_amount_decimal (including currency_options and tiers)
    • v2.core.Account / v2.core.AccountPerson: percent_ownership
    • Request params on Invoice, Product, Quote, Subscription, SubscriptionItem, SubscriptionSchedule, PaymentLink: unit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)

• ⚠️ Breaking change:#1767 Throw an error when using the wrong webhook parsing method

• ⚠️ Breaking change: #1764 Drop support for Python 3.7 & 3.8

• ⚠️ Breaking change: #1762 StripeObject no longer inherits from dict

  • StripeObject no longer inherits from dict, so any dict methods will no longer exist, including .get(), .update(), and notably, .items().
  • or convenience, it's still possible to check presence with 'some_key' in some_obj and check for equality between stripe objects. But most key/value iteration needs an extra step
  • To access the underlying data as a dict, call some_obj.to_dict(), which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output of to_dict() won't affect the original object.
  • Write operations can still be done with dot notation (some_obj.val = 123) or bracket notation (some_obj["val"] = 123). Do that instead of trying to interact with the underlying data store, as the implementation is considered private and may change without warning in the future.

See the changelog for more details.

v14.5.0a4

• #1760 Update generated code for private-preview
  • Add support for simulate_crypto_deposit test helper method on resource PaymentIntent
  • Add support for deposit_options and mode on PaymentIntent.PaymentMethodOption.Crypto, PaymentIntentConfirmParamsPaymentMethodOptionCrypto, PaymentIntentCreateParamsPaymentMethodOptionCrypto, and PaymentIntentModifyParamsPaymentMethodOptionCrypto
  • Add support for crypto_display_details on PaymentIntent.NextAction
• #1755 Update generated code for private-preview
  • Add support for new resources orchestration.PaymentAttempt and radar.CustomerEvaluation
  • Add support for retrieve method on resource orchestration.PaymentAttempt
  • Add support for create and modify methods on resource radar.CustomerEvaluation
  • Add support for approve method on resource checkout.Session
  • Add support for report_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecord
  • Add support for create_us_paper_check_on_application on AccountSessionCreateParamsComponentCheckScanningFeature
  • ⚠️ Change AccountSignals.delinquency to be optional
  • Add support for approval_method on Checkout.Session and checkout.SessionCreateParams
  • Add support for current_attempt on Checkout.Session
  • Add support for selected_fulfillment_option_overrides on delegated_checkout.RequestedSessionModifyParamsFulfillmentDetail
  • Add support for pricing_plan_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parent
  • ⚠️ Remove support for license_fee_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parent
  • ⚠️ Remove support for pricing_plan_subscription and pricing_plan_version on InvoiceItem.Parent.RateCardSubscriptionDetail and InvoiceLineItem.Parent.RateCardSubscriptionDetail
  • Add support for new value pricing_plan_subscription_details on enum InvoiceItem.Parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceItem.Parent.type
  • Add support for new value discounts on enum InvoiceItem.frozen_fields
  • Add support for new value pricing_plan_subscription_details on enum InvoiceLineItem.Parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceLineItem.Parent.type
  • Add support for token_details on Issuing.Authorization
  • Add support for failure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParamsFailed, and PaymentRecordReportPaymentParamsFailed
  • Change PaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optional
  • Change PaymentRecordReportPaymentAttemptFailedParams.failed_at to be optional
  • Change PaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optional
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • ⚠️ Remove support for value now from enums QuoteCreateParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, QuoteCreateParamsSubscriptionDatumBillingScheduleBillFrom.type, QuoteModifyParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, and QuoteModifyParamsSubscriptionDatumBillingScheduleBillFrom.type
  • ⚠️ Change radar.IssuingAuthorizationEvaluationCreateParamsCardDetail.bin_country to be required
  • Add support for recurring_interval on shared_payment.GrantedTokenCreateParamsUsageLimit
  • Change shared_payment.GrantedTokenCreateParamsUsageLimit.expires_at to be optional
  • Add support for home_rule_tax on Tax.Registration.CountryOption.Me and tax.RegistrationCreateParamsCountryOptionMe
  • Add support for new value home_rule_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.type

See the changelog for more details.

v14.5.0a3

• #1750 Update generated code for private-preview
  • Add support for new resource radar.IssuingAuthorizationEvaluation
  • Add support for create method on resource radar.IssuingAuthorizationEvaluation
  • Add support for new value fee_credits on enum BalanceTransaction.balance_type
  • ⚠️ Rename affiliate_attributions to affiliate_attribution on delegated_checkout.RequestedSessionConfirmParams and delegated_checkout.RequestedSessionCreateParams
  • Add support for amount_to_counter on Dispute
  • Add support for frozen_fields on InvoiceItem
  • Add support for new value next_billing_period_start on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.type
  • Add support for consumer on V2.Core.Account.Configuration.CardCreator.Capability, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator, v2.core.AccountCreateParamsConfigurationCardCreatorCapability, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreator, v2.core.AccountModifyParamsConfigurationCardCreatorCapability, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreator
  • Add support for fifth_third on V2.Core.Account.Configuration.CardCreator.Capability.Commercial, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercial, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercial, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercial, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercial
  • Add support for prepaid_card on V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial.CrossRiverBank, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercialCrossRiverBank, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBank, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercialCrossRiverBank, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBank
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for payment_method_data on v2.payments.OffSessionPaymentCreateParams
  • Change v2.payments.OffSessionPaymentCreateParams.payment_method to be optional
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

v14.4.1

• #1748 Add Stripe-Request-Trigger header
• #1743 Add agent information to UserAgent

See the changelog for more details.

v14.5.0a2

This release changes the pinned API version to 2026-03-04.preview.

• #1741 Update generated code for private-preview
  • Add support for new resources Profile and billing.AlertRecovered
  • Add support for reauthorize method on resource PaymentIntent
  • Add support for settings on QuoteLine.Action.AddDiscount, QuoteLine.Action.AddItem.Discount, QuoteLine.Action.SetDiscount, QuoteLine.Action.SetItem.Discount, QuotePreviewSubscriptionSchedule.Phase.Discount, QuotePreviewSubscriptionSchedule.Phase.Item.Discount, SubscriptionSchedule.Phase.Discount, and SubscriptionSchedule.Phase.Item.Discount
  • Add support for smart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchant
  • Add support for email_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPayment
  • Add support for balance_update_details on Billing.CreditBalanceSummary.Balance
  • Add support for reauthorization and reauthorize_before on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.Card, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.CardPresent
  • Add support for location and reader on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.InteracPresent, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.InteracPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentRecord.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.InteracPresent
  • Add support for managed_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParams
  • Add support for new value lk_vat on enums Checkout.Session.CollectedInformation.TaxId.type, Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Order.TaxDetail.TaxId.type, QuotePreviewInvoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • Add support for new value lk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, OrderCreateParamsTaxDetailTaxId.type, OrderModifyParamsTaxDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.type
  • Add support for digital on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption, DelegatedCheckout.RequestedSession.FulfillmentDetail.SelectedFulfillmentOption, and delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption
  • Change delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption.shipping to be optional
  • Add support for affiliate_attributions on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionConfirmParams, and delegated_checkout.RequestedSessionCreateParams
  • Add support for fulfillment_type on DelegatedCheckout.RequestedSession.LineItemDetail
  • Add support for marketplace_seller_details, network_profile, privacy_notice_url, return_policy_url, store_policy_url, and terms_of_service_url on DelegatedCheckout.RequestedSession.SellerDetail
  • Add support for amount_to_counter on DisputeModifyParams
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.type
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purpose
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purpose
  • Add support for new value pay_by_bank on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for display_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebit
  • ⚠️ Change type of PaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)
  • Change type of PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to string
  • Add support for request_reauthorization on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntent.PaymentMethodOption.Card, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCard
  • Add support for transaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccount
  • Add support for new value requires_reauthorization on enum PaymentIntent.status
  • Add support for optional_items on PaymentLinkModifyParams
  • Add support for new value billing_schedules_invalid on enum Quote.StatusDetail.Stale.LastReason.type
  • ⚠️ Remove support for card_issuer_decline on Radar.PaymentEvaluation.Insight
  • Add support for payment_behavior on SubscriptionItemDeleteParams
  • Add support for billing_cycle_anchor on Subscription.TrialSetting.EndBehavior
  • Add support for lk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOption
  • Add support for cellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParams
  • Add support for new values simulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_type
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events
  • Add support for new value 2026-02-25.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for new values ar_bank_account, bt_bank_account, co_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enums V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type and V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
  • Add support for recipient_onboarding and recipient_update on V2.Core.AccountLink.UseCase and v2.core.AccountLinkCreateParamsUseCase
  • Add support for new values recipient_onboarding and recipient_update on enums V2.Core.AccountLink.UseCase.type and v2.core.AccountLinkCreateParamsUseCase.type
  • Add support for consumer on V2.Core.Account.Configuration.Storer.Capability, v2.core.AccountCreateParamsConfigurationStorerCapability, and v2.core.AccountModifyParamsConfigurationStorerCapability
  • Add support for new value consumer.holds_currencies.usd on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for funds_usage_type on V2.MoneyManagement.FinancialAccount.Storage and v2.money_management.FinancialAccountCreateParamsStorage
  • Add support for purpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParams
  • Add support for branch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccount
  • Add support for new values dispute, inbound_payment_failure, inbound_payment, india_mdr_processing_fee, payment_method_passthrough_fee, refund, and tax_withholding on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
  • ⚠️ Remove support for values charge_failure and charge from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
  • ⚠️ Change V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optional
  • Add support for new value consumer.holds_currencies.usd on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
  • Add support for snapshot event billing.alert.recovered with resource billing.AlertRecovered
  • Add support for snapshot events `reserve.hold...

v14.5.0b1

This release changes the pinned API version to 2026-02-25.preview.

• #1727 Update generated code for beta
  • Add support for smart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchant
  • Add support for email_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPayment
  • Add support for managed_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParams
  • Add support for new value lk_vat on enums Checkout.Session.CollectedInformation.TaxId.type, Order.TaxDetail.TaxId.type, and QuotePreviewInvoice.CustomerTaxId.type
  • Add support for new value lk_vat on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.type
  • Add support for new value pay_by_bank on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
  • Add support for new values bt_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
  • Add support for purpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParams
  • Add support for branch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccount
  • Change V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optional
  • Add support for error codes storer_capability_missing and storer_capability_not_active on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

v14.5.0a1

This release changes the pinned API version to 2026-02-25.preview.

• #1735 Update generated code for private-preview
  • Add support for new resource AccountSignals
  • Add support for retrieve method on resource AccountSignals
  • Add support for aggregation_period, group_by, and triggered_at on Billing.AlertTriggered
  • Add support for external_account_collection on AccountLinkCreateParamsCollectionOption
  • Add support for funding_source on ApplicationFee
  • Change delegated_checkout.RequestedSessionConfirmParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsFulfillmentDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailAddress.line1, and delegated_checkout.RequestedSessionModifyParamsPaymentMethodDatumBillingDetailAddress.line1 to be optional
  • Add support for hosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParams
  • Add support for url on FinancialConnections.Session
  • Add support for billing_cycle_anchor on SubscriptionCreateParamsTrialSettingEndBehavior and SubscriptionModifyParamsTrialSettingEndBehavior

See the changelog for more details.