update method on resource Entitlements.Featurerisk_controls on AccountCreateParams, AccountUpdateParams, and AccountDiscount.subscription_item, QuoteLine.actions[].add_discount, QuoteLine.actions[].add_item.discounts, QuoteLine.actions[].remove_discount, QuoteLine.actions[].set_discounts, QuoteLine.actions[].set_items[].discounts, Subscription.discounts, SubscriptionItem.discounts, SubscriptionSchedule.phases[].add_invoice_items[].discounts, SubscriptionSchedule.phases[].discounts, and SubscriptionSchedule.phases[].items[].discounts to be requiredpromotion_code on InvoiceAddLinesParams.lines[].discounts[], InvoiceUpdateLinesParams.lines[].discounts[], QuoteCreateParams.line_items[].discounts[], QuoteCreateParams.lines[].actions[].add_discount, QuoteCreateParams.phases[].line_items[].discounts[], QuoteUpdateParams.line_items[].discounts[], QuoteUpdateParams.lines[].actions[].add_discount, and QuoteUpdateParams.phases[].line_items[].discounts[]QuoteLine.actions[].add_item.discounts, QuoteLine.actions[].set_items[].discounts, SubscriptionSchedule.phases[].add_invoice_items[].discounts, SubscriptionSchedule.phases[].discounts, and SubscriptionSchedule.phases[].items[].discounts from array(DiscountsResourceStackableDiscount) | null to array(DiscountsResourceStackableDiscount)Subscription.discounts and SubscriptionItem.discounts from array(expandable(Discount)) | null to array(expandable(Discount))Charge.payment_method_details.us_bank_account.payment_reference, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.hosted_instructions_url, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.mobile_auth_url, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_code.data, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_code.image_url_png, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_code.image_url_svg, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_code, and PaymentIntent.payment_method_options.swish.reference to be requiredCheckout.SessionCreateParams.payment_method_options.swish.reference from emptyable(string) to stringsubscription_item on Discountemail and phone on Identity.VerificationReport, Identity.VerificationSession.options, Identity.VerificationSession.verified_outputs, Identity.VerificationSessionCreateParams.options, and Identity.VerificationSessionUpdateParams.optionsverification_flow on Identity.VerificationReport, Identity.VerificationSessionCreateParams, and Identity.VerificationSessionverification_flow on enums Identity.VerificationReport.type and Identity.VerificationSession.typeprovided_details on Identity.VerificationSessionCreateParams, Identity.VerificationSessionUpdateParams, and Identity.VerificationSessionIdentity.VerificationSessionCreateParams.type to be optionalemail_unverified_other, email_verification_declined, phone_unverified_other, and phone_verification_declined on enum Identity.VerificationSession.last_error.codepromotion_code on InvoiceCreateParams.discounts[], InvoiceItemCreateParams.discounts[], InvoiceItemUpdateParams.discounts[], InvoiceUpdateParams.discounts[], QuoteCreateParams.discounts[], and QuoteUpdateParams.discounts[]discounts on InvoiceUpcomingLinesParams.subscription_items[], InvoiceUpcomingParams.subscription_items[], QuoteCreateParams.line_items[], QuoteUpdateParams.line_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionCreateParams.items[], SubscriptionCreateParams, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionSchedule.phases[].items[], SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].items[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].items[], SubscriptionScheduleUpdateParams.phases[], SubscriptionUpdateParams.add_invoice_items[], SubscriptionUpdateParams.items[], SubscriptionUpdateParams, and SubscriptionInvoice.discounts from array(expandable(deletable($Discount))) | null to array(expandable(deletable($Discount)))allowed_merchant_countries and blocked_merchant_countries on Issuing.Card.spending_controls, Issuing.CardCreateParams.spending_controls, Issuing.CardUpdateParams.spending_controls, Issuing.Cardholder.spending_controls, Issuing.CardholderCreateParams.spending_controls, and Issuing.CardholderUpdateParams.spending_controlszip on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationoffline on SetupAttempt.payment_method_details.card_presentcard_present on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_optionsmobile_phone_reader on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_typefinancial_account_transactions, financial_account, issuing_card, and issuing_cards_list on AccountSessionCreateParams.componentssubscription_billing_cycle_anchor, subscription_cancel_at_period_end, subscription_cancel_at, subscription_cancel_now, subscription_default_tax_rates, subscription_items, subscription_prebilling, subscription_proration_behavior, subscription_proration_date, subscription_resume_at, subscription_start_date, and subscription_trial_end on InvoiceCreatePreviewParamsBilling.MeterEventAdjustment, Billing.MeterEvent, and Billing.Metercreate, deactivate, list, reactivate, retrieve, and update methods on resource Metercreate method on resources MeterEventAdjustment and MeterEventamazon_pay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesverification_failed_representative_authority on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codedestination_on_behalf_of_charge_management on AccountSession.components.payment_details.features, AccountSession.components.payments.features, AccountSessionCreateParams.components.payment_details.features, and AccountSessionCreateParams.components.payments.featuresmandate on Charge.payment_method_details.us_bank_account, Treasury.InboundTransfer.origin_payment_method_details.us_bank_account, Treasury.OutboundPayment.destination_payment_method_details.us_bank_account, and Treasury.OutboundTransfer.destination_payment_method_details.us_bank_accountsecond_line on Issuing.CardCreateParamsmeter on PlanCreateParams, Plan, Price.recurring, PriceCreateParams.recurring, and PriceListParams.recurringEntitlements.ActiveEntitlementSummary and Entitlements.ActiveEntitlementlist method on resource ActiveEntitlementmobilepay on ConfirmationToken.payment_method_preview and ConfirmationTokenCreateParams.testHelpers.payment_method_datamobilepay on enum ConfirmationTokenCreateParams.testHelpers.payment_method_data.typeuse_stripe_sdk on ConfirmationTokenpayment_method on ConfirmationTokenConfirmationToken.mandate_data from ConfirmationTokensResourceMandateData to ConfirmationTokensResourceMandateData | nullmobilepay on enum ConfirmationToken.payment_method_preview.typemetadata on Entitlements.FeatureCreateParams and Entitlements.Featureactive on Entitlements.Featureentitlements.active_entitlement_summary.updated on enum Event.typecustomer.entitlement_summary.updated from enum Event.typeentitlements.active_entitlement_summary.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]customer.entitlement_summary.updated from enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]ConfirmationToken and Forwarding.Requestretrieve method on resource ConfirmationTokencreate, list, and retrieve methods on resource Requestmobilepay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesforwarding_api_inactive, forwarding_api_invalid_parameter, forwarding_api_upstream_connection_error, and forwarding_api_upstream_connection_timeout on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codemobilepay on Charge.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datapayment_reference on Charge.payment_method_details.us_bank_accountmobilepay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeconfirmation_token on PaymentIntentConfirmParams, PaymentIntentCreateParams, SetupIntentConfirmParams, and SetupIntentCreateParamsmobilepay on enums PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typemobilepay on enum PaymentMethod.typename on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationpayout on Treasury.ReceivedDebit.linked_flowsBilling.MeterEventAdjustment, Billing.MeterEvent, and Billing.Metercreate, deactivate, list, reactivate, retrieve, and update methods on resource Metercreate method on resources MeterEventAdjustment and MeterEventcreate test helper method on resource ConfirmationTokenadd_lines, remove_lines, and update_lines methods on resource Invoicemultibanco payment method throughout the API.second_line on Issuing.PhysicalBundle.featuresmultibanco_display_details on PaymentIntent.next_actionmeter on PlanCreateParams, Plan, Price.recurring, PriceCreateParams.recurring, and PriceListParams.recurringIssuing.PersonalizationDesign and Issuing.PhysicalBundlecreate, list, retrieve, and update methods on resource PersonalizationDesignlist and retrieve methods on resource PhysicalBundlepersonalization_design on Issuing.CardCreateParams, Issuing.CardListParams, Issuing.CardUpdateParams, and Issuing.CardSubscriptionCreateParams.application_fee_percent and SubscriptionUpdateParams.application_fee_percent from number to emptyStringable(number)sepa_debit on Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsbilling_period_end on enums QuoteCreateParams.lines[].ends_at.type, QuoteLine.ends_at.type, and QuoteUpdateParams.lines[].ends_at.typedocuments on AccountSession.components and AccountSessionCreateParams.componentsrequest_three_d_secure on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardcreated on CreditNoteListParamssepa_debit on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, and InvoiceUpdateParams.payment_settings.payment_method_optionsEntitlements.EventConfirmationToken.mandate_data from ConfirmationTokensResourceMandateData | null to ConfirmationTokensResourceMandateDataConfirmationToken.mandate_data, ConfirmationToken.payment_method_options, and ConfirmationToken.payment_method to be optionalquantity and type on Entitlements.FeatureCreateParams and Entitlements.Featurelivemode on Issuing.PersonalizationDesignapplication_fee_amount, description, metadata, and transfer_data on PaymentIntentDecrementAuthorizationParamsenable_customer_cancellation on Terminal.Reader.action.collect_payment_method.collect_config and Terminal.ReaderCollectPaymentMethodParams.collect_configIdentity.VerificationReport.type, SubscriptionSchedule.default_settings.invoice_settings.account_tax_ids, SubscriptionSchedule.phases[].invoice_settings.account_tax_ids, and TaxId.owner to be requiredIdentity.VerificationSession.type from enum('document'|'id_number') | null to enum('document'|'id_number')number on InvoiceCreateParams and InvoiceUpdateParamsenable_customer_cancellation on Terminal.Reader.action.process_payment_intent.process_config, Terminal.Reader.action.process_setup_intent.process_config, Terminal.ReaderProcessPaymentIntentParams.process_config, and Terminal.ReaderProcessSetupIntentParams.process_configrefund_payment_config on Terminal.Reader.action.refund_payment and Terminal.ReaderRefundPaymentParamspayment_method on TokenCreateParams.bank_account#2022 Update generated code
client_reference_id on Identity.VerificationReportListParams, Identity.VerificationReport, Identity.VerificationSessionCreateParams, Identity.VerificationSessionListParams, and Identity.VerificationSessioninclude_and_require from enum InvoiceCreateParams.pending_invoice_items_behaviorservice_tax from enums TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typecreated on Treasury.OutboundPaymentListParams#2025 Standardize parameter interface names
CapabilityListParams renamed to AccountListCapabilitiesParamsCapabilityRetrieveParams renamed to AccountRetrieveCapabilityParamsCapabilityUpdateParams renamed to AccountUpdateCapabilityParamsCashBalanceRetrieveParams renamed to CustomerRetrieveCashBalanceParamsCashBalanceUpdateParams renamed to CustomerUpdateCashBalanceParamsCreditNoteLineItemListParams renamed to CreditNoteListLineItemsParamsCustomerBalanceTransactionCreateParams renamed to CustomerCreateBalanceTransactionParamsCustomerBalanceTransactionListParams renamed to CustomerListBalanceTransactionsParamsCustomerBalanceTransactionRetrieveParams renamed to CustomerRetrieveBalanceTransactionParamsCustomerBalanceTransactionUpdateParams renamed to CustomerUpdateBalanceTransactionParamsCustomerCashBalanceTransactionListParams renamed to CustomerListCashBalanceTransactionsParamsCustomerCashBalanceTransactionRetrieveParams renamed to CustomerRetrieveCashBalanceTransactionParamsCustomerSourceCreateParams renamed to CustomerCreateSourceParamsCustomerSourceDeleteParams renamed to CustomerDeleteSourceParamsCustomerSourceListParams renamed to CustomerListSourcesParamsCustomerSourceRetrieveParams renamed to CustomerRetrieveSourceParamsCustomerSourceUpdateParams renamed to CustomerUpdateSourceParamsCustomerSourceVerifyParams renamed to CustomerVerifySourceParamsExternalAccountCreateParams renamed to AccountCreateExternalAccountParamsExternalAccountDeleteParams renamed to AccountDeleteExternalAccountParamsExternalAccountListParams renamed to AccountListExternalAccountsParamsExternalAccountRetrieveParams renamed to AccountRetrieveExternalAccountParamsExternalAccountUpdateParams renamed to AccountUpdateExternalAccountParamsFeeRefundCreateParams renamed to ApplicationFeeCreateRefundParamsFeeRefundListParams renamed to ApplicationFeeListRefundsParamsFeeRefundRetrieveParams renamed to ApplicationFeeRetrieveRefundParamsFeeRefundUpdateParams renamed to ApplicationFeeUpdateRefundParamsInvoiceLineItemListParams renamed to InvoiceListLineItemsParamsInvoiceLineItemUpdateParams renamed to InvoiceUpdateLineItemParamsLoginLinkCreateParams renamed to AccountCreateLoginLinkParamsPersonCreateParams renamed to AccountCreatePersonParamsPersonDeleteParams renamed to AccountDeletePersonParamsPersonListParams renamed to AccountListPersonsParamsPersonRetrieveParams renamed to AccountRetrievePersonParamsPersonUpdateParams renamed to AccountUpdatePersonParamsTaxIdCreateParams renamed to CustomerCreateTaxIdParamsTaxIdDeleteParams renamed to CustomerDeleteTaxIdParamsTaxIdListParams renamed to CustomerListTaxIdsParamsTaxIdRetrieveParams renamed to CustomerRetrieveTaxIdParamsTransferReversalCreateParams renamed to TransferCreateReversalParamsTransferReversalListParams renamed to TransferListReversalsParamsTransferReversalRetrieveParams renamed to TransferRetrieveReversalParamsTransferReversalUpdateParams renamed to TransferUpdateReversalParamsUsageRecordCreateParams renamed to SubscriptionItemCreateUsageRecordParamsUsageRecordSummaryListParams renamed to SubscriptionItemListUsageRecordSummariesParamsOld names will still work but are deprecated and will be removed in future versions.
#2021 Add TaxIds API
create, del, list, and retrieve methods on resource TaxIdpayto and twint payment method throughout the APIdecrement_authorization method on resource PaymentIntentdecremental_authorization on Charge.payment_method_details.carddisplay_brand on ConfirmationToken.payment_method_preview.cardno_voec on enums InvoiceCreatePreviewParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, and OrderUpdateParams.tax_details.tax_ids[].typeno_voec on enum Order.tax_details.tax_ids[].typerequest_decremental_authorization on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, and PaymentIntentUpdateParams.payment_method_options.cardnetworks on Card, PaymentMethodCreateParams.card, PaymentMethodUpdateParams.card, and TokenCreateParams.cardno_voec on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typeno_voec on enums CustomerCreateParams.tax_id_data[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typefinancial_connections.account.refreshed_ownership on enum Event.typedisplay_brand on PaymentMethod.cardfinancial_connections.account.refreshed_ownership on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]payment_method_options on ConfirmationTokenvelobank on enum ConfirmationToken.payment_method_preview.p24.bankinvoices on Account.settings and AccountUpdateParams.settingsvelobank on enums Charge.payment_method_details.p24.bank, PaymentIntentConfirmParams.payment_method_data.p24.bank, PaymentIntentCreateParams.payment_method_data.p24.bank, PaymentIntentUpdateParams.payment_method_data.p24.bank, PaymentMethod.p24.bank, PaymentMethodCreateParams.p24.bank, SetupIntentConfirmParams.payment_method_data.p24.bank, SetupIntentCreateParams.payment_method_data.p24.bank, and SetupIntentUpdateParams.payment_method_data.p24.banksetup_future_usage on PaymentIntent.payment_method_options.blik, PaymentIntentConfirmParams.payment_method_options.blik, PaymentIntentCreateParams.payment_method_options.blik, and PaymentIntentUpdateParams.payment_method_options.blikrequire_cvc_recollection on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, and PaymentIntentUpdateParams.payment_method_options.cardaccount_tax_ids on SubscriptionCreateParams.invoice_settings, SubscriptionSchedule.default_settings.invoice_settings, SubscriptionSchedule.phases[].invoice_settings, SubscriptionScheduleCreateParams.default_settings.invoice_settings, SubscriptionScheduleCreateParams.phases[].invoice_settings, SubscriptionScheduleUpdateParams.default_settings.invoice_settings, SubscriptionScheduleUpdateParams.phases[].invoice_settings, and SubscriptionUpdateParams.invoice_settingsswish payment method throughout the APIrelationship on AccountCreateParams.individual, AccountUpdateParams.individual, and TokenCreateParams.account.individualjurisdiction_level on TaxRateTerminal.Reader.status from string to enum('offline'|'online')protocol: 'http' is set for requests to api.stripe.com.Entitlements.Event and Entitlements.Featurecreate method on resource Eventcreate and list methods on resource Featureswish on ConfirmationToken.payment_method_previewswish on enum ConfirmationToken.payment_method_preview.typecustomer.entitlement_summary.updated on enum Event.typeaccount_tax_ids on InvoiceCreatePreviewParams.schedule_details.phases[].invoice_settings, InvoiceUpcomingLinesParams.schedule_details.phases[].invoice_settings, and InvoiceUpcomingParams.schedule_details.phases[].invoice_settingsfeature on Product.features[], ProductCreateParams.features[], and ProductUpdateParams.features[]customer.entitlement_summary.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]