NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #470 most downloaded on PyPI
Python bindings for the Stripe API
Latest stable
17.0.0
Last release 4 days ago
11 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
15 years old
593 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
See the changelog for more details.
This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migra…
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
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:
fx_ratemetric_tons; climate.Product: metric_tons_availableunit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimalamount_decimal, flat_amount_decimal, unit_amount_decimalunit_amount_decimal, flat_amount_decimal (including currency_options and tiers)percent_ownershipunit_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().'some_key' in some_obj and check for equality between stripe objects. But most key/value iteration needs an extra stepdict, 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.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.Your coding agent can read these notes before it upgrades. Set up the MCP server →
This release changes the pinned API version to 2026-03-25.dahlia.
This release 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.
StripeObject no longer inherits from dict
StripeObject no longer inherits from dict, so any dict methods will no longer exist, including .get() and notably, .items().
'some_key' in some_obj. To replicate .get() behavior, use getattr(obj, 'some_key', None) for now. We've got some improvements around accessing properties that may not be present planned, but getattr works for now..update() has been retained for easier interaction with metadata, but it's not really intended for use on full objects.StripeObjects still works: it checks for equality between the same class and underlying data.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.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.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:
fx_ratemetric_tons; climate.Product: metric_tons_availableunit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimalamount_decimal, flat_amount_decimal, unit_amount_decimalunit_amount_decimal, flat_amount_decimal (including currency_options and tiers)percent_ownershipunit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)upi_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapabilityupi 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.SessionCreateParamsPaymentMethodOptiontempo on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.networkintegration_identifier on Checkout.Session and checkout.SessionCreateParamsupi on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, SetupIntentModifyParams.excluded_payment_method_types, and checkout.SessionCreateParams.excluded_payment_method_typescrypto on checkout.SessionCreateParamsPaymentMethodOptionupi on enum checkout.SessionCreateParams.payment_method_typespending_invoice_item_interval on checkout.SessionCreateParamsSubscriptionDatumelements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_modemarine_carbon_removal on enum Climate.Supplier.removal_pathwayupi on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.typeupi on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typemetadata on CreditNoteCreateParamsLine, CreditNoteLineItem, CreditNotePreviewLinesParamsLine, and CreditNotePreviewParamsLineupi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typequantity_decimal on InvoiceAddLinesParamsLine, InvoiceCreatePreviewParamsInvoiceItem, InvoiceItemCreateParams, InvoiceItemModifyParams, InvoiceItem, InvoiceLineItemModifyParams, InvoiceLineItem, and InvoiceUpdateLinesParamsLinelevel on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRiskrisk_level on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisklifecycle_controls on Issuing.Card and issuing.CardCreateParamsIssuing.Token.NetworkDatum.Visa.card_reference_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.brand and PaymentRecord.PaymentMethodDetail.Card.brand from enum to nullable(enum)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_month and PaymentRecord.PaymentMethodDetail.Card.exp_month from longInteger to nullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_year and PaymentRecord.PaymentMethodDetail.Card.exp_year from longInteger to nullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.funding and PaymentRecord.PaymentMethodDetail.Card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))PaymentAttemptRecord.PaymentMethodDetail.Card.last4 and PaymentRecord.PaymentMethodDetail.Card.last4 from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.moto and PaymentRecord.PaymentMethodDetail.Card.moto from boolean to nullable(boolean)cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure and PaymentRecord.PaymentMethodDetail.Card.ThreeDSecureupi_handle_redirect_or_display_qr_code on PaymentIntent.NextAction and SetupIntent.NextActionupi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_typesrecommended_action and signals on Radar.PaymentEvaluationinsights on Radar.PaymentEvaluationcrypto_fingerprint on enums Radar.ValueList.item_type and radar.ValueListCreateParams.item_typecanceled_by_retention_policy on enum Subscription.CancellationDetail.reason2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_versionV2.Core.EventDestination.events_from and v2.core.EventDestinationCreateParams.events_from from enum('other_accounts'|'self') to stringservice_period_coupon_with_metered_tiered_item_unsupported on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2026-02-25.preview.
This release changes the pinned API version to 2026-02-25.preview.
smart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchantemail_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPaymentmanaged_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParamslk_vat on enums Checkout.Session.CollectedInformation.TaxId.type, Order.TaxDetail.TaxId.type, and QuotePreviewInvoice.CustomerTaxId.typelk_vat on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.typepay_by_bank on enum QuotePreviewInvoice.PaymentSetting.payment_method_typesbt_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.typepurpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParamsbranch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccountV2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optionalstorer_capability_missing and storer_capability_not_active on QuotePreviewInvoice.LastFinalizationErrorAdd support for simulate_crypto_deposit test helper method on resource PaymentIntent
simulate_crypto_deposit test helper method on resource PaymentIntentdeposit_options and mode on PaymentIntent.PaymentMethodOption.Crypto, PaymentIntentConfirmParamsPaymentMethodOptionCrypto, PaymentIntentCreateParamsPaymentMethodOptionCrypto, and PaymentIntentModifyParamsPaymentMethodOptionCryptocrypto_display_details on PaymentIntent.NextActionorchestration.PaymentAttempt and radar.CustomerEvaluationretrieve method on resource orchestration.PaymentAttemptcreate and modify methods on resource radar.CustomerEvaluationapprove method on resource checkout.Sessionreport_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecordcreate_us_paper_check_on_application on AccountSessionCreateParamsComponentCheckScanningFeatureAccountSignals.delinquency to be optionalapproval_method on Checkout.Session and checkout.SessionCreateParamscurrent_attempt on Checkout.Sessionselected_fulfillment_option_overrides on delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailpricing_plan_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parentlicense_fee_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parentpricing_plan_subscription and pricing_plan_version on InvoiceItem.Parent.RateCardSubscriptionDetail and InvoiceLineItem.Parent.RateCardSubscriptionDetailpricing_plan_subscription_details on enum InvoiceItem.Parent.typelicense_fee_subscription_details from enum InvoiceItem.Parent.typediscounts on enum InvoiceItem.frozen_fieldspricing_plan_subscription_details on enum InvoiceLineItem.Parent.typelicense_fee_subscription_details from enum InvoiceLineItem.Parent.typetoken_details on Issuing.Authorizationfailure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParamsFailed, and PaymentRecordReportPaymentParamsFailedPaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optionalPaymentRecordReportPaymentAttemptFailedParams.failed_at to be optionalPaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optionalPaymentRecordReportRefundParams.refunded to be optionalnow from enums QuoteCreateParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, QuoteCreateParamsSubscriptionDatumBillingScheduleBillFrom.type, QuoteModifyParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, and QuoteModifyParamsSubscriptionDatumBillingScheduleBillFrom.typeradar.IssuingAuthorizationEvaluationCreateParamsCardDetail.bin_country to be requiredrecurring_interval on shared_payment.GrantedTokenCreateParamsUsageLimitshared_payment.GrantedTokenCreateParamsUsageLimit.expires_at to be optionalhome_rule_tax on Tax.Registration.CountryOption.Me and tax.RegistrationCreateParamsCountryOptionMehome_rule_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.typeAdd support for new resource radar.IssuingAuthorizationEvaluation
radar.IssuingAuthorizationEvaluationcreate method on resource radar.IssuingAuthorizationEvaluationfee_credits on enum BalanceTransaction.balance_typeaffiliate_attributions to affiliate_attribution on delegated_checkout.RequestedSessionConfirmParams and delegated_checkout.RequestedSessionCreateParamsamount_to_counter on Disputefrozen_fields on InvoiceItemnext_billing_period_start on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.typeconsumer 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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorfifth_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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialprepaid_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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBankcommercial.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.capabilitypayment_method_data on v2.payments.OffSessionPaymentCreateParamsv2.payments.OffSessionPaymentCreateParams.payment_method to be optionalcommercial.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_capabilityThis release changes the pinned API version to 2026-03-04.preview.
This release changes the pinned API version to 2026-03-04.preview.
Profile and billing.AlertRecoveredreauthorize method on resource PaymentIntentsettings 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.Discountsmart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchantemail_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPaymentbalance_update_details on Billing.CreditBalanceSummary.Balancereauthorization 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.CardPresentlocation 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.InteracPresentmanaged_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParamslk_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.typelk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, OrderCreateParamsTaxDetailTaxId.type, OrderModifyParamsTaxDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typedigital on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption, DelegatedCheckout.RequestedSession.FulfillmentDetail.SelectedFulfillmentOption, and delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOptiondelegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption.shipping to be optionalaffiliate_attributions on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionConfirmParams, and delegated_checkout.RequestedSessionCreateParamsfulfillment_type on DelegatedCheckout.RequestedSession.LineItemDetailmarketplace_seller_details, network_profile, privacy_notice_url, return_policy_url, store_policy_url, and terms_of_service_url on DelegatedCheckout.RequestedSession.SellerDetailamount_to_counter on DisputeModifyParamsreserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_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_typesdisplay_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebitPaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to stringrequest_reauthorization on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntent.PaymentMethodOption.Card, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardtransaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccountrequires_reauthorization on enum PaymentIntent.statusoptional_items on PaymentLinkModifyParamsbilling_schedules_invalid on enum Quote.StatusDetail.Stale.LastReason.typecard_issuer_decline on Radar.PaymentEvaluation.Insightpayment_behavior on SubscriptionItemDeleteParamsbilling_cycle_anchor on Subscription.TrialSetting.EndBehaviorlk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptioncellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParamssimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_typereserve.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_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionar_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.typerecipient_onboarding and recipient_update on V2.Core.AccountLink.UseCase and v2.core.AccountLinkCreateParamsUseCaserecipient_onboarding and recipient_update on enums V2.Core.AccountLink.UseCase.type and v2.core.AccountLinkCreateParamsUseCase.typeconsumer on V2.Core.Account.Configuration.Storer.Capability, v2.core.AccountCreateParamsConfigurationStorerCapability, and v2.core.AccountModifyParamsConfigurationStorerCapabilityconsumer.holds_currencies.usd on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilityfunds_usage_type on V2.MoneyManagement.FinancialAccount.Storage and v2.money_management.FinancialAccountCreateParamsStoragepurpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParamsbranch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccountdispute, 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.categorycharge_failure and charge from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.categoryV2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optionalconsumer.holds_currencies.usd on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capabilitybilling.alert.recovered with resource billing.AlertRecoveredreserve.hold.created and reserve.hold.updated with resource reserve.Holdreserve.plan.created, reserve.plan.disabled, reserve.plan.expired, and reserve.plan.updated with resource reserve.Planreserve.release.created with resource reserve.ReleaseV2BillingRateCardCustomPricingUnitOverageRateCreatedEvent with related object v2.billing.RateCardCustomPricingUnitOverageRateV2IamStripeAccessGrantApprovedEvent, V2IamStripeAccessGrantCanceledEvent, V2IamStripeAccessGrantDeniedEvent, V2IamStripeAccessGrantRemovedEvent, V2IamStripeAccessGrantRequestedEvent, and V2IamStripeAccessGrantUpdatedEventstorer_capability_missing and storer_capability_not_active on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2026-02-25.preview.
This release changes the pinned API version to 2026-02-25.preview.
AccountSignalsretrieve method on resource AccountSignalsaggregation_period, group_by, and triggered_at on Billing.AlertTriggeredexternal_account_collection on AccountLinkCreateParamsCollectionOptionfunding_source on ApplicationFeedelegated_checkout.RequestedSessionConfirmParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsFulfillmentDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailAddress.line1, and delegated_checkout.RequestedSessionModifyParamsPaymentMethodDatumBillingDetailAddress.line1 to be optionalhosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParamsurl on FinancialConnections.Sessionbilling_cycle_anchor on SubscriptionCreateParamsTrialSettingEndBehavior and SubscriptionModifyParamsTrialSettingEndBehaviorReplace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
See the changelog for more details.
This release changes the pinned API version to 2026-02-25.clover.
This release changes the pinned API version to 2026-02-25.clover.
reserve.Hold, reserve.Plan, and reserve.Releaselocation 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.InteracPresentlk_vat on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typelk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_by_bank on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typesdisplay_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebitPaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to stringtransaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccountoptional_items on PaymentLinkModifyParamscard_issuer_decline on Radar.PaymentEvaluation.Insightpayment_behavior on SubscriptionItemDeleteParamslk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptioncellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParamssimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_typereserve.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_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionreserve.hold.created and reserve.hold.updated with resource reserve.Holdreserve.plan.created, reserve.plan.disabled, reserve.plan.expired, and reserve.plan.updated with resource reserve.Planreserve.release.created with resource reserve.Releasestorer_capability_missing and storer_capability_not_active on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2026-01-28.preview.
This release changes the pinned API version to 2026-01-28.preview.
financial_connections.Authorizationretrieve method on resource financial_connections.Authorizationdetach_payment method on resource Invoicecancel, list_line_items, and reopen methods on resource Orderattach_cadence method on resource Subscriptionadditional_files and site on Account.Setting.PaypayPayment, AccountCreateParamsSettingPaypayPayment, and AccountModifyParamsSettingPaypayPaymentcapital on Account.SettingCharge.PaymentMethodDetail.StripeBalance.source_type, ConfirmationToken.PaymentMethodPreview.StripeBalance.source_type, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance.source_type, PaymentMethod.StripeBalance.source_type, and PaymentRecord.PaymentMethodDetail.StripeBalance.source_type from enum('bank_account'|'card'|'fpx') to nullable(enum('bank_account'|'card'|'fpx'))pl_nip on enums Checkout.Session.CollectedInformation.TaxId.type, Order.TaxDetail.TaxId.type, and QuotePreviewInvoice.CustomerTaxId.typecapital.financing_summary.line_of_credit_update on enum Event.typeauthorization and status_details on FinancialConnections.Accountrelink_options on FinancialConnections.Session and financial_connections.SessionCreateParamsfinancial_connections.SessionCreateParams.account_holder to be optionalrelink_result on FinancialConnections.Sessionbilling_cadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionModifyParams, and Subscriptionbilling_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parentbilling_cadence_details from enums Invoice.Parent.type and QuotePreviewInvoice.Parent.typepl_nip on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.typecar_rental_data, flight_data, and lodging_data on PaymentIntent.PaymentDetailQuotePreviewInvoice.PaymentSetting.PaymentMethodOption.payto to be requiredcapital.financing_summary.line_of_credit_update on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_eventsae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typealternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethodaccount_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.Credential.UsBankAccountfingerprint on V2.MoneyManagement.PayoutMethod.Cardinvoice_payment.detached with resource InvoicePaymentrequest_blocked on QuotePreviewInvoice.LastFinalizationErrorblocked_payout_method and unsupported_payout_method on BlockedByStripeErrorinvalid_payout_method_data on InvalidPayoutMethodErrorlimit_payout_method on QuotaExceededError⚠️ Add support for new value spend_threshold on enums Billing.Alert.alert_type, billing.AlertCreateParams.alert_type, and billing.AlertListParams.aler
spend_threshold on enums Billing.Alert.alert_type, billing.AlertCreateParams.alert_type, and billing.AlertListParams.alert_typespend_threshold on Billing.Alert and billing.AlertCreateParamsinvoice_item, proration_details, proration, and subscription on InvoiceLineItem.Parent.ScheduleDetailcustom on PaymentMethodModifyParamspayment_method_reference and usage on PaymentMethod.Customoutstanding_usage_through and unused_time_from on SubscriptionPauseParamsBillForoutstanding_usage and unused_time on SubscriptionPauseParamsBillForpayment_behavior on SubscriptionResumeParamsAdd support for new resources v2.billing.CadenceSpendModifier, v2.billing.OneTimeItem, and v2.billing.RateCardCustomPricingUnitOverageRate
v2.billing.CadenceSpendModifier, v2.billing.OneTimeItem, and v2.billing.RateCardCustomPricingUnitOverageRatecreate, delete, list, and retrieve methods on resource v2.billing.RateCardCustomPricingUnitOverageRatecreate, list, modify, and retrieve methods on resource v2.billing.OneTimeItemretrieve method on resource v2.billing.CadenceSpendModifierEventsV2CoreHealthFraudRateIncreasedEvent.Impact.RealizedFraudAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.DeclinedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.DeclinedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.DeclinedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.DeclinedAmount.value, V2.Billing.ServiceAction.CreditGrant.Amount.Monetary.value, V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.Monetary.value, V2.Core.Account.Identity.BusinessDetail.AnnualRevenue.Amount.value, V2.Core.Account.Identity.BusinessDetail.MonthlyEstimatedRevenue.Amount.value, V2.FinancialAddressGeneratedMicrodeposits.Amount.value, V2.MoneyManagement.Adjustment.Amount.value, V2.MoneyManagement.CurrencyConversion.From.Amount.value, V2.MoneyManagement.CurrencyConversion.To.Amount.value, V2.MoneyManagement.FinancialAccount.Balance.Available.value, V2.MoneyManagement.FinancialAccount.Balance.InboundPending.value, V2.MoneyManagement.FinancialAccount.Balance.OutboundPending.value, V2.MoneyManagement.FinancialAccount.Payment.StartingBalance.Available.value, V2.MoneyManagement.InboundTransfer.Amount.value, V2.MoneyManagement.InboundTransfer.From.Debited.value, V2.MoneyManagement.InboundTransfer.To.Credited.value, V2.MoneyManagement.OutboundPayment.Amount.value, V2.MoneyManagement.OutboundPayment.From.Debited.value, V2.MoneyManagement.OutboundPayment.To.Credited.value, V2.MoneyManagement.OutboundPaymentQuote.Amount.value, V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.Amount.value, V2.MoneyManagement.OutboundPaymentQuote.From.Debited.value, V2.MoneyManagement.OutboundPaymentQuote.To.Credited.value, V2.MoneyManagement.OutboundTransfer.Amount.value, V2.MoneyManagement.OutboundTransfer.From.Debited.value, V2.MoneyManagement.OutboundTransfer.To.Credited.value, V2.MoneyManagement.ReceivedCredit.Amount.value, V2.MoneyManagement.ReceivedCredit.ExternalAmount.value, V2.MoneyManagement.ReceivedDebit.Amount.value, V2.MoneyManagement.ReceivedDebit.CardSpend.Authorization.Amount.value, V2.MoneyManagement.ReceivedDebit.CardSpend.CardTransaction.Amount.value, V2.MoneyManagement.ReceivedDebit.ExternalAmount.value, V2.MoneyManagement.Transaction.Amount.value, V2.MoneyManagement.Transaction.BalanceImpact.Available.value, V2.MoneyManagement.Transaction.BalanceImpact.InboundPending.value, V2.MoneyManagement.Transaction.BalanceImpact.OutboundPending.value, V2.MoneyManagement.TransactionEntry.BalanceImpact.Available.value, V2.MoneyManagement.TransactionEntry.BalanceImpact.InboundPending.value, V2.MoneyManagement.TransactionEntry.BalanceImpact.OutboundPending.value, V2.Payments.OffSessionPayment.AmountCapturable.value, V2.Payments.OffSessionPayment.AmountRequested.value, V2.Payments.SettlementAllocationIntent.Amount.value, V2.Payments.SettlementAllocationIntentSplit.Amount.value, v2.FinancialAddressCreditSimulationCreditParamsAmount.value, v2.billing.ServiceActionCreateParamsCreditGrantAmountMonetary.value, v2.billing.ServiceActionCreateParamsCreditGrantPerTenantAmountMonetary.value, v2.core.AccountCreateParamsIdentityBusinessDetailAnnualRevenueAmount.value, v2.core.AccountCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.value, v2.core.AccountModifyParamsIdentityBusinessDetailAnnualRevenueAmount.value, v2.core.AccountModifyParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.value, v2.core.AccountTokenCreateParamsIdentityBusinessDetailAnnualRevenueAmount.value, v2.core.AccountTokenCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.value, v2.money_management.CurrencyConversionCreateParamsFromAmount.value, v2.money_management.CurrencyConversionCreateParamsToAmount.value, v2.money_management.InboundTransferCreateParamsAmount.value, v2.money_management.OutboundPaymentCreateParamsAmount.value, v2.money_management.OutboundPaymentQuoteCreateParamsAmount.value, v2.money_management.OutboundTransferCreateParamsAmount.value, v2.payments.OffSessionPaymentCreateParamsAmount.value, v2.payments.SettlementAllocationIntentCreateParamsAmount.value, v2.payments.SettlementAllocationIntentModifyParamsAmount.value, and v2.payments.SettlementAllocationIntentSplitCreateParamsAmount.value to be requiredEventsV2CoreHealthFraudRateIncreasedEvent.Impact.RealizedFraudAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.DeclinedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.DeclinedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.DeclinedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.DeclinedAmount.currency, V2.Billing.ServiceAction.CreditGrant.Amount.Monetary.currency, V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.Monetary.currency, V2.Core.Account.Identity.BusinessDetail.AnnualRevenue.Amount.currency, V2.Core.Account.Identity.BusinessDetail.MonthlyEstimatedRevenue.Amount.currency, V2.FinancialAddressGeneratedMicrodeposits.Amount.currency, V2.MoneyManagement.Adjustment.Amount.currency, V2.MoneyManagement.CurrencyConversion.From.Amount.currency, V2.MoneyManagement.CurrencyConversion.To.Amount.currency, V2.MoneyManagement.FinancialAccount.Balance.Available.currency, V2.MoneyManagement.FinancialAccount.Balance.InboundPending.currency, V2.MoneyManagement.FinancialAccount.Balance.OutboundPending.currency, V2.MoneyManagement.FinancialAccount.Payment.StartingBalance.Available.currency, V2.MoneyManagement.InboundTransfer.Amount.currency, V2.MoneyManagement.InboundTransfer.From.Debited.currency, V2.MoneyManagement.InboundTransfer.To.Credited.currency, V2.MoneyManagement.OutboundPayment.Amount.currency, V2.MoneyManagement.OutboundPayment.From.Debited.currency, V2.MoneyManagement.OutboundPayment.To.Credited.currency, V2.MoneyManagement.OutboundPaymentQuote.Amount.currency, V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.Amount.currency, V2.MoneyManagement.OutboundPaymentQuote.From.Debited.currency, V2.MoneyManagement.OutboundPaymentQuote.To.Credited.currency, V2.MoneyManagement.OutboundTransfer.Amount.currency, V2.MoneyManagement.OutboundTransfer.From.Debited.currency, V2.MoneyManagement.OutboundTransfer.To.Credited.currency, V2.MoneyManagement.ReceivedCredit.Amount.currency, V2.MoneyManagement.ReceivedCredit.ExternalAmount.currency, V2.MoneyManagement.ReceivedDebit.Amount.currency, V2.MoneyManagement.ReceivedDebit.CardSpend.Authorization.Amount.currency, V2.MoneyManagement.ReceivedDebit.CardSpend.CardTransaction.Amount.currency, V2.MoneyManagement.ReceivedDebit.ExternalAmount.currency, V2.MoneyManagement.Transaction.Amount.currency, V2.MoneyManagement.Transaction.BalanceImpact.Available.currency, V2.MoneyManagement.Transaction.BalanceImpact.InboundPending.currency, V2.MoneyManagement.Transaction.BalanceImpact.OutboundPending.currency, V2.MoneyManagement.TransactionEntry.BalanceImpact.Available.currency, V2.MoneyManagement.TransactionEntry.BalanceImpact.InboundPending.currency, V2.MoneyManagement.TransactionEntry.BalanceImpact.OutboundPending.currency, V2.Payments.OffSessionPayment.AmountCapturable.currency, V2.Payments.OffSessionPayment.AmountRequested.currency, V2.Payments.SettlementAllocationIntent.Amount.currency, V2.Payments.SettlementAllocationIntentSplit.Amount.currency, v2.FinancialAddressCreditSimulationCreditParamsAmount.currency, v2.billing.ServiceActionCreateParamsCreditGrantAmountMonetary.currency, v2.billing.ServiceActionCreateParamsCreditGrantPerTenantAmountMonetary.currency, v2.core.AccountCreateParamsIdentityBusinessDetailAnnualRevenueAmount.currency, v2.core.AccountCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.currency, v2.core.AccountModifyParamsIdentityBusinessDetailAnnualRevenueAmount.currency, v2.core.AccountModifyParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.currency, v2.core.AccountTokenCreateParamsIdentityBusinessDetailAnnualRevenueAmount.currency, v2.core.AccountTokenCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.currency, v2.money_management.CurrencyConversionCreateParamsFromAmount.currency, v2.money_management.CurrencyConversionCreateParamsToAmount.currency, v2.money_management.InboundTransferCreateParamsAmount.currency, v2.money_management.OutboundPaymentCreateParamsAmount.currency, v2.money_management.OutboundPaymentQuoteCreateParamsAmount.currency, v2.money_management.OutboundTransferCreateParamsAmount.currency, v2.payments.OffSessionPaymentCreateParamsAmount.currency, v2.payments.SettlementAllocationIntentCreateParamsAmount.currency, v2.payments.SettlementAllocationIntentModifyParamsAmount.currency, and v2.payments.SettlementAllocationIntentSplitCreateParamsAmount.currency to be requiredsettlement_type on ApplicationFeerate_card_custom_pricing_unit_overage_rate_details on InvoiceItem.Pricing and InvoiceLineItem.Pricingrate_card_custom_pricing_unit_overage_rate_details on enums InvoiceItem.Pricing.type and InvoiceLineItem.Pricing.typedefault_settings on InvoiceCreatePreviewParamsScheduleDetailQuoteModifyParamsSubscriptionDataOverride.billing_schedules from emptyable(array(billing_schedules_update_specs)) to array(billing_schedules_update_specs)payment_behavior on SubscriptionResumeParamseffective_at and spend_modifier_rule on V2.Billing.IntentAction.Apply, V2.Billing.IntentAction.Remove, v2.billing.IntentCreateParamsActionApply, and v2.billing.IntentCreateParamsActionRemoveV2.Billing.IntentAction.Apply.type, V2.Billing.IntentAction.Remove.type, v2.billing.IntentCreateParamsActionApply.type, and v2.billing.IntentCreateParamsActionRemove.type from literal('invoice_discount_rule') to enum('invoice_discount_rule'|'spend_modifier_rule')Add support for new resource v2.core.ConnectionSession
v2.core.ConnectionSessioncreate and retrieve methods on resource v2.core.ConnectionSessionlist method on resources v2.payments.SettlementAllocationIntentSplit and v2.payments.SettlementAllocationIntentagentic_commerce_settings on AccountSessionCreateParamsComponentterminal_hardware_orders and terminal_hardware_shop on AccountSession.Component and AccountSessionCreateParamsComponentnetwork_cost_passthrough_report on AccountSession.Componentae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enums V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type and V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typecadence_data on V2.Billing.Intent and v2.billing.IntentCreateParamscancellation_details on V2.Billing.IntentAction.Deactivate, V2.Billing.PricingPlanSubscription, and v2.billing.IntentCreateParamsActionDeactivatecontact_phone on V2.Core.Account, v2.core.AccountCreateParams, v2.core.AccountModifyParams, and v2.core.AccountTokenCreateParamsregistration_date on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, v2.core.AccountModifyParamsIdentityBusinessDetail, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailgb_vat on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typereference on V2.MoneyManagement.Adjustmentaccrued_fees on V2.MoneyManagement.FinancialAccountstarting_balance on V2.MoneyManagement.FinancialAccount.Paymentaccrued_fees on enum V2.MoneyManagement.FinancialAccount.typeaccount_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.Credential.UsBankAccountfingerprint on V2.MoneyManagement.PayoutMethod.Cardcard_spend on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebitcard_spend on enum V2.MoneyManagement.ReceivedCredit.typecard_spend on enum V2.MoneyManagement.ReceivedDebit.typeadvance, anticipation_repayment, balance_transfer, charge_failure, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, connect_reserved_funds, contribution, dispute_reversal, financing_paydown_reversal, financing_paydown, inbound_transfer_reversal, issuing_dispute_fraud_liability_debit, issuing_dispute_provisional_credit_reversal, issuing_dispute_provisional_credit, issuing_dispute, minimum_balance_hold, network_cost, obligation, outbound_payment_reversal, outbound_transfer_reversal, partial_capture_reversal, payment_network_reserved_funds, platform_earning_refund, platform_earning, platform_fee, received_credit_reversal, received_debit_reversal, refund_failure, risk_reserved_funds, stripe_balance_payment_debit_reversal, stripe_balance_payment_debit, stripe_fee_tax, transfer_reversal, and unreconciled_customer_funds on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.categoryapplication_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on V2.MoneyManagement.Transaction.Flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flowapplication_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on enums V2.MoneyManagement.Transaction.Flow.type and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.typeV2.Payments.SettlementAllocationIntentSplit.flow to be optionalaccrued_fees on enum v2.money_management.FinancialAccountListParams.typesv2.billing.RateCardRateCreateParams.metered_item to be requiredblocked_payout_method and unsupported_payout_method on BlockedByStripeErrorinvalid_payout_method_data on InvalidPayoutMethodErrorlimit_payout_method on QuotaExceededErrorThis release changes the pinned API version to 2026-01-28.preview.
This release changes the pinned API version to 2026-01-28.preview.
FrMealVouchersOnboarding, reserve.Hold, reserve.Plan, and reserve.Releasecreate, list, modify, and retrieve methods on resource FrMealVouchersOnboardinglist and retrieve methods on resources reserve.Hold and reserve.Releaseretrieve method on resource reserve.Planpause method on resource Subscriptionservice_period_details on Discountagentic_commerce_settings on AccountSession.Componentrisk_reserved on enum BalanceTransaction.balance_typeservice_period on enums Coupon.duration, CouponCreateParams.duration, checkout.SessionCreateParamsDiscountCouponDatum.duration, and checkout.SessionModifyParamsDiscountCouponDatum.durationservice_period on CouponCreateParams and CouponInvoiceItem.Pricing.PriceDetail.price and InvoiceLineItem.Pricing.PriceDetail.price from string to expandable($Price)settings on InvoiceCreatePreviewParamsDiscount, InvoiceCreatePreviewParamsScheduleDetailAmendmentDiscountActionAdd, InvoiceCreatePreviewParamsScheduleDetailAmendmentDiscountActionSet, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAddDiscount, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSetDiscount, InvoiceCreatePreviewParamsScheduleDetailPhaseDiscount, InvoiceCreatePreviewParamsScheduleDetailPhaseItemDiscount, InvoiceCreatePreviewParamsSubscriptionDetailItemDiscount, QuoteCreateParamsLineActionAddDiscount, QuoteCreateParamsLineActionAddItemDiscount, QuoteCreateParamsLineActionSetDiscount, QuoteCreateParamsLineActionSetItemDiscount, QuoteModifyParamsLineActionAddDiscount, QuoteModifyParamsLineActionAddItemDiscount, QuoteModifyParamsLineActionSetDiscount, QuoteModifyParamsLineActionSetItemDiscount, SubscriptionCreateParamsDiscount, SubscriptionCreateParamsItemDiscount, SubscriptionItemCreateParamsDiscount, SubscriptionItemModifyParamsDiscount, SubscriptionModifyParamsDiscount, SubscriptionModifyParamsItemDiscount, SubscriptionScheduleAmendParamsAmendmentDiscountActionAdd, SubscriptionScheduleAmendParamsAmendmentDiscountActionSet, SubscriptionScheduleAmendParamsAmendmentItemActionAddDiscount, SubscriptionScheduleAmendParamsAmendmentItemActionSetDiscount, SubscriptionScheduleCreateParamsPhaseDiscount, SubscriptionScheduleCreateParamsPhaseItemDiscount, SubscriptionScheduleModifyParamsPhaseDiscount, and SubscriptionScheduleModifyParamsPhaseItemDiscountsubtotal on InvoiceLineItembilling_cadence on SubscriptionListParamsThis release changes the pinned API version to 2026-01-28.clover.
This release changes the pinned API version to 2026-01-28.clover.
radar.PaymentEvaluationcreate method on resource radar.PaymentEvaluationadjustable_quantity on LineItemrisk_reserved on enum BalanceTransaction.balance_typereserve_hold and reserve_release on enum BalanceTransaction.type2.3.0 and 2.3.1 on enums Charge.PaymentMethodDetail.Card.ThreeDSecure.version, PaymentIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version, PaymentIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, PaymentIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version, SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.version, SetupIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version, SetupIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, and SetupIntentModifyParamsPaymentMethodOptionCardThreeDSecure.versionadyen on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bankADYBNL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bicpl_nip on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typepl_nip on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typeInvoice.PaymentSetting.PaymentMethodOption.payto and Subscription.PaymentSetting.PaymentMethodOption.payto to be requiredenforce_arithmetic_validation on PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetailerror on PaymentIntent.AmountDetailbgn on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTippingtopup on Treasury.ReceivedDebit.LinkedFlowcontact_phone on V2.Core.Account, v2.core.AccountCreateParams, v2.core.AccountModifyParams, and v2.core.AccountTokenCreateParamsregistration_date on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, v2.core.AccountModifyParamsIdentityBusinessDetail, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailgb_vat on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typerequest_blocked on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorRemove support for pause method on resource Subscription
pause method on resource SubscriptionQuote.SubscriptionDataOverride.phase_effective_at and Quote.SubscriptionDatum.phase_effective_at from enum('billing_period_start'|'phase_start') to nullable(enum('billing_period_start'|'phase_start'))Add support for event notifications V2CoreAccountClosedEvent, V2CoreAccountCreatedEvent, V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUp
V2CoreAccountClosedEvent, V2CoreAccountCreatedEvent, V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingDefaultsUpdatedEvent, V2CoreAccountIncludingFutureRequirementsUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, V2CoreAccountIncludingRequirementsUpdatedEvent, and V2CoreAccountUpdatedEvent with related object v2.core.AccountV2CoreAccountLinkReturnedEventV2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object v2.core.AccountPersonThis release changes the pinned API version to 2025-12-15.preview.
This release changes the pinned API version to 2025-12-15.preview.
reserve.Hold, reserve.Plan, and reserve.Releaselist and retrieve methods on resources reserve.Hold and reserve.Releaseretrieve method on resource reserve.PlanBilling.CreditBalanceSummary.customer_account, Billing.CreditGrant.customer_account, BillingPortal.Session.customer_account, CashBalance.customer_account, Checkout.Session.customer_account, ConfirmationToken.PaymentMethodPreview.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.Owner.customer_account, and TaxId.customer_account to be requiredV2.FinancialAddressGeneratedMicrodeposits.amounts from amount to an objectPaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.amount from longInteger to emptyable(longInteger)PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount_type, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount_type, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount_type, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount_type, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount_type, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount_type, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.amount_type from enum('fixed'|'maximum') to emptyable(enum('fixed'|'maximum'))PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.end_date, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.end_date, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.end_date, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.end_date, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.end_date, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.end_date, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.end_date from string to emptyable(string)PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.payment_schedule from enum to emptyable(enum)PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.payments_per_period from longInteger to emptyable(longInteger)PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.purpose, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.purpose, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.purpose, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.purpose, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.purpose, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.purpose, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.purpose from enum to emptyable(enum)SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.start_date, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.start_date, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.start_date, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.start_date from string to emptyable(string)Identity.VerificationSession.related_customer_account to be requiredasync_workflows on PaymentIntentpayto on QuotePreviewInvoice.PaymentSetting.PaymentMethodOptionpayto on enum QuotePreviewInvoice.PaymentSetting.payment_method_typesrequested on V2.Core.Account.Configuration.Customer.Capability.AutomaticIndirectTax, V2.Core.Account.Configuration.Merchant.Capability.AchDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.AcssDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.AffirmPayment, V2.Core.Account.Configuration.Merchant.Capability.AfterpayClearpayPayment, V2.Core.Account.Configuration.Merchant.Capability.AlmaPayment, V2.Core.Account.Configuration.Merchant.Capability.AmazonPayPayment, V2.Core.Account.Configuration.Merchant.Capability.AuBecsDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.BacsDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.BancontactPayment, V2.Core.Account.Configuration.Merchant.Capability.BlikPayment, V2.Core.Account.Configuration.Merchant.Capability.BoletoPayment, V2.Core.Account.Configuration.Merchant.Capability.CardPayment, V2.Core.Account.Configuration.Merchant.Capability.CartesBancairesPayment, V2.Core.Account.Configuration.Merchant.Capability.CashappPayment, V2.Core.Account.Configuration.Merchant.Capability.EpsPayment, V2.Core.Account.Configuration.Merchant.Capability.FpxPayment, V2.Core.Account.Configuration.Merchant.Capability.GbBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.GrabpayPayment, V2.Core.Account.Configuration.Merchant.Capability.IdealPayment, V2.Core.Account.Configuration.Merchant.Capability.JcbPayment, V2.Core.Account.Configuration.Merchant.Capability.JpBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.KakaoPayPayment, V2.Core.Account.Configuration.Merchant.Capability.KlarnaPayment, V2.Core.Account.Configuration.Merchant.Capability.KonbiniPayment, V2.Core.Account.Configuration.Merchant.Capability.KrCardPayment, V2.Core.Account.Configuration.Merchant.Capability.LinkPayment, V2.Core.Account.Configuration.Merchant.Capability.MobilepayPayment, V2.Core.Account.Configuration.Merchant.Capability.MultibancoPayment, V2.Core.Account.Configuration.Merchant.Capability.MxBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.NaverPayPayment, V2.Core.Account.Configuration.Merchant.Capability.OxxoPayment, V2.Core.Account.Configuration.Merchant.Capability.P24Payment, V2.Core.Account.Configuration.Merchant.Capability.PayByBankPayment, V2.Core.Account.Configuration.Merchant.Capability.PaycoPayment, V2.Core.Account.Configuration.Merchant.Capability.PaynowPayment, V2.Core.Account.Configuration.Merchant.Capability.PromptpayPayment, V2.Core.Account.Configuration.Merchant.Capability.RevolutPayPayment, V2.Core.Account.Configuration.Merchant.Capability.SamsungPayPayment, V2.Core.Account.Configuration.Merchant.Capability.SepaBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.SepaDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.StripeBalance.Payout, V2.Core.Account.Configuration.Merchant.Capability.SwishPayment, V2.Core.Account.Configuration.Merchant.Capability.TwintPayment, V2.Core.Account.Configuration.Merchant.Capability.UsBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.ZipPayment, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Local, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Wire, V2.Core.Account.Configuration.Recipient.Capability.Card, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.Payout, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.StripeTransfer, V2.Core.Account.Configuration.Storer.Capability.FinancialAddress.BankAccount, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Eur, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Gbp, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Usd, V2.Core.Account.Configuration.Storer.Capability.InboundTransfer.BankAccount, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.BankAccount, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.Card, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.FinancialAccount, V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer.BankAccount, and V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer.FinancialAccountal_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.DefaultOutboundDestination.typeV2.Core.Account.Identity.BusinessDetail.AnnualRevenue.amount, V2.Core.Account.Identity.BusinessDetail.MonthlyEstimatedRevenue.amount, V2.MoneyManagement.Adjustment.amount, V2.MoneyManagement.InboundTransfer.amount, V2.MoneyManagement.OutboundPayment.amount, V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.amount, V2.MoneyManagement.OutboundPaymentQuote.amount, V2.MoneyManagement.OutboundTransfer.amount, V2.MoneyManagement.ReceivedCredit.amount, V2.MoneyManagement.ReceivedDebit.amount, V2.MoneyManagement.Transaction.amount, v2.FinancialAddressCreditSimulationCreditParams.amount, v2.core.AccountCreateParamsIdentityBusinessDetailAnnualRevenue.amount, v2.core.AccountCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenue.amount, v2.core.AccountModifyParamsIdentityBusinessDetailAnnualRevenue.amount, v2.core.AccountModifyParamsIdentityBusinessDetailMonthlyEstimatedRevenue.amount, v2.core.AccountTokenCreateParamsIdentityBusinessDetailAnnualRevenue.amount, v2.core.AccountTokenCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenue.amount, v2.money_management.InboundTransferCreateParams.amount, v2.money_management.OutboundPaymentCreateParams.amount, v2.money_management.OutboundPaymentQuoteCreateParams.amount, and v2.money_management.OutboundTransferCreateParams.amount from amount to an objectat_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.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typehk_mbs from enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typear_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.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.typeV2.Core.Account.Default.responsibilities to be requiredV2.Core.Account.Default.Responsibility.fees_collector to be optionalV2.Core.Account.Default.Responsibility.losses_collector to be optionalfinancial_connections_account on V2.Core.Vault.UsBankAccount and V2.MoneyManagement.PayoutMethod.BankAccountV2.MoneyManagement.FinancialAccount.Balance.available, V2.MoneyManagement.Transaction.BalanceImpact.available, and V2.MoneyManagement.TransactionEntry.BalanceImpact.available from amount to an objectV2.MoneyManagement.FinancialAccount.Balance.inbound_pending, V2.MoneyManagement.Transaction.BalanceImpact.inbound_pending, and V2.MoneyManagement.TransactionEntry.BalanceImpact.inbound_pending from amount to an objectV2.MoneyManagement.FinancialAccount.Balance.outbound_pending, V2.MoneyManagement.Transaction.BalanceImpact.outbound_pending, and V2.MoneyManagement.TransactionEntry.BalanceImpact.outbound_pending from amount to an objectV2.MoneyManagement.InboundTransfer.From.debited, V2.MoneyManagement.OutboundPayment.From.debited, V2.MoneyManagement.OutboundPaymentQuote.From.debited, and V2.MoneyManagement.OutboundTransfer.From.debited from amount to an objectV2.MoneyManagement.InboundTransfer.To.credited, V2.MoneyManagement.OutboundPayment.To.credited, V2.MoneyManagement.OutboundPaymentQuote.To.credited, and V2.MoneyManagement.OutboundTransfer.To.credited from amount to an objecttransfer on V2.MoneyManagement.ReceivedCredit.BalanceTransfertransfer on enum V2.MoneyManagement.ReceivedCredit.BalanceTransfer.typev2.core.AccountTokenCreateParams.identity to be optionalv2.core.AccountListParams.applied_configurations from string to enum('customer'|'merchant'|'recipient'|'storer')V2MoneyManagementPayoutMethodCreatedEvent with related object v2.money_management.PayoutMethodControlledByAlternateResourceErrorRateLimitErroraccount_token_required_for_v2_account on QuotePreviewInvoice.LastFinalizationErrorAdd support for risk_details on DelegatedCheckout.RequestedSession
risk_details on DelegatedCheckout.RequestedSessiondescription, images, and name on DelegatedCheckout.RequestedSession.LineItemDetailname on ProductCatalog.TrialOffer and product_catalog.TrialOfferCreateParamslogin_failed and registration_failed on Radar.AccountEvaluation.Event and radar.AccountEvaluationModifyParamsradar.AccountEvaluationModifyParams.type from literal('registration_succeeded') to enum('login_failed'|'login_succeeded'|'registration_failed'|'registration_succeeded')Add support for tracking_details on V2.MoneyManagement.OutboundPayment
tracking_details on V2.MoneyManagement.OutboundPaymentpaper_check on V2.MoneyManagement.OutboundPayment.DeliveryOption and v2.money_management.OutboundPaymentCreateParamsDeliveryOptionV2CoreAccountIncludingFutureRequirementsUpdatedEvent with related object v2.core.Accountaccount_rate_limit_exceeded on RateLimitErrortax.Locationcreate, list, and retrieve methods on resource tax.Locationpause method on resource Subscriptionperformance_location on InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail, ProductCreateParamsTaxDetail, ProductModifyParamsTaxDetail, Tax.CalculationLineItem, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail, checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail, and tax.CalculationCreateParamsLineItemperformance on enums Tax.Calculation.ShippingCost.TaxBreakdown.sourcing, Tax.CalculationLineItem.TaxBreakdown.sourcing, and Tax.Transaction.ShippingCost.TaxBreakdown.sourcingadmissions_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_typedelegated_checkout.RequestedSessionModifyParams.metadata from map(string: string) to emptyable(map(string: string))delegated_checkout.RequestedSessionModifyParams.payment_method_data from payment_method_data to emptyable(payment_method_data)delegated_checkout.RequestedSessionModifyParams.shared_metadata from map(string: string) to emptyable(map(string: string))subscription on Invoice.Parent.ScheduleDetail and QuotePreviewInvoice.Parent.ScheduleDetailPaymentIntentConfirmParamsPaymentDetailBenefit.fr_meal_voucher, PaymentIntentCreateParamsPaymentDetailBenefit.fr_meal_voucher, PaymentIntentModifyParamsPaymentDetailBenefit.fr_meal_voucher, SetupIntentConfirmParamsSetupDetailBenefit.fr_meal_voucher, SetupIntentCreateParamsSetupDetailBenefit.fr_meal_voucher, and SetupIntentModifyParamsSetupDetailBenefit.fr_meal_voucher from payment_details_benefit_fr_meal_voucher to emptyable(payment_details_benefit_fr_meal_voucher)tax_details on PlanCreateParamsProduct and PriceCreateParamsProductDatumexternal_reference on Plan and Pricephase_start on enums Quote.SubscriptionDataOverride.phase_effective_at, Quote.SubscriptionDatum.phase_effective_at, QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_atline_start from enums Quote.SubscriptionDataOverride.phase_effective_at, Quote.SubscriptionDatum.phase_effective_at, QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_atadmissions_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.typeadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.CountryOption.Merequirements on TaxCodeAdd support for new resources shared_payment.GrantedToken, v2.iam.ApiKey, v2.payments.SettlementAllocationIntentSplit, v2.payments.SettlementAllocatio
shared_payment.GrantedToken, v2.iam.ApiKey, v2.payments.SettlementAllocationIntentSplit, v2.payments.SettlementAllocationIntent, and v2.tax.ManualRuleretrieve method on resource shared_payment.GrantedTokencreate and modify test helper methods on resource shared_payment.GrantedTokencreate, deactivate, list, modify, and retrieve methods on resource v2.tax.ManualRulecancel, create, modify, retrieve, and submit methods on resource v2.payments.SettlementAllocationIntentcancel, create, and retrieve methods on resource v2.payments.SettlementAllocationIntentSplitcreate, expire, list, modify, retrieve, and rotate methods on resource v2.iam.ApiKeycheck_scanning on AccountSessionCreateParamsComponenttax_details on InvoiceAddLinesParamsLinePriceDatumProductDatum, InvoiceLineItemModifyParamsPriceDatumProductDatum, InvoiceUpdateLinesParamsLinePriceDatumProductDatum, PaymentLinkCreateParamsLineItemPriceDatumProductDatum, ProductCreateParams, ProductModifyParams, checkout.SessionCreateParamsLineItemPriceDatumProductDatum, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumpayment_method_data on delegated_checkout.RequestedSessionConfirmParamsproduct_details on DelegatedCheckout.RequestedSession.LineItemDetailwallets on issuing.CardListParamsprimary_account_identifier on Issuing.Card.Wallet.ApplePay and Issuing.Card.Wallet.GooglePayshared_payment_granted_token on PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntentProductCatalog.TrialOffer.Duration.relative to be optionalal_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.RecipientDatum.DefaultOutboundDestination.typeinstant on V2.Account.Configuration.RecipientDatum.Feature.BankAccount, V2.Core.Account.Configuration.Recipient.Capability.BankAccount, v2.AccountCreateParamsConfigurationRecipientDatumFeatureBankAccount, v2.AccountModifyParamsConfigurationRecipientDatumFeatureBankAccount, v2.core.AccountCreateParamsConfigurationRecipientCapabilityBankAccount, and v2.core.AccountModifyParamsConfigurationRecipientCapabilityBankAccountbank_accounts.instant on enum V2.Account.Requirement.Impact.required_for_featurescollect_at on V2.Billing.IntentAction.Deactivate, V2.Billing.IntentAction.Modify, V2.Billing.IntentAction.Subscribe, v2.billing.IntentCreateParamsActionDeactivate, v2.billing.IntentCreateParamsActionModify, and v2.billing.IntentCreateParamsActionSubscribebilling_details on V2.Billing.IntentAction.Deactivate, V2.Billing.IntentAction.Modify, V2.Billing.IntentAction.Subscribe, v2.billing.IntentCreateParamsActionDeactivate, v2.billing.IntentCreateParamsActionModify, and v2.billing.IntentCreateParamsActionSubscribeoverrides on V2.Billing.IntentAction.Deactivate.PricingPlanSubscriptionDetail, V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail, V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail, v2.billing.IntentCreateParamsActionDeactivatePricingPlanSubscriptionDetail, v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetail, and v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailrequested on V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Celtic.ChargeCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Celtic.SpendCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank.ChargeCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank.SpendCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Lead.PrepaidCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Stripe.ChargeCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Stripe.PrepaidCard, V2.Core.Account.Configuration.Recipient.Capability.CryptoWallet, V2.Core.Account.Configuration.Storer.Capability.FinancialAddress.CryptoWallet, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Usdc, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.CryptoWallet, and V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer.CryptoWalletbank_accounts.instant on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilityalternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethodmanaged_by and payments on V2.MoneyManagement.FinancialAccountpayments on enum V2.MoneyManagement.FinancialAccount.typespeed on V2.MoneyManagement.OutboundPayment.DeliveryOption, V2.MoneyManagement.OutboundPaymentQuote.DeliveryOption, v2.money_management.OutboundPaymentCreateParamsDeliveryOption, and v2.money_management.OutboundPaymentQuoteCreateParamsDeliveryOptionreal_time_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.typetypes on v2.money_management.FinancialAccountListParamsv2.core.AccountListParams.applied_configurations from string to enumbank_accounts.instant on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilitytop_impacted_accounts on EventsV2CoreHealthApiErrorFiringEvent.Impact, EventsV2CoreHealthApiErrorResolvedEvent.Impact, EventsV2CoreHealthApiLatencyFiringEvent.Impact, EventsV2CoreHealthApiLatencyResolvedEvent.Impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.Impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.ImpactV2CoreHealthSepaDebitDelayedFiringEvent, V2CoreHealthSepaDebitDelayedResolvedEvent, and V2PaymentsSettlementAllocationIntentNotFoundEventV2PaymentsSettlementAllocationIntentCanceledEvent, V2PaymentsSettlementAllocationIntentCreatedEvent, V2PaymentsSettlementAllocationIntentErroredEvent, V2PaymentsSettlementAllocationIntentFundsNotReceivedEvent, V2PaymentsSettlementAllocationIntentMatchedEvent, V2PaymentsSettlementAllocationIntentSettledEvent, and V2PaymentsSettlementAllocationIntentSubmittedEvent with related object v2.payments.SettlementAllocationIntentV2PaymentsSettlementAllocationIntentSplitCanceledEvent, V2PaymentsSettlementAllocationIntentSplitCreatedEvent, and V2PaymentsSettlementAllocationIntentSplitSettledEvent with related object v2.payments.SettlementAllocationIntentSplitaccount_rate_limit_exceeded on RateLimitErrorThis release changes the pinned API version to 2025-12-15.clover.
This release changes the pinned API version to 2025-12-15.clover.
v2.core.AccountLink, v2.core.AccountPersonToken, v2.core.AccountPerson, v2.core.AccountToken, and v2.core.Accountcreate and retrieve methods on resources v2.core.AccountPersonToken and v2.core.AccountTokencreate method on resource v2.core.AccountLinkclose, create, list, modify, and retrieve methods on resource v2.core.Accountcreate, delete, list, modify, and retrieve methods on resource v2.core.AccountPersoncustomer_account on Billing.CreditBalanceSummary, Billing.CreditGrant, BillingPortal.Session, CashBalance, Checkout.Session, ConfirmationToken.PaymentMethodPreview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSessionCreateParams, CustomerSession, Customer, Discount, FinancialConnections.Account.AccountHolder, FinancialConnections.Session.AccountHolder, InvoiceCreateParams, InvoiceCreatePreviewParams, InvoiceItemCreateParams, InvoiceItemListParams, InvoiceItem, InvoiceListParams, Invoice, PaymentIntentCreateParams, PaymentIntentListParams, PaymentIntentModifyParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethodListParams, PaymentMethod, PromotionCodeCreateParams, PromotionCodeListParams, PromotionCode, QuoteCreateParams, QuoteListParams, QuoteModifyParams, Quote, SetupAttempt, SetupIntentCreateParams, SetupIntentListParams, SetupIntentModifyParams, SetupIntent, SubscriptionCreateParams, SubscriptionListParams, SubscriptionScheduleCreateParams, SubscriptionScheduleListParams, SubscriptionSchedule, Subscription, TaxId.Owner, TaxIdCreateParamsOwner, TaxIdListParamsOwner, TaxId, billing.CreditBalanceSummaryRetrieveParams, billing.CreditBalanceTransactionListParams, billing.CreditGrantCreateParams, billing.CreditGrantListParams, billing_portal.SessionCreateParams, checkout.SessionCreateParams, checkout.SessionListParams, financial_connections.AccountListParamsAccountHolder, and financial_connections.SessionCreateParamsAccountHoldermetadata on LineItem and checkout.SessionCreateParamsLineItempayto_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapabilitysigner on AccountCreateParamsDocumentProofOfRegistration, AccountCreateParamsDocumentProofOfUltimateBeneficialOwnership, AccountModifyParamsDocumentProofOfRegistration, and AccountModifyParamsDocumentProofOfUltimateBeneficialOwnershipCustomerSessionCreateParams.customer, InvoiceItemCreateParams.customer, PaymentMethodAttachParams.customer, SubscriptionCreateParams.customer, billing.CreditBalanceSummaryRetrieveParams.customer, billing.CreditBalanceTransactionListParams.customer, billing.CreditGrantCreateParams.customer, and billing_portal.SessionCreateParams.customer to be optionalbilling_cycle_anchor on BillingPortal.Configuration.Feature.SubscriptionUpdate, billing_portal.ConfigurationCreateParamsFeatureSubscriptionUpdate, and billing_portal.ConfigurationModifyParamsFeatureSubscriptionUpdatepayto on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Mandate.PaymentMethodDetail, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethodModifyParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, SubscriptionModifyParamsPaymentSettingPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOptionexpected_debit_date on Charge.PaymentMethodDetail.AcssDebit, Charge.PaymentMethodDetail.AuBecsDebit, Charge.PaymentMethodDetail.BacsDebit, Charge.PaymentMethodDetail.NzBankAccount, Charge.PaymentMethodDetail.SepaDebit, Charge.PaymentMethodDetail.UsBankAccount, PaymentAttemptRecord.PaymentMethodDetail.AcssDebit, PaymentAttemptRecord.PaymentMethodDetail.AuBecsDebit, PaymentAttemptRecord.PaymentMethodDetail.BacsDebit, PaymentAttemptRecord.PaymentMethodDetail.NzBankAccount, PaymentAttemptRecord.PaymentMethodDetail.SepaDebit, PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount, PaymentRecord.PaymentMethodDetail.AcssDebit, PaymentRecord.PaymentMethodDetail.AuBecsDebit, PaymentRecord.PaymentMethodDetail.BacsDebit, PaymentRecord.PaymentMethodDetail.NzBankAccount, PaymentRecord.PaymentMethodDetail.SepaDebit, and PaymentRecord.PaymentMethodDetail.UsBankAccountmollie on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bankMLLENL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bicpayto on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, SetupIntentModifyParams.excluded_payment_method_types, and checkout.SessionCreateParams.excluded_payment_method_typespayto on enum checkout.SessionCreateParams.payment_method_typesline_items on checkout.SessionModifyParamspayto on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.typepayto on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typepayto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeinvoice on CustomerListCustomerBalanceTransactionParamsrelated_customer_account on Identity.VerificationSession, identity.VerificationSessionCreateParams, and identity.VerificationSessionListParamsInvoiceItem.Pricing.PriceDetail.price and InvoiceLineItem.Pricing.PriceDetail.price from string to expandable($Price)payto on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typessubtotal on InvoiceLineItemauthorization_code, description, iin, installments, issuer, network_advice_code, network_decline_code, and stored_credential_usage on PaymentAttemptRecord.PaymentMethodDetail.Card and PaymentRecord.PaymentMethodDetail.CardPaymentIntent.transfer_data to be optionalpayto on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_typesallow_redisplay on PaymentMethodListParamsreported_by on PaymentRecordProduct.tax_code to be optional2025-12-15.clover and 2026-01-28.clover on enum WebhookEndpointCreateParams.api_versionchanges on V2.Core.Eventaccount_token_required_for_v2_account on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2025-11-17.preview.
This release changes the pinned API version to 2025-11-17.preview.
v2.core.AccountPersonToken and v2.core.AccountTokenv2.payments.OffSessionPaymentcreate and retrieve methods on resources v2.core.AccountPersonToken and v2.core.AccountTokencancel, capture, create, list, and retrieve methods on resource v2.payments.OffSessionPaymentTax.Association.tax_transaction_attempts to be requiredspecified_commercial_transactions_act_url on Account.BusinessProfile, AccountCreateParamsBusinessProfile, and AccountModifyParamsBusinessProfilepaypay_payments on Account.Setting, AccountCreateParamsSetting, and AccountModifyParamsSettingbilling.analytics.MeterUsageRetrieveParamsMeter.dimension_filters from string to array(string)billing.analytics.MeterUsageRetrieveParamsMeter.tenant_filters from string to array(string)car_rental_data, flight_data, and lodging_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetailsupplementary_purchase_data on OrderCreateParamsPaymentSettingPaymentMethodOptionKlarna, OrderModifyParamsPaymentSettingPaymentMethodOptionKlarna, PaymentIntentConfirmParamsPaymentMethodOptionKlarna, PaymentIntentCreateParamsPaymentMethodOptionKlarna, and PaymentIntentModifyParamsPaymentMethodOptionKlarnaallow_redisplay and customer_account on PaymentMethodListParamsfuture_requirements on V2.Core.Accountkonbini_payments and script_statement_descriptor on V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchanteur on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrencyrequirements_collector on V2.Core.Account.Default.Responsibilityar_cuit on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.typear_dni on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, and v2.core.AccountPersonModifyParamsIdNumber.typecollector on V2.Core.Account.Requirementholds_currencies.eur on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitypayment_method and person on enum V2.Core.Account.Requirement.Entry.Reference.typeresource from enum V2.Core.Account.Requirement.Entry.Reference.typefuture_requirements from enum V2.Core.Account.Requirement.Entry.RequestedReason.codechanges on V2.Core.Eventsepa_bank_account from enums V2.MoneyManagement.FinancialAddress.Credential.type and v2.money_management.FinancialAddressCreateParams.typeaccount_token on v2.core.AccountCreateParams and v2.core.AccountModifyParamsfuture_requirements on enums v2.core.AccountCreateParams.include, v2.core.AccountModifyParams.include, and v2.core.AccountRetrieveParams.includeperson_token on v2.core.AccountPersonCreateParams and v2.core.AccountPersonModifyParamsV2CoreHealthEventGenerationFailureResolvedEventV2PaymentsOffSessionPaymentAuthorizationAttemptFailedEvent, V2PaymentsOffSessionPaymentAuthorizationAttemptStartedEvent, V2PaymentsOffSessionPaymentCanceledEvent, V2PaymentsOffSessionPaymentCreatedEvent, V2PaymentsOffSessionPaymentFailedEvent, V2PaymentsOffSessionPaymentRequiresCaptureEvent, and V2PaymentsOffSessionPaymentSucceededEvent with related object v2.payments.OffSessionPaymentAdd support for event notifications V2IamApiKeyCreatedEvent, V2IamApiKeyDefaultSecretRevealedEvent, V2IamApiKeyExpiredEvent, V2IamApiKeyPermissionsUpd
V2IamApiKeyCreatedEvent, V2IamApiKeyDefaultSecretRevealedEvent, V2IamApiKeyExpiredEvent, V2IamApiKeyPermissionsUpdatedEvent, V2IamApiKeyRotatedEvent, and V2IamApiKeyUpdatedEventcheck_scanning on AccountSession.Componentclient on V2.Core.Event.Reason.Requeststripe_balance_payment on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebitstripe_balance_payment on enum V2.MoneyManagement.ReceivedCredit.typebalance_transfer on V2.MoneyManagement.ReceivedDebitbalance_transfer and stripe_balance_payment on enum V2.MoneyManagement.ReceivedDebit.typeinclude on v2.core.EventListParams and v2.core.EventRetrieveParamsAdd support for new resource product_catalog.TrialOffer
product_catalog.TrialOffercreate method on resource product_catalog.TrialOfferamount_subtotal_after_discount on DelegatedCheckout.RequestedSession.LineItemDetail and DelegatedCheckout.RequestedSession.TotalDetailamount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.LineItemDetailamount_cart_discount and amount_items_discount on DelegatedCheckout.RequestedSession.TotalDetailamount_discount on DelegatedCheckout.RequestedSession.TotalDetailpayments_orchestration on PaymentIntentCreateParams and PaymentIntentThis release changes the pinned API version to 2025-11-17.preview.
This release changes the pinned API version to 2025-11-17.preview.
v2.core.AccountPersonToken, v2.core.AccountToken, and v2.money_management.CurrencyConversioncreate, list, and retrieve methods on resource v2.money_management.CurrencyConversioncreate and retrieve methods on resources v2.core.AccountPersonToken and v2.core.AccountTokeneffective_at on InvoiceCreatePreviewParamsScheduleDetailAmendment, InvoiceCreatePreviewParamsScheduleDetailPhase, QuoteCreateParamsLine, QuoteLine, QuoteModifyParamsLine, QuotePreviewSubscriptionSchedule.Phase, SubscriptionSchedule.Phase, SubscriptionScheduleAmendParamsAmendment, SubscriptionScheduleCreateParamsPhase, and SubscriptionScheduleModifyParamsPhasetrial_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 SubscriptionScheduleModifyParamsPhaseItemDelegatedCheckout.RequestedSession.amount_subtotal from longInteger to nullable(longInteger)DelegatedCheckout.RequestedSession.amount_total from longInteger to nullable(longInteger)amount_discount, amount_subtotal, amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.LineItemDetailamount_subtotal_after_discount on DelegatedCheckout.RequestedSession.LineItemDetail and DelegatedCheckout.RequestedSession.TotalDetailInvoiceCreatePreviewParamsScheduleDetail.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))amendment_end, line_ends_at, schedule_end, and upcoming_invoice from enums InvoiceCreatePreviewParamsSubscriptionDetailBillingScheduleBillUntil.type, Subscription.BillingSchedule.BillUntil.type, SubscriptionCreateParamsBillingScheduleBillUntil.type, SubscriptionModifyParamsBillingScheduleBillUntil.type, SubscriptionScheduleCreateParamsBillingScheduleBillUntil.type, and SubscriptionScheduleModifyParamsBillingScheduleBillUntil.typecurrent_trial on InvoiceCreatePreviewParamsSubscriptionDetailItem, SubscriptionCreateParamsItem, SubscriptionItemCreateParams, SubscriptionItemModifyParams, SubscriptionItem, and SubscriptionModifyParamsItemQuoteCreateParamsSubscriptionDataOverride.billing_schedules and QuoteCreateParamsSubscriptionDatum.billing_schedules from emptyable(array(billing_schedules_create_specs)) to array(billing_schedules_create_specs)line_start on enums QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_atphase_start from enums QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_atQuote.SubscriptionDataOverride.billing_schedules and Quote.SubscriptionDatum.billing_schedules from nullable(array(SubscriptionsResourceBillingSchedules)) to array(QuotesResourceSubscriptionDataBillingSchedules)Quote.SubscriptionDataOverride.phase_effective_at and Quote.SubscriptionDatum.phase_effective_at from nullable(enum('billing_period_start'|'phase_start')) to enum('billing_period_start'|'line_start')QuotePreviewSubscriptionSchedule.DefaultSetting.phase_effective_at and SubscriptionSchedule.DefaultSetting.phase_effective_at from nullable(enum('billing_period_start'|'phase_start')) to enum('billing_period_start'|'phase_start')QuotePreviewSubscriptionSchedule.billing_schedules and SubscriptionSchedule.billing_schedules from nullable(array(SubscriptionsResourceBillingSchedules)) to array(SubscriptionsResourceBillingSchedules)amendment_start, line_starts_at, and relative on Subscription.BillingSchedule.BillFromSubscription.BillingSchedule.BillFrom.computed_timestamp from nullable(DateTime) to DateTimeSubscription.BillingSchedule.BillFrom.type from enum to literal('timestamp')amendment_end and line_ends_at on Subscription.BillingSchedule.BillUntilV2.Billing.ServiceAction.CreditGrant.Amount.monetary, V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.monetary, v2.billing.ServiceActionCreateParamsCreditGrantAmount.monetary, and v2.billing.ServiceActionCreateParamsCreditGrantPerTenantAmount.monetary from amount to an objectfuture_requirements on V2.Core.Accountkonbini_payments and script_statement_descriptor on V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchanteur on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrencyrequirements_collector on V2.Core.Account.Default.Responsibilityar_cuit on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.typear_dni on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, and v2.core.AccountPersonModifyParamsIdNumber.typecollector on V2.Core.Account.Requirementholds_currencies.eur on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitypayment_method and person on enum V2.Core.Account.Requirement.Entry.Reference.typeresource from enum V2.Core.Account.Requirement.Entry.Reference.typefuture_requirements from enum V2.Core.Account.Requirement.Entry.RequestedReason.codev1_event_id on V2.Core.Eventamount_details and capture_method on V2.Payments.OffSessionPayment and v2.payments.OffSessionPaymentCreateParamsV2.Payments.OffSessionPayment.amount_capturable from amount to an objectV2.Payments.OffSessionPayment.amount_requested from amount to an objectv2.payments.OffSessionPaymentCreateParams.amount from amount to an objectbest_available on enum v2.payments.OffSessionPaymentCreateParamsRetryDetail.retry_strategyheuristic, scheduled, and smart from enum v2.payments.OffSessionPaymentCreateParamsRetryDetail.retry_strategyv2.payments.OffSessionPaymentCreateParamsRetryDetail.retry_strategy to be optionaldestination on v2.payments.OffSessionPaymentCaptureParamsTransferDatumv2.payments.OffSessionPaymentCaptureParams.amount_to_capture to be optionalcreated on v2.core.EventListParamsgt, gte, lt, and lte on v2.core.EventListParamsaccount_token on v2.core.AccountCreateParams and v2.core.AccountModifyParamsfuture_requirements on enums v2.core.AccountCreateParams.include, v2.core.AccountModifyParams.include, and v2.core.AccountRetrieveParams.includeperson_token on v2.core.AccountPersonCreateParams and v2.core.AccountPersonModifyParamsimpacted_requests_percentage on EventsV2CoreHealthApiErrorFiringEvent.Impact, EventsV2CoreHealthApiErrorResolvedEvent.Impact, EventsV2CoreHealthApiLatencyFiringEvent.Impact, EventsV2CoreHealthApiLatencyResolvedEvent.Impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.Impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.Impactcontext and related_object on EventsV2CoreHealthEventGenerationFailureResolvedEvent.Impactaccount, livemode, missing_delivery_attempts, and related_object_id on EventsV2CoreHealthEventGenerationFailureResolvedEvent.ImpactEventsV2CoreHealthFraudRateIncreasedEvent.Impact.realized_fraud_amount from amount to an objectEventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.approved_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.approved_amount from amount to an objectEventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.declined_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.declined_amount from amount to an objectV2PaymentsOffSessionPaymentAttemptFailedEvent and V2PaymentsOffSessionPaymentAttemptStartedEvent with related object v2.payments.OffSessionPaymentV1AccountUpdatedEvent with related object AccountV1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFeeV1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object billing_portal.ConfigurationV1CapabilityUpdatedEvent with related object CapabilityV1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object ChargeV1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object DisputeV1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object RefundV1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object checkout.SessionV1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object climate.OrderV1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object climate.ProductV1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object CouponV1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNoteV1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object CustomerV1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object SubscriptionV1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxIdV1FileCreatedEvent with related object FileV1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, and V1FinancialConnectionsAccountRefreshedTransactionsEvent with related object financial_connections.AccountV1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object identity.VerificationSessionV1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object InvoiceV1InvoicePaymentPaidEvent with related object InvoicePaymentV1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItemV1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object issuing.AuthorizationV1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object issuing.CardV1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object issuing.CardholderV1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object issuing.DisputeV1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object issuing.PersonalizationDesignV1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object issuing.TokenV1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object issuing.TransactionV1MandateUpdatedEvent with related object MandateV1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntentV1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLinkV1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethodV1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object PayoutV1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object PersonV1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object PlanV1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object PriceV1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object ProductV1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCodeV1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object QuoteV1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object radar.EarlyFraudWarningV1ReviewClosedEvent and V1ReviewOpenedEvent with related object ReviewV1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntentV1SigmaScheduledQueryRunCreatedEvent with related object sigma.ScheduledQueryRunV1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object SourceV1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionScheduleV1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRateV1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object terminal.ReaderV1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object test_helpers.TestClockV1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object TopupV1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object TransferThis release changes the pinned API version to 2025-11-17.preview.
This release changes the pinned API version to 2025-11-17.preview.
billing_schedules_actions on InvoiceCreatePreviewParamsScheduleDetailAmendment and SubscriptionScheduleAmendParamsAmendmentBalanceTransfer and radar.AccountEvaluationcreate method on resource BalanceTransfercreate, modify, and retrieve methods on resource radar.AccountEvaluationTax.Association.tax_transaction_attempts to be requiredspecified_commercial_transactions_act_url on Account.BusinessProfile, AccountCreateParamsBusinessProfile, and AccountModifyParamsBusinessProfilepaypay_payments on Account.Setting, AccountCreateParamsSetting, and AccountModifyParamsSettingbilling.analytics.MeterUsageRetrieveParamsMeter.dimension_filters from string to array(string)billing.analytics.MeterUsageRetrieveParamsMeter.tenant_filters from string to array(string)payment_method_configuration on BillingPortal.Configuration.Feature.PaymentMethodUpdatecar_rental_data, flight_data, and lodging_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetailtransaction_id on Charge.PaymentMethodDetail.Ideal, PaymentAttemptRecord.PaymentMethodDetail.Ideal, and PaymentRecord.PaymentMethodDetail.Idealfinom on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bankFNOMNL22 on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bictokenized_account_number_deactivated on enums ConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked.reason and PaymentMethod.UsBankAccount.StatusDetail.Blocked.reasoncreated on CustomerListCustomerBalanceTransactionParams and InvoicePaymentListParamscapital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enum Event.typeaccount_numbers on FinancialConnections.AccountFinancialConnections.Session.client_secret from string to nullable(string)fraud_risk on issuing.AuthorizationCreateParamsRiskAssessmentlatest_fraud_warning on Issuing.Cardsupplementary_purchase_data on OrderCreateParamsPaymentSettingPaymentMethodOptionKlarna, OrderModifyParamsPaymentSettingPaymentMethodOptionKlarna, PaymentIntentConfirmParamsPaymentMethodOptionKlarna, PaymentIntentCreateParamsPaymentMethodOptionKlarna, and PaymentIntentModifyParamsPaymentMethodOptionKlarnacapture_method on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardPresentallow_redisplay and customer_account on PaymentMethodListParamsmb_way and twint on Refund.DestinationDetailSubscriptionScheduleModifyParams.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))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 WebhookEndpointModifyParams.enabled_events2025-11-17.clover on enum WebhookEndpointCreateParams.api_versionfinancial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry with resource financial_connections.Accountstripe.error module is now accessible globally. Fixes #1682
This release changes the pinned API version to 2025-11-17.clover.
This release changes the pinned API version to 2025-11-17.clover.
gt, gte, lt, and lte on v2.core.EventListParams in favor of created.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.tax.Association and terminal.OnboardingLinkfind method on resource tax.Associationcreate method on resource terminal.OnboardingLinkpayment_method_configuration on BillingPortal.Configuration.Feature.PaymentMethodUpdatetransaction_id on Charge.PaymentMethodDetail.Ideal, PaymentAttemptRecord.PaymentMethodDetail.Ideal, and PaymentRecord.PaymentMethodDetail.Idealfinom on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bankFNOMNL22 on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bictokenized_account_number_deactivated on enums ConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked.reason and PaymentMethod.UsBankAccount.StatusDetail.Blocked.reasoncreated on CustomerListCustomerBalanceTransactionParams and InvoicePaymentListParamsfinancial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enum Event.typeaccount_numbers on FinancialConnections.AccountFinancialConnections.Session.client_secret from string to nullable(string)fraud_risk on issuing.AuthorizationCreateParamsRiskAssessmentlatest_fraud_warning on Issuing.Cardhooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentModifyParams, and PaymentIntentmb_way and twint on Refund.DestinationDetailfinancial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_eventsfinancial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry with resource financial_connections.AccountThis release changes the pinned API version to 2025-10-29.preview.
This release changes the pinned API version to 2025-10-29.preview.
issuing.Programcreate, list, modify, and retrieve methods on resource issuing.Programschedule on Discountapplicable_fees on DelegatedCheckout.RequestedSession.TotalDetailschedule_details on Invoice.Parent, InvoiceItem.Parent, InvoiceLineItem.Parent, and QuotePreviewInvoice.Parentschedule_details on enum InvoiceItem.Parent.typebilling_schedules on InvoiceCreatePreviewParamsScheduleDetail, QuotePreviewSubscriptionSchedule, SubscriptionScheduleCreateParams, SubscriptionScheduleModifyParams, and SubscriptionScheduleschedule_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.typeschedule_details on enum InvoiceLineItem.Parent.typelatest_invoice on QuotePreviewSubscriptionSchedule and SubscriptionSchedulephase_effective_at on QuotePreviewSubscriptionSchedule.DefaultSetting, SubscriptionSchedule.DefaultSetting, SubscriptionScheduleCreateParamsDefaultSetting, and SubscriptionScheduleModifyParamsDefaultSettingv2.tax.AutomaticRulecreate, deactivate, find, modify, and retrieve methods on resource v2.tax.AutomaticRuleself_reported_income and self_reported_monthly_housing_payment on AccountCreateParamsIndividual, AccountCreatePersonParams, AccountModifyParamsIndividual, AccountModifyPersonParams, Person, TokenCreateParamsAccountIndividual, and TokenCreateParamsPersonamendment_end, line_ends_at, schedule_end, and upcoming_invoice on enums InvoiceCreatePreviewParamsSubscriptionDetailBillingScheduleBillUntil.type, Subscription.BillingSchedule.BillUntil.type, SubscriptionCreateParamsBillingScheduleBillUntil.type, and SubscriptionModifyParamsBillingScheduleBillUntil.typebilling_schedules and phase_effective_at on Quote.SubscriptionDataOverride, Quote.SubscriptionDatum, QuoteCreateParamsSubscriptionDataOverride, QuoteCreateParamsSubscriptionDatum, QuoteModifyParamsSubscriptionDataOverride, and QuoteModifyParamsSubscriptionDatumbill_from on Subscription.BillingScheduleamendment_end and line_ends_at on Subscription.BillingSchedule.BillUntildata and related_object on V2.Core.EventAdd support for new resources TransitBalance, v2.reporting.ReportRun, v2.reporting.Report
TransitBalance, v2.reporting.ReportRun, v2.reporting.Reportcreate and retrieve methods on resource v2.reporting.ReportRunretrieve method on resource v2.reporting.Reportcreate and refill test helper methods on resource capital.FinancingOfferallocated_funds on Charge, PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntentModifyParamsV2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object v2.reporting.ReportRunReplace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
Add support for capture_method on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentInte
capture_method on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardPresentThis release changes the pinned API version to 2025-10-29.preview.
This release changes the pinned API version to 2025-10-29.preview.
crypto_storer on v2.core.AccountModifyParamsIdentityAttestationTermsOfServicemodify method on resource v2.money_management.FinancialAccountconfirm_microdeposits, list, and send_microdeposits methods on resource v2.core.vault.UsBankAccountlist method on resource v2.core.vault.GbBankAccountverification_data_not_found on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.codepayment_portal_url on Charge.PaymentMethodDetail.Rechnung, PaymentAttemptRecord.PaymentMethodDetail.Rechnung, and PaymentRecord.PaymentMethodDetail.Rechnungtax_id_element on CustomerSession.Component and CustomerSessionCreateParamsComponentstarting_after on PaymentAttemptRecordListParamssolana on enums PaymentAttemptRecord.PaymentMethodDetail.Crypto.network and PaymentRecord.PaymentMethodDetail.Crypto.networkreference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarna, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionKlarna, and PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionKlarnaPaymentIntent.PaymentDetail.customer_reference to be requiredPaymentIntent.PaymentDetail.order_reference to be requiredsubscription_reference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarnaclosed on V2.Core.Account and v2.core.AccountListParamspayment_method on enums V2.Core.Account.Configuration.Customer.AutomaticIndirectTax.location_source, v2.core.AccountCreateParamsConfigurationCustomerAutomaticIndirectTax.location_source, and v2.core.AccountModifyParamsConfigurationCustomerAutomaticIndirectTax.location_sourceusd on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrencyapplication_custom and application_express on enums V2.Core.Account.Default.Responsibility.fees_collector, v2.core.AccountCreateParamsDefaultResponsibility.fees_collector, and v2.core.AccountModifyParamsDefaultResponsibility.fees_collectorrepresentative_declaration on V2.Core.Account.Identity.Attestation, v2.core.AccountCreateParamsIdentityAttestation, and v2.core.AccountModifyParamsIdentityAttestationholds_currencies.usd on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilityverification on V2.Core.Vault.UsBankAccountv1_id on EventsV2MoneyManagementTransactionCreatedEventV2BillingBillSettingUpdatedEvent with related object v2.billing.BillSettingpayment_intent_rate_limit_exceeded on QuotePreviewInvoice.LastFinalizationErrorblocked_payout_method_crypto_wallet and unsupported_payout_method_crypto_wallet on BlockedByStripeErroroutbound_flow_from_closed_financial_account_unsupported on FeatureNotEnabledErrorlimit_payout_method_crypto_wallet on QuotaExceededErrorlast_seen_at on Terminal.Reader2025-10-29.clover on enum WebhookEndpointCreateParams.api_versionChange delegated_checkout.RequestedSessionModifyParamsLineItemDetail.quantity to be required
delegated_checkout.RequestedSessionModifyParamsLineItemDetail.quantity to be requiredpayment_method_preview on DelegatedCheckout.RequestedSessionorder_id on DelegatedCheckout.RequestedSession.OrderDetaillead 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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialglobal_account_holder on V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercial, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialcommercial.lead.prepaid_card on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitycommercial.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capabilityAdd support for report_refund method on resource PaymentRecord
report_refund method on resource PaymentRecordverification_data_not_found on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.codetenants on Billing.Analytics.MeterUsageRowrepresentative_declaration on Account.Company, AccountCreateParamsCompany, AccountModifyParamsCompany, and TokenCreateParamsAccountCompanytransfer on ApplicationFee.FeeSourcetransfer on enum ApplicationFee.FeeSource.typetransit_balances_total on Balancetransit on enum BalanceTransaction.balance_typetenant_group_by_keys on billing.analytics.MeterUsageRetrieveParamsMeterbilling.CreditGrantCreateParams.category to be optionalpayment_method_configuration on billing_portal.ConfigurationCreateParamsFeaturePaymentMethodUpdate and billing_portal.ConfigurationModifyParamsFeaturePaymentMethodUpdatesolana on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.networkpayment_portal_url on Charge.PaymentMethodDetail.Rechnung, PaymentAttemptRecord.PaymentMethodDetail.Rechnung, and PaymentRecord.PaymentMethodDetail.Rechnungtwint on Checkout.Session.PaymentMethodOption and checkout.SessionCreateParamsPaymentMethodOptioncustom on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typeCreditNote.Refund.payment_record_refund to be requiredCreditNote.Refund.type to be requiredcustomer_sheet, mobile_payment_element, and tax_id_element on CustomerSession.Component and CustomerSessionCreateParamsComponentcustom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeprovider on Customer.Taxrisk_details on delegated_checkout.RequestedSessionCreateParamsrisk_details on delegated_checkout.RequestedSessionConfirmParamsplatform_terms_of_service on enums File.purpose and FileListParams.purposeplatform_terms_of_service on enum FileCreateParams.purposestarting_after on PaymentAttemptRecordListParamsreference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarna, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionKlarna, and PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionKlarnaallocated_funds on PaymentIntentPaymentIntent.PaymentDetail.customer_reference to be requiredPaymentIntent.PaymentDetail.order_reference to be requiredsubscription_reference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarnaname_collection on PaymentLinkCreateParams, PaymentLinkModifyParams, and PaymentLinkcrypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, and Refund.DestinationDetailmb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, and PaymentMethodConfigurationcustom on PaymentMethodCreateParams and PaymentMethodexcluded_payment_method_types on SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntentSetupIntent.flow_directions to be optionaltw on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptiongip on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTippinglast_seen_at on Terminal.Readerapplication_fee_amount on TransferCreateParams and Transferapplication_fee on Transfer2025-10-29.clover on enum WebhookEndpointCreateParams.api_versionhigh_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.AccountCreateParamsConfigurationStorer, and v2.core.AccountModifyParamsConfigurationStorercrypto_wallets on V2.Core.Account.Configuration.Storer.Capability.FinancialAddress, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment, V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer, v2.core.AccountCreateParamsConfigurationStorerCapabilityFinancialAddress, v2.core.AccountCreateParamsConfigurationStorerCapabilityOutboundPayment, v2.core.AccountCreateParamsConfigurationStorerCapabilityOutboundTransfer, v2.core.AccountModifyParamsConfigurationStorerCapabilityFinancialAddress, v2.core.AccountModifyParamsConfigurationStorerCapabilityOutboundPayment, and v2.core.AccountModifyParamsConfigurationStorerCapabilityOutboundTransferusdc on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrencycrypto_storer on V2.Core.Account.Identity.Attestation.TermsOfService and v2.core.AccountCreateParamsIdentityAttestationTermsOfServicecompliance_screening_description on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, and v2.core.AccountModifyParamsIdentityBusinessDetailexternal_amount on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebitpayment_intent_rate_limit_exceeded on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorSee the changelog for more details.
payment_record to enum InvoicePayment.payment.typeContains bug fixes and improvements from v13.0.1.
See the changelog for more details.
stripe-context header not being included in paged list requestsContains bug fixes and improvements from v13.0.1.
This release changes the pinned API version to 2025-10-29.clover.
This release changes the pinned API version to 2025-10-29.clover.
PaymentAttemptRecord, PaymentIntentAmountDetailsLineItem, and PaymentRecordlist and retrieve methods on resource PaymentAttemptRecordreport_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 PaymentRecordlist method on resource PaymentIntentAmountDetailsLineItemrepresentative_declaration on Account.Company, AccountCreateParamsCompany, AccountModifyParamsCompany, and TokenCreateParamsAccountCompanybilling.CreditGrantCreateParams.category to be optionalpayment_method_configuration on billing_portal.ConfigurationCreateParamsFeaturePaymentMethodUpdate and billing_portal.ConfigurationModifyParamsFeaturePaymentMethodUpdatesolana on enum Charge.PaymentMethodDetail.Crypto.networkmb_way on enum checkout.SessionCreateParams.excluded_payment_method_typestwint on Checkout.Session.PaymentMethodOption and checkout.SessionCreateParamsPaymentMethodOptionmb_way on enum checkout.SessionCreateParams.payment_method_typescustom on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typepayment_record_refund and type on CreditNote.Refund, CreditNoteCreateParamsRefund, CreditNotePreviewLinesParamsRefund, and CreditNotePreviewParamsRefundcustomer_sheet and mobile_payment_element on CustomerSession.Component and CustomerSessionCreateParamsComponentcustom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeprovider on Customer.Taxbalance_settings.updated and invoice.payment_attempt_required on enum Event.typeplatform_terms_of_service on enums File.purpose and FileListParams.purposeplatform_terms_of_service on enum FileCreateParams.purposepayment_record on InvoiceAttachPaymentParams, InvoicePayment.Payment, and InvoicePaymentListParamsPaymentInvoicePaymentListParamsPayment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')custom on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_typesamount_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentModifyParamspayment_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentModifyParams, and PaymentIntentdiscount_amount, line_items, shipping, and tax on PaymentIntent.AmountDetailname_collection on PaymentLinkCreateParams, PaymentLinkModifyParams, and PaymentLinkmb_way on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_typescrypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, and Refund.DestinationDetailmb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, and PaymentMethodConfigurationcustom on PaymentMethodCreateParams and PaymentMethodexcluded_payment_method_types on SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntentSetupIntent.flow_directions to be optionaltw on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptiongip on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTippinglast_seen_at on Terminal.Readerbalance_settings.updated and invoice.payment_attempt_required on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events2025-10-29.clover on enum WebhookEndpointCreateParams.api_versiongt, gte, lt, lte, and types on v2.core.EventListParamsv2.core.EventListParams.object_id to be optionalbalance_settings.updated with resource BalanceSettingsinvoice.payment_attempt_required with resource Invoicepayment_intent_rate_limit_exceeded on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorif TYPE_CHECKING block__getattr__ functions to most __init__.py filesThis release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 13.0.0 which contains breaking changes. Please re…
This release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 13.0.0 which contains breaking changes. Please review the changelog for 13.0.0 if upgrading from older SDK versions.
attach_cadence method on resource Subscriptionbilling_cadence on Invoice.CreatePreviewParams, Subscription.CreateParams, Subscription.ModifyParams, and Subscriptionbilling_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parentbilling_cadence_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.typev2.billing.BillSettingVersion, v2.billing.BillSetting, v2.billing.Cadence, v2.billing.CollectionSettingVersion, v2.billing.CollectionSetting, and v2.billing.Profilecreate, list, modify, and retrieve methods on resources v2.billing.BillSetting, v2.billing.CollectionSetting, and v2.billing.Profilelist and retrieve methods on resources v2.billing.BillSettingVersion and v2.billing.CollectionSettingVersioncancel, create, list, modify, and retrieve methods on resource v2.billing.Cadencecrypto_wallet on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typeprofile on V2.Core.Account.Default, v2.core.Account.CreateParamsDefault, and v2.core.Account.ModifyParamsDefaulti_p on V2.Core.Account.Identity.Attestation.DirectorshipDeclaration, V2.Core.Account.Identity.Attestation.OwnershipDeclaration, V2.Core.Account.Identity.Attestation.TermsOfService.Account, V2.Core.Account.Identity.Attestation.TermsOfService.Storer, V2.Core.Account.Identity.Individual.AdditionalTermsOfService.Account, V2.Core.Person.AdditionalTermsOfService.Account, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceStorer, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceStorer, v2.core.Person.CreateParamsAdditionalTermsOfServiceAccount, and v2.core.Person.ModifyParamsAdditionalTermsOfServiceAccountip on V2.Core.Account.Identity.Attestation.DirectorshipDeclaration, V2.Core.Account.Identity.Attestation.OwnershipDeclaration, V2.Core.Account.Identity.Attestation.TermsOfService.Account, V2.Core.Account.Identity.Attestation.TermsOfService.Storer, V2.Core.Account.Identity.Individual.AdditionalTermsOfService.Account, V2.Core.Person.AdditionalTermsOfService.Account, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceStorer, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceStorer, v2.core.Person.CreateParamsAdditionalTermsOfServiceAccount, and v2.core.Person.ModifyParamsAdditionalTermsOfServiceAccountdoing_business_as, product_description, and url on V2.Core.Account.Identity.BusinessDetail, v2.core.Account.CreateParamsIdentityBusinessDetail, and v2.core.Account.ModifyParamsIdentityBusinessDetailsettlement_currency on V2.MoneyManagement.FinancialAddresssepa_bank_account on V2.MoneyManagement.FinancialAddress.Credential and V2.MoneyManagement.ReceivedCredit.BankTransfersepa_bank_account on enum V2.MoneyManagement.FinancialAddress.Credential.typeamount_details and payments_orchestration on V2.Payments.OffSessionPayment and v2.payments.OffSessionPayment.CreateParamsauthorization_expired on enum V2.Payments.OffSessionPayment.failure_reasonretry_policy on V2.Payments.OffSessionPayment.RetryDetail and v2.payments.OffSessionPayment.CreateParamsRetryDetailheuristic and scheduled on enums V2.Payments.OffSessionPayment.RetryDetail.retry_strategy and v2.payments.OffSessionPayment.CreateParamsRetryDetail.retry_strategyV2.MoneyManagement.OutboundPaymentQuote.FxQuote.lock_duration from literal('five_minutes') to enum('five_minutes'|'none')V2.MoneyManagement.OutboundPaymentQuote.FxQuote.lock_expires_at from DateTime to nullable(DateTime)none on enum V2.MoneyManagement.OutboundPaymentQuote.FxQuote.lock_statuscrypto_wallet on enums V2.MoneyManagement.PayoutMethod.type, v2.money_management.OutboundSetupIntent.CreateParamsPayoutMethodDatum.type, and v2.money_management.OutboundSetupIntent.ModifyParamsPayoutMethodDatum.typeorigin_type on V2.MoneyManagement.ReceivedCredit.BankTransferpayment_method_type on V2.MoneyManagement.ReceivedCredit.BankTransfermandate_data and payment_method_options on v2.payments.OffSessionPayment.CreateParamstype on v2.money_management.FinancialAddress.CreateParamscurrency on v2.money_management.FinancialAddress.CreateParamsfinancial_addressses.crypto_wallets, holds_currencies.usdc, outbound_payments.crypto_wallets, and outbound_transfers.crypto_wallets on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capabilityV2BillingBillSettingUpdatedEvent with related object v2.billing.BillSettingRateLimitErrorinvalid_payout_method_crypto_wallet on InvalidPayoutMethodErrorbilling.analytics.MeterUsageRow and billing.analytics.MeterUsagebilling.MeterUsageRow and billing.MeterUsageretrieve method on resource billing.analytics.MeterUsageretrieve method on resource billing.MeterUsagereport_payment_attempt_informational method on resource PaymentRecordminimum_balance_by_currency on BalanceSettings.ModifyParamsPaymentPayout and BalanceSettings.Payment.Payoutsaturday and sunday from enums BalanceSettings.ModifyParamsPaymentPayoutSchedule.weekly_payout_days and BalanceSettings.Payment.Payout.Schedule.weekly_payout_daysBalanceSettings.ModifyParamsPaymentSettlementTiming.delay_days_override from longInteger to emptyable(longInteger)BalanceSettings.ModifyParams.payments to be optionaldelay_days_override on BalanceSettings.Payment.SettlementTimingautomatic_tax and invoice_creation on checkout.Session.ModifyParamsunit_label on checkout.Session.ModifyParamsLineItemPriceDatumProductDatuminvoice_settings on checkout.Session.ModifyParamsSubscriptionDatumCheckout.Session.CollectedInformation.business_name to be requiredintended_submission_method on Dispute.ModifyParams and DisputeDispute.SmartDispute.recommended_evidence from string to array(string)pix on Invoice.CreateParamsPaymentSettingPaymentMethodOption, Invoice.ModifyParamsPaymentSettingPaymentMethodOption, Invoice.PaymentSetting.PaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.CreateParamsPaymentSettingPaymentMethodOption, Subscription.ModifyParamsPaymentSettingPaymentMethodOption, and Subscription.PaymentSetting.PaymentMethodOptionpix on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_typesbilling_schedules on Invoice.CreatePreviewParamsSubscriptionDetail, Subscription.CreateParams, Subscription.ModifyParams, and Subscriptionpaypay on PaymentAttemptRecord.PaymentMethodDetail and PaymentRecord.PaymentMethodDetailwallet on PaymentAttemptRecord.PaymentMethodDetail.Card and PaymentRecord.PaymentMethodDetail.CardPaymentAttemptRecord.ProcessorDetail.Custom.payment_reference and PaymentRecord.ProcessorDetail.Custom.payment_reference from string to nullable(string)flexible on QuotePreviewSubscriptionSchedule.BillingModebilled_until on SubscriptionItemfinancial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on QuotePreviewInvoice.LastFinalizationErrorAdd support for new resource v2.billing.PricingPlanSubscriptionComponents
v2.billing.PricingPlanSubscriptionComponentsretrieve method on resource v2.billing.PricingPlanSubscriptionComponentsdimension_payload_keys on Billing.Meter and billing.MeterCreateParamsdimension_filters and dimension_group_by_keys on billing.BillingMeterListMeterEventSummaryParamsdimensions on Billing.MeterEventSummaryfulfillment_details and payment_method_data on delegated_checkout.RequestedSessionCreateParams and delegated_checkout.RequestedSessionModifyParamsline_item_details, metadata, payment_method, and shared_metadata on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParamscurrency, customer, and risk_details on delegated_checkout.RequestedSessionCreateParamsseller_details and setup_future_usage on DelegatedCheckout.RequestedSession and delegated_checkout.RequestedSessionCreateParamsamount_subtotal, amount_total, created_at, expires_at, order_details, shared_payment_issued_token, status, total_details, and updated_at on DelegatedCheckout.RequestedSessionaddress, email, fulfillment_options, name, phone, and selected_fulfillment_option on DelegatedCheckout.RequestedSession.FulfillmentDetailbillie, 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_typeAdd support for new resources delegated_checkout.RequestedSession and identity.BlocklistEntry
delegated_checkout.RequestedSession and identity.BlocklistEntryconfirm, create, expire, modify, and retrieve methods on resource delegated_checkout.RequestedSessioncreate, disable, list, and retrieve methods on resource identity.BlocklistEntryblocked_by_entry on Identity.VerificationReport.Document, Identity.VerificationReport.Selfie, and identity.VerificationReportListParamsAdd support for new resource PaymentMethodBalance
PaymentMethodBalancecheck_balance method on resource PaymentMethodbenefits on Card, Charge.PaymentMethodDetail.Card, ConfirmationToken.PaymentMethodPreview.Card, and PaymentMethod.Cardbenefit on PaymentIntent.PaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetailsetup_details on SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntentcard_creator on enums V2.Core.Account.applied_configurations and v2.core.AccountCloseParams.applied_configurationscard_creator on V2.Core.Account.Configuration, V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.AccountCreateParamsConfiguration, v2.core.AccountCreateParamsIdentityAttestationTermsOfService, v2.core.AccountModifyParamsConfiguration, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServicecommercial.celtic.charge_card, commercial.celtic.spend_card, commercial.cross_river_bank.charge_card, commercial.cross_river_bank.spend_card, commercial.stripe.charge_card, and commercial.stripe.prepaid_card on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitycard_creator on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.configurationconfiguration.card_creator on enums v2.core.AccountCreateParams.include, v2.core.AccountModifyParams.include, and v2.core.AccountRetrieveParams.includeV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationCardCreatorUpdatedEvent with related object v2.core.AccountV1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, and V1CustomerDiscountUpdatedEvent with related object DiscountIt is built on top of SDK version 13.0.0 and 13.1.0-beta.1 which contain breaking changes. Please review the changelog for these versions if upgrading…
This release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 13.0.0 and 13.1.0-beta.1 which contain breaking changes. Please review the changelog for these versions if upgrading from older SDK versions.
v2.money_management.RecipientVerificationacknowledge, create, recipient_verifications, and retrieve methods on resource v2.money_management.RecipientVerificationmodify method on resources v2.billing.PricingPlanSubscription and v2.billing.ServiceActioncrypto_wallets on V2.Account.Configuration.RecipientDatum.Feature, V2.Core.Account.Configuration.Recipient.Capability, v2.Account.CreateParamsConfigurationRecipientDatumFeature, v2.Account.ModifyParamsConfigurationRecipientDatumFeature, v2.core.Account.CreateParamsConfigurationRecipientCapability, and v2.core.Account.ModifyParamsConfigurationRecipientCapabilitycrypto on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitycrypto_wallet on enum V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.typecrypto_wallets on enum V2.Account.Configuration.SupportableFeature.recipient_datacrypto_wallets on enum V2.Account.Requirement.Impact.required_for_featureslookup_key on V2.Billing.Cadence, v2.billing.Cadence.CreateParams, and v2.billing.Cadence.ModifyParamssettings_data on V2.Billing.CadenceV2.Billing.Cadence.Payer.billing_profile from nullable(string) to stringv1_event_id on V2.Core.Eventrecipient_verification on V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundTransfer, v2.money_management.OutboundPayment.CreateParams, and v2.money_management.OutboundTransfer.CreateParamscrypto_wallet on V2.MoneyManagement.PayoutMethod and v2.money_management.OutboundSetupIntent.CreateParamsPayoutMethodDatumcustom_pricing_unit_details on V2.Billing.RateCardRate.CustomPricingUnitAmount, V2.Billing.ServiceAction.CreditGrant.Amount.CustomPricingUnit, and V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.CustomPricingUnitorigin_type on V2.MoneyManagement.ReceivedDebit.BankTransfersepa_credit_transfer on enum v2.FinancialAddressCreditSimulation.CreditParams.networkcredentials.sepa_bank_account.iban on enums v2.money_management.FinancialAddress.ListParams.include and v2.money_management.FinancialAddress.RetrieveParams.includesepa_bank_account on v2.money_management.FinancialAddress.CreateParamsprice on v2.billing.RateCardRate.CreateParamslookup_keys on v2.billing.Cadence.ListParamsv2.billing.Cadence.CancelParams.include, v2.billing.Cadence.CreateParams.include, v2.billing.Cadence.ListParams.include, v2.billing.Cadence.ModifyParams.include, and v2.billing.Cadence.RetrieveParams.include from literal('invoice_discount_rules') to enum('invoice_discount_rules'|'settings_data')customer and type on v2.billing.Cadence.CreateParamsPayerv2.billing.Cadence.CreateParamsPayer.billing_profile to be requiredcrypto_wallets on enum EventsAccountConfigurationRecipientDataFeatureStatusUpdatedEvent.feature_namecrypto_wallets_v2 on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityalert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEventV1AccountUpdatedEvent with related object v2.AccountV1ApplicationFeeCreatedEvent, V1ApplicationFeeRefundedEvent, V1BillingPortalConfigurationCreatedEvent, V1BillingPortalConfigurationUpdatedEvent, V1CapabilityUpdatedEvent, V1ChargeCapturedEvent, V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, V1ChargeDisputeUpdatedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundUpdatedEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, V1ChargeUpdatedEvent, V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, V1CheckoutSessionExpiredEvent, V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, V1ClimateOrderProductSubstitutedEvent, V1ClimateProductCreatedEvent, V1ClimateProductPricingUpdatedEvent, V1CouponCreatedEvent, V1CouponDeletedEvent, V1CouponUpdatedEvent, V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, V1CreditNoteVoidedEvent, V1CustomerCreatedEvent, V1CustomerDeletedEvent, V1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, V1CustomerDiscountUpdatedEvent, V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, V1CustomerSubscriptionUpdatedEvent, V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, V1CustomerTaxIdUpdatedEvent, V1CustomerUpdatedEvent, V1FileCreatedEvent, V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, V1FinancialConnectionsAccountRefreshedTransactionsEvent, V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, V1IdentityVerificationSessionVerifiedEvent, V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentPaidEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, V1InvoiceWillBeDueEvent, V1InvoiceitemCreatedEvent, V1InvoiceitemDeletedEvent, V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, V1IssuingAuthorizationUpdatedEvent, V1IssuingCardCreatedEvent, V1IssuingCardUpdatedEvent, V1IssuingCardholderCreatedEvent, V1IssuingCardholderUpdatedEvent, V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, V1IssuingDisputeUpdatedEvent, V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, V1IssuingPersonalizationDesignUpdatedEvent, V1IssuingTokenCreatedEvent, V1IssuingTokenUpdatedEvent, V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, V1IssuingTransactionUpdatedEvent, V1MandateUpdatedEvent, V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, V1PaymentIntentSucceededEvent, V1PaymentLinkCreatedEvent, V1PaymentLinkUpdatedEvent, V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, V1PaymentMethodUpdatedEvent, V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, V1PayoutUpdatedEvent, V1PersonCreatedEvent, V1PersonDeletedEvent, V1PersonUpdatedEvent, V1PlanCreatedEvent, V1PlanDeletedEvent, V1PlanUpdatedEvent, V1PriceCreatedEvent, V1PriceDeletedEvent, V1PriceUpdatedEvent, V1ProductCreatedEvent, V1ProductDeletedEvent, V1ProductUpdatedEvent, V1PromotionCodeCreatedEvent, V1PromotionCodeUpdatedEvent, V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, V1QuoteFinalizedEvent, V1RadarEarlyFraudWarningCreatedEvent, V1RadarEarlyFraudWarningUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, V1RefundUpdatedEvent, V1ReviewClosedEvent, V1ReviewOpenedEvent, V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, V1SetupIntentSucceededEvent, V1SigmaScheduledQueryRunCreatedEvent, V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, V1SourceRefundAttributesRequiredEvent, V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, V1SubscriptionScheduleUpdatedEvent, V1TaxRateCreatedEvent, V1TaxRateUpdatedEvent, V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, V1TerminalReaderActionUpdatedEvent, V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, V1TestHelpersTestClockReadyEvent, V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, V1TopupSucceededEvent, V1TransferCreatedEvent, V1TransferReversedEvent, V1TransferUpdatedEvent, V2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, and V2CoreHealthIssuingAuthorizationRequestErrorsResolvedEventV2CoreClaimableSandboxCreatedEvent with related object v2.core.ClaimableSandboxV2MoneyManagementRecipientVerificationCreatedEvent and V2MoneyManagementRecipientVerificationUpdatedEvent with related object v2.money_management.RecipientVerificationaccount_rate_limit_exceeded on RateLimitErrorAdd new async optional dependency. Now, pip install stripe[async] gets you everything you need to make async HTTP calls out of the box.
#1633 add httpx to optional deps and only ship tests in sdist
async optional dependency. Now, pip install stripe[async] gets you everything you need to make async HTTP calls out of the box.#1632 remove gpg step from publish
#1627 Re-add tests to our sdist
#1626 Make nested params classes importable
from stripe.params.checkout import SessionCreateParamsDiscount would raise an error. Now it is valid#1620 Remove manual promotion code test
#1619 Update param in deprecation docs link
v13.0.0, from stripe.params.checkout import SessionCreateParamsDiscount would raise an error when it shouldn't have. This is fixed.tests to our sdist
async optional dependency
pip install stripe[async] gets you everything you need to make async HTTP calls out of the box.This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)
This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)
#1604 Fixed InvoiceLineItem method definition
InvoiceLineItem.modify and InvoiceLineItem.modify_async now require invoice and line_item_id as method parameters.
InvoiceLineItem.ModifyParam class. Use a typing.dict to type hint instead.#1538 ⚠️ Add strongly typed EventNotifications We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
EventNotification classes to every v2 Event. For example, there's now a V1BillingMeterErrorReportTriggeredEventNotification to match the existing V1BillingMeterErrorReportTriggeredEvent. Each notification class defines a fetch_event() method to retrieve its corresponding event. For events with related objects, there's a fetch_related_object() method that performs the API call and casts the response to the correct type.StripeClient.parse_thin_event to StripeClient.parse_event_notification and remove the Stripe.ThinEvent class.
stripe.v2.core.EventNotification (which is the shared base class that all of the more specific stripe.events.*EventNotification classes share) instead of Stripe.ThinEvent. When applicable, these event notifications will have the related_object property and a fetch_related_object() function. They also have a fetch_() method to retrieve their corresponding stripe.events.*Event instance.Stripe.Events.UnknownEventNotification instead of a more specific type. It has both the relatedObject property and the FetchRelatedObject() function (but they may be/return null)#1602 Move V2.Event API resources to V2.Core.Events
stripe.v2._event and stripe.v2._event_destination to stripe.v2.core._event and stripe.v2.core._event_destination respectively. They now correctly match their API path#1589 Add StripeContext object
StripeContext class. Previously, one could only pass a string for stripe_context. You can now use the new class as well.EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext#1565 ⚠️ Build SDK w/ V2 OpenAPI spec
StripeClient.v2 namespace) now return a V2DeletedObject which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.Dict[str, Any]. Because there were no params, it's unlikely you were using these classes.#1569 Renamed Urllib2Client to UrllibClient
http_client.Urllib2Client to http_client.UrllibClient as Python urllib2 was renamed to urllib in Python 3.#1606 ⚠️ drop support for Python 3.6 & clarify version policy
#1596 ⚠️ Unify resource and service method parameters into one class
_stripe._account.Account.CreateParams and _stripe._account_service.CreateParams have moved to _stripe.params._account_create_params.AccountCreateParams#1572 migrate from setup.py to pyproject.toml
setup.py to pyproject.toml. As a result, we're dropping support for pip < 10.0.0 (released April 2018).#1570 Don't use mutable default arguments
None as the default function argument instead of {}⚠️ Deprecated the V1 service accessors living directly under StripeClient(e.g. customers, products) as they were copied under the new V1 service in our last release. Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.
client = StripeClient("sk_test...")
# Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
- client.customers.list()
+ client.v1.customers.list()
Refer to the migration guide for help upgrading.
#1603 ⚠️ Remove deprecated compatibility exports
stripe module directly; now that's the only place to import them. Specifically, we removed:
stripe.stripe_responsestripe.stripe_objectstripe.error_objectstripe.errorstripe.http_clientstripe.utilstripe.oauthstripe.webhookstripe.multipart_data_generatorstripe.request_metricsstripe.api_resources.abstractstripe.api_resourcesTo update your code, follow this pattern:
-from stripe.<MODULE> import SomeClass
+from stripe import SomeClass
-stripe.<MODULE>.SomeClass
+stripe.SomeClass
FileUpload aliasTo update your code:
-from stripe import FileUpload
-from stripe.api_resources import FileUpload
+from stripe import File
io import from stripe._util. If you had code relying on stripe.util.io, you'll need to import the io package directly yourself.UrllibClient to stripe to make creating your own HTTP client easier.#1567, #1593, #1607, #1605 Update generated code based on incoming API changes in the 2025-09-30.clover API version.
balance_report and payout_reconciliation_report on AccountSession.Component and AccountSession.CreateParamsComponentsaturday and sunday from enums Account.CreateParamsSettingPayoutSchedule.weekly_payout_days, Account.ModifyParamsSettingPayoutSchedule.weekly_payout_days, and Account.Setting.Payout.Schedule.weekly_payout_daysiterations on Invoice.CreatePreviewParamsScheduleDetailPhase, SubscriptionSchedule.CreateParamsPhase, and SubscriptionSchedule.ModifyParamsPhaselink and pay_by_bank on PaymentMethod.ModifyParamscoupon on Discount, PromotionCode.CreateParams, and PromotionCode. Use Discount.source.coupon, PromotionCode.CreateParams.promotion.coupon, and PromotionCode.promotion.coupon instead.prevented on enum Dispute.statusInvoice.id to be required.BalanceSettingsmodify and retrieve methods on resource BalanceSettingsexternal_request and unsupported_business_type on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.codesource on Discountmb_way_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapabilitytrial_update_behavior on BillingPortal.Configuration.Feature.SubscriptionUpdate, billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdate, and billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdatemb_way on Charge.PaymentMethodDetail, ConfirmationToken.CreateParamsPaymentMethodDatum, ConfirmationToken.PaymentMethodPreview, PaymentIntent.ConfirmParamsPaymentMethodDatum, PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodDatum, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodDatum, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentMethod.CreateParams, PaymentMethod, SetupIntent.ConfirmParamsPaymentMethodDatum, SetupIntent.CreateParamsPaymentMethodDatum, and SetupIntent.ModifyParamsPaymentMethodDatumbranding_settings and name_collection on Checkout.Session and checkout.Session.CreateParamsexcluded_payment_method_types on Checkout.Session, PaymentIntent.ConfirmParams, PaymentIntent.ModifyParams, and checkout.Session.CreateParamsunit_label on Invoice.AddLinesParamsLinePriceDatumProductDatum, Invoice.UpdateLinesParamsLinePriceDatumProductDatum, InvoiceLineItem.ModifyParamsPriceDatumProductDatum, PaymentLink.CreateParamsLineItemPriceDatumProductDatum, and checkout.Session.CreateParamsLineItemPriceDatumProductDatumalma, billie, and satispay on Checkout.Session.PaymentMethodOption and checkout.Session.CreateParamsPaymentMethodOptiondemo_pay on checkout.Session.CreateParamsPaymentMethodOptioncapture_method on Checkout.Session.PaymentMethodOption.Affirm, Checkout.Session.PaymentMethodOption.AfterpayClearpay, Checkout.Session.PaymentMethodOption.AmazonPay, Checkout.Session.PaymentMethodOption.Card, Checkout.Session.PaymentMethodOption.Cashapp, Checkout.Session.PaymentMethodOption.Klarna, Checkout.Session.PaymentMethodOption.Link, Checkout.Session.PaymentMethodOption.Mobilepay, Checkout.Session.PaymentMethodOption.RevolutPay, checkout.Session.CreateParamsPaymentMethodOptionAffirm, checkout.Session.CreateParamsPaymentMethodOptionAfterpayClearpay, checkout.Session.CreateParamsPaymentMethodOptionAmazonPay, checkout.Session.CreateParamsPaymentMethodOptionCard, checkout.Session.CreateParamsPaymentMethodOptionCashapp, checkout.Session.CreateParamsPaymentMethodOptionKlarna, checkout.Session.CreateParamsPaymentMethodOptionLink, checkout.Session.CreateParamsPaymentMethodOptionMobilepay, and checkout.Session.CreateParamsPaymentMethodOptionRevolutPayflexible on Invoice.CreatePreviewParamsScheduleDetailBillingMode, Invoice.CreatePreviewParamsSubscriptionDetailBillingMode, Quote.CreateParamsSubscriptionDatumBillingMode, Quote.SubscriptionDatum.BillingMode, Subscription.BillingMode, Subscription.CreateParamsBillingMode, Subscription.MigrateParamsBillingMode, SubscriptionSchedule.BillingMode, SubscriptionSchedule.CreateParamsBillingMode, and checkout.Session.CreateParamsSubscriptionDatumBillingModebusiness_name and individual_name on Checkout.Session.CollectedInformation, Checkout.Session.CustomerDetail, Customer.CreateParams, Customer.ModifyParams, and Customermb_way on enums ConfirmationToken.CreateParamsPaymentMethodDatum.type, PaymentIntent.ConfirmParamsPaymentMethodDatum.type, PaymentIntent.CreateParamsPaymentMethodDatum.type, PaymentIntent.ModifyParamsPaymentMethodDatum.type, SetupIntent.ConfirmParamsPaymentMethodDatum.type, SetupIntent.CreateParamsPaymentMethodDatum.type, and SetupIntent.ModifyParamsPaymentMethodDatum.typemb_way on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typemb_way on enums Customer.ListPaymentMethodsParams.type, PaymentMethod.CreateParams.type, and PaymentMethod.ListParams.typechargeback_loss_reason_code on Dispute.PaymentMethodDetail.Klarnanet_amount and proration_details on InvoiceItemfraud_disputability_likelihood and risk_assessment on issuing.Authorization.CreateParamssecond_line on Issuing.Cardmb_way on enums PaymentIntent.CreateParams.excluded_payment_method_types and PaymentIntent.excluded_payment_method_typesfr_meal_voucher_conecs on PaymentMethodConfiguration.CreateParams and PaymentMethodConfiguration.ModifyParamspromotion on PromotionCode.CreateParams and PromotionCodeacknowledged and payment_never_settled on enum Review.closed_reasonprovider on Tax.Settings.Defaultbbpos_wisepad3 on Terminal.Configuration, terminal.Configuration.CreateParams, and terminal.Configuration.ModifyParamsaddress_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.Location, terminal.Location.CreateParams, and terminal.Location.ModifyParamsterminal.Location.CreateParams.address to be optionalterminal.Location.CreateParams.display_name to be optional2025-09-30.clover on enum WebhookEndpoint.CreateParams.api_versionfinancial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2025-09-30.clover.
This release contains breaking changes (prefixed with ⚠️ below)
⚠️ #1565 Build SDK w/ V2 OpenAPI spec
StripeClient.v2 namespace) now return a V2DeletedObject which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.Dict[str, Any]. Because there were no params, it's unlikely you were using these classes.#1570 Don't use mutable default arguments
None as the default function argument instead of {}⚠️ #1569 Renamed Urllib2Client to UrllibClient
http_client.Urllib2Client to http_client.UrllibClient as Python urllib2 was renamed to urllib in Python 3.⚠️ #1572 migrate from setup.py to pyproject.toml
setup.py to pyproject.toml. As a result, we're dropping support for pip < 10.0.0 (released April 2018).⚠️ #1589 Add StripeContext object
StripeContext class. Previously, one could only pass a string for stripe_context. You can now use the new class as well.EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext⚠️ #1538 Add strongly typed EventNotifications
We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
EventNotification classes to every v2 Event. For example, there's now a V1BillingMeterErrorReportTriggeredEventNotification to match the existing V1BillingMeterErrorReportTriggeredEvent. Each notification class defines a fetch_event() method to retrieve its corresponding event. For events with related objects, there's a fetch_related_object() method that performs the API call and casts the response to the correct type.StripeClient.parse_thin_event to StripeClient.parse_event_notification and remove the Stripe.ThinEvent class.
stripe.v2.core.EventNotification (which is the shared base class that all of the more specific stripe.events.*EventNotification classes share) instead of Stripe.ThinEvent. When applicable, these event notifications will have the related_object property and a fetch_related_object() function. They also have a fetch_() method to retrieve their corresponding stripe.events.*Event instance.Stripe.Events.UnknownEventNotification instead of a more specific type. It has both the relatedObject property and the FetchRelatedObject() function (but they may be/return null)⚠️ #1604 Fixed InvoiceLineItem method definition
InvoiceLineItem.modify and InvoiceLineItem.modify_async now require invoice and line_item_id as method parameters.
InvoiceLineItem.ModifyParam class. Use a typing.dict to type hint instead.⚠️ #1602 Move V2.Event API resources to V2.Core.Events
stripe.v2._event and stripe.v2._event_destination to stripe.v2.core._event and stripe.v2.core._event_destination respectively. They now correctly match their API path⚠️ #1603 Remove deprecated compatibility exports
stripe module directly; now that's the only place to import them. Specifically, we removed:
stripe.stripe_responsestripe.stripe_objectstripe.error_objectstripe.errorstripe.http_clientstripe.utilstripe.oauthstripe.webhookstripe.multipart_data_generatorstripe.request_metricsstripe.api_resources.abstractstripe.api_resourcesTo update your code, follow this pattern:
-from stripe.<MODULE> import SomeClass
+from stripe import SomeClass
-stripe.<MODULE>.SomeClass
+stripe.SomeClass
FileUpload aliasTo update your code:
-from stripe import FileUpload
-from stripe.api_resources import FileUpload
+from stripe import File
io import from stripe._util. If you had code relying on stripe.util.io, you'll need to import the io package directly yourself.UrllibClient to stripe to make creating your own HTTP client easier.⚠️ Deprecated the V1 service accessors living directly under StripeClient(e.g. customers, products) as they were copied under the new V1 service in our last release. Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.
client = StripeClient("sk_test...")
# Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
- client.customers.list()
+ client.v1.customers.list()
Refer to the migration guide for help upgrading.
⚠️ #1606 drop support for Python 3.6 & clarify version policy
⚠️ #1596 Unify resource and service method parameters into one class
_stripe._account.Account.CreateParams and _stripe._account_service.CreateParams have moved to _stripe.params._account_create_params.AccountCreateParams⚠️ #1567 , #1593, #1607, #1605 Update generated code based on incoming API changes in the 2025-09-30.clover API version.
balance_report and payout_reconciliation_report on AccountSession.Component and AccountSession.CreateParamsComponentsaturday and sunday from enums Account.CreateParamsSettingPayoutSchedule.weekly_payout_days, Account.ModifyParamsSettingPayoutSchedule.weekly_payout_days, and Account.Setting.Payout.Schedule.weekly_payout_daysiterations on Invoice.CreatePreviewParamsScheduleDetailPhase, SubscriptionSchedule.CreateParamsPhase, and SubscriptionSchedule.ModifyParamsPhaselink and pay_by_bank on PaymentMethod.ModifyParamscoupon on Discount, PromotionCode.CreateParams, and PromotionCode. Use Discount.source.coupon, PromotionCode.CreateParams.promotion.coupon, and PromotionCode.promotion.coupon instead.prevented on enum Dispute.statusInvoice.id to be required.BalanceSettingsmodify and retrieve methods on resource BalanceSettingsexternal_request and unsupported_business_type on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.codesource on Discountmb_way_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapabilitytrial_update_behavior on BillingPortal.Configuration.Feature.SubscriptionUpdate, billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdate, and billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdatemb_way on Charge.PaymentMethodDetail, ConfirmationToken.CreateParamsPaymentMethodDatum, ConfirmationToken.PaymentMethodPreview, PaymentIntent.ConfirmParamsPaymentMethodDatum, PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodDatum, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodDatum, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentMethod.CreateParams, PaymentMethod, SetupIntent.ConfirmParamsPaymentMethodDatum, SetupIntent.CreateParamsPaymentMethodDatum, and SetupIntent.ModifyParamsPaymentMethodDatumbranding_settings and name_collection on Checkout.Session and checkout.Session.CreateParamsexcluded_payment_method_types on Checkout.Session, PaymentIntent.ConfirmParams, PaymentIntent.ModifyParams, and checkout.Session.CreateParamsunit_label on Invoice.AddLinesParamsLinePriceDatumProductDatum, Invoice.UpdateLinesParamsLinePriceDatumProductDatum, InvoiceLineItem.ModifyParamsPriceDatumProductDatum, PaymentLink.CreateParamsLineItemPriceDatumProductDatum, and checkout.Session.CreateParamsLineItemPriceDatumProductDatumalma, billie, and satispay on Checkout.Session.PaymentMethodOption and checkout.Session.CreateParamsPaymentMethodOptiondemo_pay on checkout.Session.CreateParamsPaymentMethodOptioncapture_method on Checkout.Session.PaymentMethodOption.Affirm, Checkout.Session.PaymentMethodOption.AfterpayClearpay, Checkout.Session.PaymentMethodOption.AmazonPay, Checkout.Session.PaymentMethodOption.Card, Checkout.Session.PaymentMethodOption.Cashapp, Checkout.Session.PaymentMethodOption.Klarna, Checkout.Session.PaymentMethodOption.Link, Checkout.Session.PaymentMethodOption.Mobilepay, Checkout.Session.PaymentMethodOption.RevolutPay, checkout.Session.CreateParamsPaymentMethodOptionAffirm, checkout.Session.CreateParamsPaymentMethodOptionAfterpayClearpay, checkout.Session.CreateParamsPaymentMethodOptionAmazonPay, checkout.Session.CreateParamsPaymentMethodOptionCard, checkout.Session.CreateParamsPaymentMethodOptionCashapp, checkout.Session.CreateParamsPaymentMethodOptionKlarna, checkout.Session.CreateParamsPaymentMethodOptionLink, checkout.Session.CreateParamsPaymentMethodOptionMobilepay, and checkout.Session.CreateParamsPaymentMethodOptionRevolutPayflexible on Invoice.CreatePreviewParamsScheduleDetailBillingMode, Invoice.CreatePreviewParamsSubscriptionDetailBillingMode, Quote.CreateParamsSubscriptionDatumBillingMode, Quote.SubscriptionDatum.BillingMode, Subscription.BillingMode, Subscription.CreateParamsBillingMode, Subscription.MigrateParamsBillingMode, SubscriptionSchedule.BillingMode, SubscriptionSchedule.CreateParamsBillingMode, and checkout.Session.CreateParamsSubscriptionDatumBillingModebusiness_name and individual_name on Checkout.Session.CollectedInformation, Checkout.Session.CustomerDetail, Customer.CreateParams, Customer.ModifyParams, and Customermb_way on enums ConfirmationToken.CreateParamsPaymentMethodDatum.type, PaymentIntent.ConfirmParamsPaymentMethodDatum.type, PaymentIntent.CreateParamsPaymentMethodDatum.type, PaymentIntent.ModifyParamsPaymentMethodDatum.type, SetupIntent.ConfirmParamsPaymentMethodDatum.type, SetupIntent.CreateParamsPaymentMethodDatum.type, and SetupIntent.ModifyParamsPaymentMethodDatum.typemb_way on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typemb_way on enums Customer.ListPaymentMethodsParams.type, PaymentMethod.CreateParams.type, and PaymentMethod.ListParams.typechargeback_loss_reason_code on Dispute.PaymentMethodDetail.Klarnanet_amount and proration_details on InvoiceItemfraud_disputability_likelihood and risk_assessment on issuing.Authorization.CreateParamssecond_line on Issuing.Cardmb_way on enums PaymentIntent.CreateParams.excluded_payment_method_types and PaymentIntent.excluded_payment_method_typesfr_meal_voucher_conecs on PaymentMethodConfiguration.CreateParams and PaymentMethodConfiguration.ModifyParamspromotion on PromotionCode.CreateParams and PromotionCodeacknowledged and payment_never_settled on enum Review.closed_reasonprovider on Tax.Settings.Defaultbbpos_wisepad3 on Terminal.Configuration, terminal.Configuration.CreateParams, and terminal.Configuration.ModifyParamsaddress_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.Location, terminal.Location.CreateParams, and terminal.Location.ModifyParamsterminal.Location.CreateParams.address to be optionalterminal.Location.CreateParams.display_name to be optional2025-09-30.clover on enum WebhookEndpoint.CreateParams.api_versionfinancial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2025-08-27.preview.
This release changes the pinned API version to 2025-08-27.preview.
list and retrieve methods on resource InvoicePaymentlist method on resource Mandateapplied on V2.Core.Account.Configuration.Customer, V2.Core.Account.Configuration.Merchant, V2.Core.Account.Configuration.Recipient, V2.Core.Account.Configuration.Storer, v2.core.Account.ModifyParamsConfigurationCustomer, v2.core.Account.ModifyParamsConfigurationMerchant, v2.core.Account.ModifyParamsConfigurationRecipient, and v2.core.Account.ModifyParamsConfigurationStorerao_nif, az_tin, bd_etin, cr_cpj, cr_nite, do_rcn, gt_nit, kz_bin, mz_nuit, pe_ruc, pk_ntn, sa_crn, and sa_tin on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.Account.CreateParamsIdentityBusinessDetailIdNumber.type, and v2.core.Account.ModifyParamsIdentityBusinessDetailIdNumber.typeao_nif, az_tin, bd_brc, bd_etin, bd_nid, cr_cpf, cr_dimex, cr_nite, do_rcn, gt_nit, kz_iin, mz_nuit, pe_dni, pk_cnic, pk_snic, and sa_tin on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.Person.IdNumber.type, v2.core.Account.CreateParamsIdentityIndividualIdNumber.type, v2.core.Account.ModifyParamsIdentityIndividualIdNumber.type, v2.core.Person.CreateParamsIdNumber.type, and v2.core.Person.ModifyParamsIdNumber.typeBilling.AlertTriggered.value from longInteger to decimal_stringdisplay_name on V2.MoneyManagement.FinancialAccount and v2.money_management.FinancialAccount.CreateParamscurrency_conversion on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.categorycurrency_conversion on V2.MoneyManagement.Transaction.Flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flowcurrency_conversion on enums V2.MoneyManagement.Transaction.Flow.type and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.typepayments on BalanceSettings.ModifyParams and BalanceSettingsdebit_negative_balances, payouts, and settlement_timing on BalanceSettings.ModifyParams and BalanceSettingsmandate on Charge.PaymentMethodDetail.Pix, PaymentAttemptRecord.PaymentMethodDetail.Pix, and PaymentRecord.PaymentMethodDetail.Pixcoupon_data on checkout.Session.CreateParamsDiscountmandate_options on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.ConfirmParamsPaymentMethodOptionPix, PaymentIntent.CreateParamsPaymentMethodOptionPix, PaymentIntent.ModifyParamsPaymentMethodOptionPix, PaymentIntent.PaymentMethodOption.Pix, and checkout.Session.CreateParamsPaymentMethodOptionPixCheckout.Session.PaymentMethodOption.Pix.setup_future_usage, PaymentIntent.ConfirmParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntent.PaymentMethodOption.Pix.setup_future_usage, and checkout.Session.CreateParamsPaymentMethodOptionPix.setup_future_usage from literal('none') to enum('none'|'off_session')amount on Mandate.MultiUse, PaymentAttemptRecord, and PaymentRecordcurrency on Mandate.MultiUsepix on Mandate.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.ConfirmParamsPaymentMethodOption, SetupIntent.CreateParamsPaymentMethodOption, SetupIntent.ModifyParamsPaymentMethodOption, and SetupIntent.PaymentMethodOptionlimit on PaymentAttemptRecord.ListParamsamount_authorized, amount_refunded, and application on PaymentAttemptRecord and PaymentRecordprocessor_details on PaymentAttemptRecord, PaymentRecord.ReportPaymentParams, and PaymentRecordpayment_reference on PaymentAttemptRecord, PaymentRecord.ReportPaymentParams, and PaymentRecordinstallments on PaymentAttemptRecord.PaymentMethodDetail.Alma and PaymentRecord.PaymentMethodDetail.Almatransaction_id on PaymentAttemptRecord.PaymentMethodDetail.Alma, PaymentAttemptRecord.PaymentMethodDetail.AmazonPay, PaymentAttemptRecord.PaymentMethodDetail.Billie, PaymentAttemptRecord.PaymentMethodDetail.KakaoPay, PaymentAttemptRecord.PaymentMethodDetail.KrCard, PaymentAttemptRecord.PaymentMethodDetail.NaverPay, PaymentAttemptRecord.PaymentMethodDetail.Payco, PaymentAttemptRecord.PaymentMethodDetail.RevolutPay, PaymentAttemptRecord.PaymentMethodDetail.SamsungPay, PaymentAttemptRecord.PaymentMethodDetail.Satispay, PaymentRecord.PaymentMethodDetail.Alma, PaymentRecord.PaymentMethodDetail.AmazonPay, PaymentRecord.PaymentMethodDetail.Billie, PaymentRecord.PaymentMethodDetail.KakaoPay, PaymentRecord.PaymentMethodDetail.KrCard, PaymentRecord.PaymentMethodDetail.NaverPay, PaymentRecord.PaymentMethodDetail.Payco, PaymentRecord.PaymentMethodDetail.RevolutPay, PaymentRecord.PaymentMethodDetail.SamsungPay, and PaymentRecord.PaymentMethodDetail.Satispaylocation and reader on PaymentAttemptRecord.PaymentMethodDetail.Paynow and PaymentRecord.PaymentMethodDetail.Paynowlatest_active_mandate on PaymentMethodPayout.payout_method to be requiredmetadata and period on QuotePreviewSubscriptionSchedule.Phase.AddInvoiceItempix_display_qr_code on SetupIntent.NextActionreader_security on Terminal.Configuration, terminal.Configuration.CreateParams, and terminal.Configuration.ModifyParamscustomer_session_expired and india_recurring_payment_mandate_canceled on QuotePreviewInvoice.LastFinalizationErrorAdd support for retrieve method on resource V2.Core.ClaimableSandbox
retrieve method on resource V2.Core.ClaimableSandboxmonth_of_year on V2.Billing.Cadence#create.billing_cycle.month and V2.Billing.Cadence.billing_cycle.monthclaimed_at, expires_at, sandbox_details, and status on V2.Core.ClaimableSandboxapi_keys on V2.Core.ClaimableSandboxV2.Core.ClaimableSandbox.claim_url from string to nullable(string)current_billing_period_end on enums V2.Billing.Intent#create.actions[].deactivate.effective_at.type and V2.Billing.IntentAction.deactivate.effective_at.typewill_activate_at and will_cancel_at on V2.Billing.PricingPlanSubscription.servicing_status_transitions and V2.Billing.RateCardSubscription.servicing_status_transitionscategory and priority on V2.Billing.ServiceAction#create.credit_grant_per_tenant, V2.Billing.ServiceAction#create.credit_grant, V2.Billing.ServiceAction.credit_grant_per_tenant, and V2.Billing.ServiceAction.credit_grantV2.Billing.LicenseFee#update.display_name to be optionalinvoices on EventsV2BillingCadenceBilledEventV2CoreClaimableSandboxClaimedEvent, V2CoreClaimableSandboxExpiredEvent, V2CoreClaimableSandboxExpiringEvent, and V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent with related object V2.Core.ClaimableSandboxV2BillingCadenceErroredEvent with related object V2.Billing.CadenceAdd support for attach_cadence method on resource Subscription
attach_cadence method on resource Subscriptioncurrency and external_customer_id on Billing.AlertTriggeredcustom_pricing_unit on Billing.AlertTriggered, Billing.CreditBalanceSummary.Balance.AvailableBalance, Billing.CreditBalanceSummary.Balance.LedgerBalance, Billing.CreditBalanceTransaction.Credit.Amount, Billing.CreditBalanceTransaction.Debit.Amount, Billing.CreditGrant.Amount, and billing.CreditGrant.CreateParamsAmountcustomer on billing.Alert.ListParamsBilling.Alert.alert_type, billing.Alert.CreateParams.alert_type, and billing.Alert.ListParams.alert_type from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')credit_balance_threshold on Billing.Alert and billing.Alert.CreateParamsbillable_items on Billing.CreditGrant.ApplicabilityConfig.Scope, billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope, and billing.CreditGrant.CreateParamsApplicabilityConfigScopeBilling.CreditBalanceSummary.Balance.AvailableBalance.type, Billing.CreditBalanceSummary.Balance.LedgerBalance.type, Billing.CreditBalanceTransaction.Credit.Amount.type, Billing.CreditBalanceTransaction.Debit.Amount.type, Billing.CreditGrant.Amount.type, and billing.CreditGrant.CreateParamsAmount.type from literal('monetary') to enum('custom_pricing_unit'|'monetary')license_fee_subscription_details and rate_card_subscription_details on InvoiceItem.Parent and InvoiceLineItem.ParentInvoiceItem.Parent.type from literal('subscription_details') to enum('license_fee_subscription_details'|'rate_card_subscription_details'|'subscription_details')license_fee_details and rate_card_rate_details on InvoiceItem.Pricing and InvoiceLineItem.PricingInvoiceItem.Pricing.type and InvoiceLineItem.Pricing.type from literal('price_details') to enum('license_fee_details'|'price_details'|'rate_card_rate_details')billing_cadence on Invoice.CreatePreviewParams, Subscription.CreateParams, and Subscriptionbilling_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parentbilling_cadence_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.typelicense_fee_subscription_details and rate_card_subscription_details on enum InvoiceLineItem.Parent.typev2.billing.BillSettingVersion, v2.billing.BillSetting, v2.billing.Cadence, v2.billing.CollectionSettingVersion, v2.billing.CollectionSetting, v2.billing.CustomPricingUnit, v2.billing.IntentAction, v2.billing.Intent, v2.billing.LicenseFeeSubscription, v2.billing.LicenseFeeVersion, v2.billing.LicenseFee, v2.billing.LicensedItem, v2.billing.MeteredItem, v2.billing.PricingPlanComponent, v2.billing.PricingPlanSubscription, v2.billing.PricingPlanVersion, v2.billing.PricingPlan, v2.billing.Profile, v2.billing.RateCardRate, v2.billing.RateCardSubscription, v2.billing.RateCardVersion, v2.billing.RateCard, v2.billing.ServiceAction, v2.core.ClaimableSandbox, v2.reporting.ReportRun, v2.reporting.Report, and v2.tax.AutomaticRulecreate, deactivate, find, modify, and retrieve methods on resource v2.tax.AutomaticRulecreate and retrieve methods on resources v2.billing.ServiceAction and v2.reporting.ReportRunretrieve method on resources v2.billing.LicenseFeeSubscription and v2.reporting.Reportcreate method on resource v2.core.ClaimableSandboxcancel, create, list, modify, and retrieve methods on resources v2.billing.Cadence and v2.billing.RateCardSubscriptioncreate, list, modify, and retrieve methods on resources v2.billing.BillSetting, v2.billing.CollectionSetting, v2.billing.CustomPricingUnit, v2.billing.LicenseFee, v2.billing.LicensedItem, v2.billing.MeteredItem, v2.billing.PricingPlan, v2.billing.Profile, and v2.billing.RateCardlist and retrieve methods on resources v2.billing.BillSettingVersion, v2.billing.CollectionSettingVersion, v2.billing.IntentAction, v2.billing.LicenseFeeVersion, v2.billing.PricingPlanSubscription, v2.billing.PricingPlanVersion, and v2.billing.RateCardVersioncreate, delete, list, and retrieve methods on resource v2.billing.RateCardRatecreate, delete, list, modify, and retrieve methods on resource v2.billing.PricingPlanComponentcancel, commit, create, list, release_reservation, reserve, and retrieve methods on resource v2.billing.Intentchanges on V2.EventV2BillingCadenceBilledEvent, V2BillingCadenceCanceledEvent, V2BillingCadenceCreatedEvent, and V2BillingCadenceErroredEvent with related object v2.billing.CadenceV2BillingLicenseFeeCreatedEvent and V2BillingLicenseFeeUpdatedEvent with related object v2.billing.LicenseFeeV2BillingLicenseFeeVersionCreatedEvent with related object v2.billing.LicenseFeeVersionV2BillingLicensedItemCreatedEvent and V2BillingLicensedItemUpdatedEvent with related object v2.billing.LicensedItemV2BillingMeteredItemCreatedEvent and V2BillingMeteredItemUpdatedEvent with related object v2.billing.MeteredItemV2BillingPricingPlanCreatedEvent and V2BillingPricingPlanUpdatedEvent with related object v2.billing.PricingPlanV2BillingPricingPlanComponentCreatedEvent and V2BillingPricingPlanComponentUpdatedEvent with related object v2.billing.PricingPlanComponentV2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingPricingPlanSubscriptionCollectionCurrentEvent, V2BillingPricingPlanSubscriptionCollectionPastDueEvent, V2BillingPricingPlanSubscriptionCollectionPausedEvent, V2BillingPricingPlanSubscriptionCollectionUnpaidEvent, V2BillingPricingPlanSubscriptionServicingActivatedEvent, V2BillingPricingPlanSubscriptionServicingCanceledEvent, and V2BillingPricingPlanSubscriptionServicingPausedEvent with related object v2.billing.PricingPlanSubscriptionV2BillingPricingPlanVersionCreatedEvent with related object v2.billing.PricingPlanVersionV2BillingRateCardCreatedEvent and V2BillingRateCardUpdatedEvent with related object v2.billing.RateCardV2BillingRateCardRateCreatedEvent with related object v2.billing.RateCardRateV2BillingRateCardSubscriptionActivatedEvent, V2BillingRateCardSubscriptionCanceledEvent, V2BillingRateCardSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingRateCardSubscriptionCollectionCurrentEvent, V2BillingRateCardSubscriptionCollectionPastDueEvent, V2BillingRateCardSubscriptionCollectionPausedEvent, V2BillingRateCardSubscriptionCollectionUnpaidEvent, V2BillingRateCardSubscriptionServicingActivatedEvent, V2BillingRateCardSubscriptionServicingCanceledEvent, and V2BillingRateCardSubscriptionServicingPausedEvent with related object v2.billing.RateCardSubscriptionV2BillingRateCardVersionCreatedEvent with related object v2.billing.RateCardVersionV2CoreHealthApiErrorFiringEvent, V2CoreHealthApiErrorResolvedEvent, V2CoreHealthApiLatencyFiringEvent, V2CoreHealthApiLatencyResolvedEvent, V2CoreHealthAuthorizationRateDropFiringEvent, V2CoreHealthAuthorizationRateDropResolvedEvent, V2CoreHealthEventGenerationFailureResolvedEvent, V2CoreHealthFraudRateIncreasedEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, V2CoreHealthPaymentMethodErrorFiringEvent, V2CoreHealthPaymentMethodErrorResolvedEvent, V2CoreHealthTrafficVolumeDropFiringEvent, V2CoreHealthTrafficVolumeDropResolvedEvent, V2CoreHealthWebhookLatencyFiringEvent, and V2CoreHealthWebhookLatencyResolvedEventV2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object v2.reporting.ReportRunRateLimitErrorReplace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
Addresses an issue where List iteration would be forwards when starting_after was set to None but backwards if it was not set at all. Now, it will pag
customers, products) are copied under the new V1 namespace. These top level non-namespaced services will be marked as deprecated in the next major rel…
2025-08-27.basil.
balance_report, payout_details, and payout_reconciliation_report on AccountSession.Component and AccountSession.CreateParamsComponentname on BillingPortal.Configuration, billing_portal.Configuration.CreateParams, and billing_portal.Configuration.ModifyParamsinstallments on Charge.PaymentMethodDetail.Almatransaction_id on Charge.PaymentMethodDetail.Alma, Charge.PaymentMethodDetail.AmazonPay, Charge.PaymentMethodDetail.Billie, Charge.PaymentMethodDetail.KakaoPay, Charge.PaymentMethodDetail.KrCard, Charge.PaymentMethodDetail.NaverPay, Charge.PaymentMethodDetail.Payco, Charge.PaymentMethodDetail.RevolutPay, Charge.PaymentMethodDetail.SamsungPay, and Charge.PaymentMethodDetail.Satispaylocation and reader on Charge.PaymentMethodDetail.Paynowamount_includes_iof on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.ConfirmParamsPaymentMethodOptionPix, PaymentIntent.CreateParamsPaymentMethodOptionPix, PaymentIntent.ModifyParamsPaymentMethodOptionPix, PaymentIntent.PaymentMethodOption.Pix, and checkout.Session.CreateParamsPaymentMethodOptionPixblock and resolution on enum Dispute.PaymentMethodDetail.Card.case_typeterminal_android_apk on enums File.ListParams.purpose and File.purposeterminal_android_apk on enum File.CreateParams.purposemetadata and period on Invoice.CreatePreviewParamsScheduleDetailPhaseAddInvoiceItem, Subscription.CreateParamsAddInvoiceItem, Subscription.ModifyParamsAddInvoiceItem, SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem, SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem, and SubscriptionSchedule.Phase.AddInvoiceItemexp_month and exp_year on issuing.Card.CreateParamsexcluded_payment_method_types on PaymentIntent.CreateParams and PaymentIntentpayout_method on Payout.CreateParams and Payoutmxn on Terminal.Configuration.Tipping, terminal.Configuration.CreateParamsTipping, and terminal.Configuration.ModifyParamsTippingcard on terminal.Reader.PresentPaymentMethodParamscard on enum terminal.Reader.PresentPaymentMethodParams.type2025-08-27.basil on enum WebhookEndpoint.CreateParams.api_versioncustomer_session_expired and india_recurring_payment_mandate_canceled on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorclient = StripeClient("sk_test...")
# Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
- client.customers.list()
+ client.v1.customers.list()
Refer to the migration guide for help upgrading.Add support for new resource InvoicePayment
InvoicePaymentlist and retrieve methods on resource InvoicePaymentThis release changes the pinned API version to 2025-07-30.preview.
This release changes the pinned API version to 2025-07-30.preview.
billing.MeterUsageRow, billing.MeterUsage, and terminal.OnboardingLinkretrieve method on resource billing.MeterUsagecreate method on resource terminal.OnboardingLinkmonthly_payout_days and weekly_payout_days on BalanceSettings.ModifyParamsPayoutSchedule and BalanceSettings.Payout.Schedulemonthly_anchor and weekly_anchor on BalanceSettings.ModifyParamsPayoutSchedule and BalanceSettings.Payout.Scheduledelay_days_override on BalanceSettings.ModifyParamsSettlementTimingdelay_days on BalanceSettings.ModifyParamsSettlementTimingupdate_discounts on checkout.Session.CreateParamsPermissiondiscounts and subscription_data on checkout.Session.ModifyParamssmart_disputes on Disputeupi on Invoice.CreateParamsPaymentSettingPaymentMethodOption, Invoice.ModifyParamsPaymentSettingPaymentMethodOption, Invoice.PaymentSetting.PaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.CreateParamsPaymentSettingPaymentMethodOption, Subscription.ModifyParamsPaymentSettingPaymentMethodOption, and Subscription.PaymentSetting.PaymentMethodOptionupi on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_typestransaction_id on PaymentAttemptRecord.PaymentMethodDetail.Cashapp and PaymentRecord.PaymentMethodDetail.Cashappamount_details on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.IncrementAuthorizationParams, and PaymentIntent.ModifyParamspayment_details on PaymentIntent.IncrementAuthorizationParamsstorer on V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.Account.CreateParamsIdentityAttestationTermsOfService, and v2.core.Account.ModifyParamsIdentityAttestationTermsOfServicecollection_options on V2.Core.AccountLink.UseCase.AccountOnboarding, V2.Core.AccountLink.UseCase.AccountUpdate, v2.core.AccountLink.CreateParamsUseCaseAccountOnboarding, and v2.core.AccountLink.CreateParamsUseCaseAccountUpdateV2.Core.AccountLink.UseCase.AccountOnboarding.configurations, V2.Core.AccountLink.UseCase.AccountUpdate.configurations, v2.core.AccountLink.CreateParamsUseCaseAccountOnboarding.configurations, and v2.core.AccountLink.CreateParamsUseCaseAccountUpdate.configurations from literal('recipient') to enum('customer'|'merchant'|'recipient'|'storer')bank_account_type on V2.MoneyManagement.PayoutMethod.BankAccountV2CoreAccountLinkReturnedEventV2MoneyManagementPayoutMethodUpdatedEvent with related object v2.money_management.PayoutMethodV2CoreAccountLinkCompletedEventV2OffSessionPaymentRequiresCaptureEvent with related object v2.payments.OffSessionPaymentThis release changes the pinned API version to 2025-07-30.basil.
This release changes the pinned API version to 2025-07-30.basil.
instant_payouts_promotion on AccountSession.Component and AccountSession.CreateParamsComponentadjustable_quantity on BillingPortal.Configuration.Feature.SubscriptionUpdate.Product, billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdateProduct, and billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdateProductdisabled from enum Capability.statustransaction_id on Charge.PaymentMethodDetail.Cashapporigin_context on Checkout.Session and checkout.Session.CreateParamstemplate on Checkout.Session.InvoiceCreation.InvoiceDatum.RenderingOption, PaymentLink.CreateParamsInvoiceCreationInvoiceDatumRenderingOption, PaymentLink.InvoiceCreation.InvoiceDatum.RenderingOption, PaymentLink.ModifyParamsInvoiceCreationInvoiceDatumRenderingOption, and checkout.Session.CreateParamsInvoiceCreationInvoiceDatumRenderingOptionsetup_future_usage on Checkout.Session.PaymentMethodOption.Pix and checkout.Session.CreateParamsPaymentMethodOptionPixnz_bank_account on enum checkout.Session.CreateParams.payment_method_typesIdentity.VerificationSession.RelatedPerson.account to be requiredIdentity.VerificationSession.RelatedPerson.person to be requiredduration on Invoice.CreatePreviewParamsScheduleDetailPhase, SubscriptionSchedule.CreateParamsPhase, and SubscriptionSchedule.ModifyParamsPhaseInvoice.CreatePreviewParamsSubscriptionDetail.cancel_at, Subscription.CreateParams.cancel_at, and Subscription.ModifyParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')price_data on PaymentLink.CreateParamsLineItemPaymentLink.CreateParamsLineItem.price to be optionalAmerica/Coyhaique on enum reporting.ReportRun.CreateParamsParameter.timezonestandard on Tax.Registration.CountryOption.Ae, Tax.Registration.CountryOption.Au, Tax.Registration.CountryOption.Ch, Tax.Registration.CountryOption.Gb, Tax.Registration.CountryOption.Jp, Tax.Registration.CountryOption.No, Tax.Registration.CountryOption.Nz, Tax.Registration.CountryOption.Sg, tax.Registration.CreateParamsCountryOptionAe, tax.Registration.CreateParamsCountryOptionAl, tax.Registration.CreateParamsCountryOptionAo, tax.Registration.CreateParamsCountryOptionAu, tax.Registration.CreateParamsCountryOptionAw, tax.Registration.CreateParamsCountryOptionB, tax.Registration.CreateParamsCountryOptionBa, tax.Registration.CreateParamsCountryOptionBb, tax.Registration.CreateParamsCountryOptionBd, tax.Registration.CreateParamsCountryOptionBf, tax.Registration.CreateParamsCountryOptionBh, tax.Registration.CreateParamsCountryOptionCd, tax.Registration.CreateParamsCountryOptionCh, tax.Registration.CreateParamsCountryOptionEt, tax.Registration.CreateParamsCountryOptionGb, tax.Registration.CreateParamsCountryOptionGn, tax.Registration.CreateParamsCountryOptionIs, tax.Registration.CreateParamsCountryOptionJp, tax.Registration.CreateParamsCountryOptionMe, tax.Registration.CreateParamsCountryOptionMk, tax.Registration.CreateParamsCountryOptionMr, tax.Registration.CreateParamsCountryOptionNo, tax.Registration.CreateParamsCountryOptionNz, tax.Registration.CreateParamsCountryOptionOm, tax.Registration.CreateParamsCountryOptionR, tax.Registration.CreateParamsCountryOptionSg, tax.Registration.CreateParamsCountryOptionSr, tax.Registration.CreateParamsCountryOptionUy, tax.Registration.CreateParamsCountryOptionZa, and tax.Registration.CreateParamsCountryOptionZwinbound_goods on enums Tax.Registration.CountryOption.At.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Be.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Bg.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Cy.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Cz.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.De.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Dk.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.E.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ee.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Fi.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Fr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Gr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Hr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Hu.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ie.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.It.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lu.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lv.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Mt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Nl.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Pl.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Pt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ro.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Se.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Si.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Sk.Standard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionAtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionBeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionBgStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionCyStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionCzStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionDeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionDkStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionEStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionEeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionFiStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionFrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionGrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionHrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionHuStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionIeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionItStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLuStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLvStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionMtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionNlStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionPlStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionPtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionRoStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionSeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionSiStandard.place_of_supply_scheme, and tax.Registration.CreateParamsCountryOptionSkStandard.place_of_supply_schemeaed, bgn, huf, and ron on Terminal.Configuration.Tipping, terminal.Configuration.CreateParamsTipping, and terminal.Configuration.ModifyParamsTipping2025-07-30.basil on enum WebhookEndpoint.CreateParams.api_versionAdd support for close and create methods on resource v2.money_management.FinancialAccount
close and create methods on resource v2.money_management.FinancialAccountstorer on enums V2.Core.Account.applied_configurations and v2.core.Account.CloseParams.applied_configurationsstorer on V2.Core.Account.Configuration, v2.core.Account.CreateParamsConfiguration, and v2.core.Account.ModifyParamsConfigurationfinancial_addresses.bank_accounts, holds_currencies.gbp, inbound_transfers.financial_accounts, outbound_payments.bank_accounts, outbound_payments.cards, outbound_payments.financial_accounts, outbound_transfers.bank_accounts, and outbound_transfers.financial_accounts on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitystorer on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.configurationstatus_details on V2.MoneyManagement.FinancialAccountstatus on v2.money_management.FinancialAccount.ListParamsconfiguration.storer on enums v2.core.Account.CreateParams.include, v2.core.Account.ModifyParams.include, and v2.core.Account.RetrieveParams.includeV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object v2.core.AccountAlreadyExistsError and NonZeroBalanceErrorChange type of Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsS
Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, Subscription.CreateParams.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode from enum('classic'|'flexible') to billing_modesubmission_method on Dispute.EvidenceDetailon_demand and subscriptions on Order.CreateParamsPaymentSettingPaymentMethodOptionKlarna and Order.ModifyParamsPaymentSettingPaymentMethodOptionKlarnaOrder.CreateParamsPaymentSettingPaymentMethodOptionKlarna.setup_future_usage, Order.ModifyParamsPaymentSettingPaymentMethodOptionKlarna.setup_future_usage, and Order.Payment.Setting.PaymentMethodOption.Klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')crypto on PaymentAttemptRecord.PaymentMethodDetail and PaymentRecord.PaymentMethodDetailbuut on enums PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank and PaymentRecord.PaymentMethodDetail.Ideal.bankBUUTNL2A on enums PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic and PaymentRecord.PaymentMethodDetail.Ideal.bicPaymentIntent.ConfirmParamsPaymentMethodOptionGopay.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionGopay.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionGopay.setup_future_usage, and PaymentIntent.PaymentMethodOption.Gopay.setup_future_usage from literal('none') to enum('none'|'off_session')Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode to be requiredcrypto on enum QuotePreviewInvoice.PaymentSetting.payment_method_typesQuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode from enum('classic'|'flexible') to SubscriptionsResourceBillingModeSubscription.MigrateParams.billing_mode from literal('flexible') to billing_mode_migratebilling_mode_details on Subscriptionxx on enums V2.Core.Account.Configuration.Customer.AutomaticIndirectTax.Location.country, V2.Core.Account.Configuration.Customer.Shipping.Address.country, V2.Core.Account.Configuration.Merchant.Support.Address.country, V2.Core.Account.Identity.BusinessDetail.Address.country, V2.Core.Account.Identity.BusinessDetail.ScriptAddress.Kana.country, V2.Core.Account.Identity.BusinessDetail.ScriptAddress.Kanji.country, V2.Core.Account.Identity.Individual.AdditionalAddress.country, V2.Core.Account.Identity.Individual.Address.country, V2.Core.Account.Identity.Individual.ScriptAddress.Kana.country, V2.Core.Account.Identity.Individual.ScriptAddress.Kanji.country, V2.Core.Account.Identity.country, V2.Core.Person.AdditionalAddress.country, V2.Core.Person.Address.country, V2.Core.Person.ScriptAddress.Kana.country, V2.Core.Person.ScriptAddress.Kanji.country, V2.MoneyManagement.FinancialAccount.country, v2.core.Account.CreateParamsConfigurationCustomerShippingAddress.country, v2.core.Account.CreateParamsConfigurationMerchantSupportAddress.country, v2.core.Account.CreateParamsIdentity.country, v2.core.Account.CreateParamsIdentityBusinessDetailAddress.country, v2.core.Account.CreateParamsIdentityBusinessDetailScriptAddressKana.country, v2.core.Account.CreateParamsIdentityBusinessDetailScriptAddressKanji.country, v2.core.Account.CreateParamsIdentityIndividualAdditionalAddress.country, v2.core.Account.CreateParamsIdentityIndividualAddress.country, v2.core.Account.CreateParamsIdentityIndividualScriptAddressKana.country, v2.core.Account.CreateParamsIdentityIndividualScriptAddressKanji.country, v2.core.Account.ModifyParamsConfigurationCustomerShippingAddress.country, v2.core.Account.ModifyParamsConfigurationMerchantSupportAddress.country, v2.core.Account.ModifyParamsIdentity.country, v2.core.Account.ModifyParamsIdentityBusinessDetailAddress.country, v2.core.Account.ModifyParamsIdentityBusinessDetailScriptAddressKana.country, v2.core.Account.ModifyParamsIdentityBusinessDetailScriptAddressKanji.country, v2.core.Account.ModifyParamsIdentityIndividualAdditionalAddress.country, v2.core.Account.ModifyParamsIdentityIndividualAddress.country, v2.core.Account.ModifyParamsIdentityIndividualScriptAddressKana.country, v2.core.Account.ModifyParamsIdentityIndividualScriptAddressKanji.country, v2.core.Person.CreateParamsAdditionalAddress.country, v2.core.Person.CreateParamsAddress.country, v2.core.Person.CreateParamsScriptAddressKana.country, v2.core.Person.CreateParamsScriptAddressKanji.country, v2.core.Person.ModifyParamsAdditionalAddress.country, v2.core.Person.ModifyParamsAddress.country, v2.core.Person.ModifyParamsScriptAddressKana.country, and v2.core.Person.ModifyParamsScriptAddressKanji.countryunsupported_entity_type on enums V2.Core.Account.Configuration.Customer.Capability.AutomaticIndirectTax.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AchDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AcssDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AffirmPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AfterpayClearpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AlmaPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AmazonPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AuBecsDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BacsDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BancontactPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BlikPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BoletoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CardPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CartesBancairesPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CashappPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.EpsPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.FpxPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.GbBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.GrabpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.IdealPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.JcbPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.JpBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KakaoPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KlarnaPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KonbiniPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KrCardPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.LinkPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MobilepayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MultibancoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MxBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.NaverPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.OxxoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.P24Payment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PayByBankPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PaycoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PaynowPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PromptpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.RevolutPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SamsungPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SepaBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SepaDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.StripeBalance.Payout.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SwishPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.TwintPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.UsBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.ZipPayment.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Local.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Wire.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.Card.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.Payout.StatusDetail.code, and V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.StripeTransfer.StatusDetail.codeproof_of_address on V2.Core.Account.Identity.BusinessDetail.Document, v2.core.Account.CreateParamsIdentityBusinessDetailDocument, and v2.core.Account.ModifyParamsIdentityBusinessDetailDocumentxx on enums V2.Core.Account.Identity.Individual.nationalities, V2.Core.Person.nationalities, v2.core.Account.CreateParamsIdentityIndividual.nationalities, v2.core.Account.ModifyParamsIdentityIndividual.nationalities, v2.core.Person.CreateParams.nationalities, and v2.core.Person.ModifyParams.nationalitiesmetadata on V2.MoneyManagement.FinancialAccountdescription on V2.MoneyManagement.FinancialAccountpending on enum V2.MoneyManagement.FinancialAccount.statusattempts on V2.Payments.OffSessionPaymentV2.Payments.OffSessionPayment.TransferDatum.amount from integer to nullable(integer)from_account, outbound_payment, and outbound_transfer on V2.MoneyManagement.ReceivedCredit.BalanceTransferV2.MoneyManagement.ReceivedCredit.BalanceTransfer.type from literal('payout_v1') to enum('outbound_payment'|'outbound_transfer'|'payout_v1')V2.MoneyManagement.ReceivedCredit.BalanceTransfer.payout_v1 from string to nullable(string)v2.payments.OffSessionPayment.CreateParamsTransferDatum.amount to be optionalrecipient_feature_not_active, storer_capability_missing, and storer_capability_not_active on FeatureNotEnabledErroroutbound_payment_recipient_feature_not_active on FeatureNotEnabledErrorinsufficient_funds on InsufficientFundsErroroutbound_payment_insufficient_funds and outbound_transfer_insufficient_funds on InsufficientFundsErrorrecipient_amount_limit_exceeded and recipient_count_limit_exceeded on QuotaExceededErroroutbound_payment_recipient_amount_limit_exceeded and outbound_payment_recipient_count_limit_exceeded on QuotaExceededErrorrecipient_email_does_not_exist on RecipientNotNotifiableErroroutbound_payment_recipient_email_does_not_exist on RecipientNotNotifiableErrorOne column per quarter.