This release changes the pinned API version to 2025-05-28.basil.
attach_payment method on resource Invoicecollect_inputs method on resource Terminal.Readersucceed_input_collection and timeout_input_collection test helper methods on resource Terminal.Readerpix_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesdisputes_list and payment_disputes on AccountSession.components and AccountSessionCreateParams.componentsrefund_and_dispute_prefunding on Balancebalance_type on BalanceTransactionBilling.AlertCreateParams.usage_threshold.meter to be requiredlocation and reader on Charge.payment_method_details.affirm and Charge.payment_method_details.wechat_paypayment_method_remove on Checkout.SessionCreateParams.saved_payment_method_optionssetup_future_usage on Checkout.Session.payment_method_options.naver_payConfirmationToken.payment_method_preview.naver_pay.buyer_id and PaymentMethod.naver_pay.buyer_id to be requiredpost_payment_amount and pre_payment_amount on CreditNotemixed on enum CreditNote.typeinvoice_payment.paid on enum Event.typesex, unparsed_place_of_birth, and unparsed_sex on Identity.VerificationReport.document and Identity.VerificationSession.verified_outputsbilling_thresholds on InvoiceCreatePreviewParams.schedule_details.phases[].items[], InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionCreateParams, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, SubscriptionSchedule.default_settings, SubscriptionSchedule.phases[].items[], SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.default_settings, SubscriptionScheduleCreateParams.phases[].items[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.default_settings, SubscriptionScheduleUpdateParams.phases[].items[], SubscriptionScheduleUpdateParams.phases[], SubscriptionUpdateParams.items[], SubscriptionUpdateParams, and Subscriptionsatispay on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_optionscapture_method on PaymentIntent.payment_method_options.billiekakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationnetwork_decline_code on Refund.destination_details.paypalmetadata on Tax.CalculationCreateParams.line_items[] and Tax.CalculationLineItemsimulated_stripe_s700 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_typereturn_url on Terminal.Reader.action.process_payment_intent.process_config and Terminal.ReaderProcessPaymentIntentParams.process_configcollect_inputs on Terminal.Reader.actioncollect_inputs on enum Terminal.Reader.action.typeinvoice_payment.paid on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2025-05-28.basil on enum WebhookEndpointCreateParams.api_versionInvoicePaymentPaidEvent with resource InvoicePaymentforwarding_api_upstream_error on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorhost and streaming in request options.
const file = await stripe.rawRequest(
'GET',
'/v1/files/file_123/contents',
{},
{host: 'files.stripe.com', streaming: true}
);#2307 Update generated code for beta
This release changes the pinned API version to 2025-04-30.preview.
billing_mode on Checkout.SessionCreateParams.subscription_data, InvoiceCreatePreviewParams.schedule_details, InvoiceCreatePreviewParams.subscription_details, Quote.subscription_data, QuoteCreateParams.subscription_data, QuotePreviewSubscriptionSchedule, SubscriptionCreateParams, SubscriptionScheduleCreateParams, SubscriptionSchedule, and Subscriptionaw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].typeCheckout.Session.automatic_tax.provider, Invoice.automatic_tax.provider, Quote.automatic_tax.provider, and QuotePreviewInvoice.automatic_tax.provider to be requiredaccount_number on ConfirmationToken.payment_method_preview.acss_debit and PaymentMethod.acss_debitbalance_settings.updated on enum Event.typeaw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typebalance_settings.updated on enums WebhookEndpointUpdateParams.enabled_eventsThis release changes the pinned API version to 2025-04-30.basil.
minority_owned_business_designation on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profileregistration_date on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companyus_cfpb_data on AccountCreatePersonParams, AccountUpdatePersonParams, Person, and TokenCreateParams.personverification_legal_entity_structure_mismatch on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].codetax_id_prohibited on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codetax_id on Charge.billing_details, ConfirmationToken.payment_method_preview.billing_details, ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details, PaymentIntentConfirmParams.payment_method_data.billing_details, PaymentIntentCreateParams.payment_method_data.billing_details, PaymentIntentUpdateParams.payment_method_data.billing_details, PaymentMethod.billing_details, PaymentMethodCreateParams.billing_details, PaymentMethodUpdateParams.billing_details, SetupIntentConfirmParams.payment_method_data.billing_details, SetupIntentCreateParams.payment_method_data.billing_details, and SetupIntentUpdateParams.payment_method_data.billing_detailswallet_options on Checkout.SessionCreateParams and Checkout.Sessionprovider on Checkout.Session.automatic_tax, Invoice.automatic_tax, and Quote.automatic_taxaw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin 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.typepayment_method_options on ConfirmationTokenCreateParams.testHelpersinstallments on ConfirmationToken.payment_method_options.cardaw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typecontext on Eventaffirm on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesInvoiceLineItem.parent.subscription_item_details.subscription from string to string | nullbillie on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_optionspix on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationklarna on PaymentMethodDomainpending_reason on RefundTax.CalculationLineItem.reference from string | null to stringaw, az, bd, bf, bj, cm, cv, et, in, kg, la, and ph on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options2025-04-30.basil on enum WebhookEndpointCreateParams.api_versionFxQuote and PaymentIntentAmountDetailsLineItemcreate, list, and retrieve methods on resource FxQuoteattach_payment_intent method on resource Invoiceregistration_date on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companycustomer_reference and order_reference on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_detailstax_id on Charge.billing_details, ConfirmationToken.payment_method_preview.billing_details, ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details, PaymentIntentConfirmParams.payment_method_data.billing_details, PaymentIntentCreateParams.payment_method_data.billing_details, PaymentIntentUpdateParams.payment_method_data.billing_details, PaymentMethod.billing_details, PaymentMethodCreateParams.billing_details, PaymentMethodUpdateParams.billing_details, SetupIntentConfirmParams.payment_method_data.billing_details, SetupIntentCreateParams.payment_method_data.billing_details, SetupIntentUpdateParams.payment_method_data.billing_details, and Treasury.OutboundPaymentCreateParams.destination_payment_method_data.billing_detailsprice_data on Checkout.SessionUpdateParams.line_items[]Checkout.SessionUpdateParams.line_items[].quantity from longInteger to emptyable(longInteger)script on CouponCreateParams and Coupontype on Couponfx_quote.expired on enum Event.typeaffirm on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesfx_quote on PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentUpdateParams, PaymentIntent, TransferCreateParams, and Transferdiscount_amount, line_items, shipping, and tax on PaymentIntent.amount_detailspix on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationus_cfpb_data on Person and TokenCreateParams.personpending_reason on Refundaw, az, bd, bj, et, kg, la, and ph on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionsfx_quote.expired on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_eventsFxQuoteExpiredEvent with resource FxQuote#2298 Update generated code for beta
V2.MoneyManagement.ReceivedDebit.status_transitions from an object to an object | nullbank_accounts.local_uk, bank_accounts.wire_uk, cards_uk, and crypto_wallets_v2 from enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityPrivacy.RedactionJobRootObjects, Privacy.RedactionJobValidationError, and Privacy.RedactionJobcancel, create, list, retrieve, run, update, and validate methods on resource RedactionJoblist and retrieve methods on resource RedactionJobValidationErrorminority_owned_business_designation on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profileverification_legal_entity_structure_mismatch on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, AccountCapability.future_requirements.errors[].code, AccountCapability.requirements.errors[].code, AccountPerson.future_requirements.errors[].code, AccountPerson.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeexport_tax_transactions and payment_disputes on AccountSessionCreateParams.componentstax_id_prohibited on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, QuotePreviewInvoice.last_finalization_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codefixed_term_loan on enum Capital.FinancingOffer.typewallet_options on Checkout.SessionCreateParams and Checkout.Sessionprivacy.redaction_job.canceled, privacy.redaction_job.created, privacy.redaction_job.ready, privacy.redaction_job.succeeded, and privacy.redaction_job.validation_error on enum Event.typeklarna on PaymentMethodDomainTax.CalculationLineItem.reference from string | null to stringin on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionsprivacy.redaction_job.canceled, privacy.redaction_job.created, privacy.redaction_job.ready, privacy.redaction_job.succeeded, and privacy.redaction_job.validation_error on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events#2300 Handle external_resource field
external_account field in ExternalAccountsCreateParams from a string to a union type.#2288 Update generated code for beta
This release changes the pinned API version to 2025-03-31.preview
amount_overpaid on InvoicePaymentout_of_band_payment and payment_record from enum InvoicePayment.payment.typeinterchange_fees, net_total, network_fees, and transaction_volume on Issuing.Settlementbilling_thresholds on QuotePreviewSubscriptionSchedule.default_settings, QuotePreviewSubscriptionSchedule.phases[].items[], and QuotePreviewSubscriptionSchedule.phases[]coupon on QuotePreviewSubscriptionSchedule.phases[]value on Terminal.Reader.action.collect_inputs.inputs[].selection.choices[], Terminal.Reader.action.collect_inputs.inputs[].selection, and Terminal.ReaderCollectInputsParams.inputs[].selection.choices[]Checkout.Session.permissions.update to be optionalInvoicePayment.is_default from boolean | null to booleanInvoice.amount_overpaid and QuotePreviewInvoice.amount_overpaid to be requiredPaymentAttemptRecord.payment_method_details.type and PaymentRecord.payment_method_details.type from literal('custom') to stringPaymentAttemptRecord.payment_record from string to string | nullPaymentAttemptRecord.payment_method_details.custom and PaymentRecord.payment_method_details.custom to be optionalPaymentRecordReportPaymentParams.payment_reference to be optionalPaymentRecord.latest_payment_attempt_record from string to string | nullBalanceSettingsretrieve and update methods on resource BalanceSettingscreate, del, list, retrieve, and update methods on a new ExternalAccountService class to access cards and bank accounts made available in the new path v1/external_accounts. Access this via StripeClient.externalAccountsstripe_balance_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiescustomer_account on Billing.CreditBalanceSummaryRetrieveParams, Billing.CreditBalanceSummary, Billing.CreditBalanceTransactionListParams, Billing.CreditGrantCreateParams, Billing.CreditGrantListParams, Billing.CreditGrant, BillingPortal.SessionCreateParams, BillingPortal.Session, Checkout.SessionCreateParams, Checkout.SessionListParams, Checkout.Session, ConfirmationToken.payment_method_preview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerCashBalance, CustomerPaymentMethod, CustomerSessionCreateParams, CustomerSession, CustomerTaxId.owner, CustomerTaxId, Customer, Discount, FinancialConnections.Account.account_holder, FinancialConnections.AccountListParams.account_holder, FinancialConnections.Session.account_holder, FinancialConnections.SessionCreateParams.account_holder, InvoiceCreateParams, InvoiceCreatePreviewParams, InvoiceItemCreateParams, InvoiceItemListParams, InvoiceItem, InvoiceListParams, Invoice, PaymentIntentCreateParams, PaymentIntentListParams, PaymentIntentUpdateParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethod, PromotionCodeCreateParams, PromotionCodeListParams, PromotionCode, QuoteCreateParams, QuoteListParams, QuotePreviewInvoice, QuotePreviewSubscriptionSchedule, QuoteUpdateParams, Quote, SetupAttempt, SetupIntentCreateParams, SetupIntentListParams, SetupIntentUpdateParams, SetupIntent, SubscriptionCreateParams, SubscriptionListParams, SubscriptionScheduleCreateParams, SubscriptionScheduleListParams, SubscriptionSchedule, Subscription, TaxId.owner, TaxIdCreateParams.owner, TaxIdListParams.owner, and TaxIdstripe_balance on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataupdate_line_items and update_shipping_details on Checkout.Session.permissions and Checkout.SessionCreateParams.permissionsprovider on Checkout.Session.automatic_tax, Invoice.automatic_tax, Quote.automatic_tax, and QuotePreviewInvoice.automatic_taxtax_calculation_reference on CreditNoteLineItem, CreditNotePreviewLines, InvoiceLineItem, LineItem, PaymentLinkLineItem, QuoteComputedUpfrontLineItems, QuoteLineItem, and SessionLineItempayment_method_options on ConfirmationTokenCreateParams.testHelpersinstallments on ConfirmationToken.payment_method_options.cardcontext on Eventrelated_customer_account on Identity.VerificationSession, identity.VerificationSessionCreateParams, and identity.VerificationSessionListParamsnetwork_data on Issuing.DisputeSettlementDetailinterchange_fees_amount, net_total_amount, network_fees_amount, other_fees_amount, other_fees_count, and transaction_amount on Issuing.Settlementreported_by on PaymentAttemptRecordach_credit_transfer, ach_debit, acss_debit, affirm, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, blik, boleto, card_present, card, cashapp, customer_balance, eps, fpx, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, klarna, konbini, kr_card, link, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, sepa_credit_transfer, sepa_debit, shopeepay, sofort, stripe_account, swish, twint, us_bank_account, wechat_pay, wechat, and zip on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_detailspayout_method on PayoutCreateParams and Payoutconfirmation_secret, parent, and total_taxes on QuotePreviewInvoiceforwarding_api_retryable_upstream_error, setup_intent_mobile_wallet_unsupported, v2_account_disconnection_unsupported, and v2_account_missing_configuration on enum QuotePreviewInvoice.last_finalization_error.codeklarna, nz_bank_account, and stripe_balance on enum QuotePreviewInvoice.payment_settings.payment_method_typesid and text on Terminal.Reader.action.collect_inputs.inputs[].selection.choices[], Terminal.Reader.action.collect_inputs.inputs[].selection, and Terminal.ReaderCollectInputsParams.inputs[].selection.choices[]V2.FinancialAddressCreditSimulation, V2.FinancialAddressGeneratedMicrodeposits, V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.FinancialAddress, V2.MoneyManagement.InboundTransfer, V2.MoneyManagement.OutboundPaymentQuote, V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundSetupIntent, V2.MoneyManagement.OutboundTransfer, V2.MoneyManagement.PayoutMethod, V2.MoneyManagement.PayoutMethodsBankAccountSpec, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.ReceivedDebit, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transactioncreate method on resource V2.MoneyManagement.OutboundPaymentQuotelist and retrieve methods on resources V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.ReceivedDebit, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transactioncreate, list, and retrieve methods on resources V2.MoneyManagement.FinancialAddress and V2.MoneyManagement.InboundTransfercancel, create, list, and retrieve methods on resources V2.MoneyManagement.OutboundPayment and V2.MoneyManagement.OutboundTransferarchive, list, retrieve, and unarchive methods on resource V2.MoneyManagement.PayoutMethodcancel, create, list, retrieve, and update methods on resource V2.MoneyManagement.OutboundSetupIntentretrieve method on resource V2.MoneyManagement.PayoutMethodsBankAccountSpecaccount_number, fedwire_routing_number, and routing_number on enum invalid_payment_method.invalid_paramV2MoneyManagementFinancialAccountCreatedEvent with related object V2.MoneyManagement.FinancialAccountV2MoneyManagementFinancialAddressActivatedEvent and V2MoneyManagementFinancialAddressFailedEvent with related object V2.MoneyManagement.FinancialAddressV2MoneyManagementInboundTransferAvailableEvent, V2MoneyManagementInboundTransferBankDebitFailedEvent, V2MoneyManagementInboundTransferBankDebitProcessingEvent, V2MoneyManagementInboundTransferBankDebitQueuedEvent, V2MoneyManagementInboundTransferBankDebitReturnedEvent, and V2MoneyManagementInboundTransferBankDebitSucceededEvent with related object V2.MoneyManagement.InboundTransferV2MoneyManagementOutboundPaymentCanceledEvent, V2MoneyManagementOutboundPaymentCreatedEvent, V2MoneyManagementOutboundPaymentFailedEvent, V2MoneyManagementOutboundPaymentPostedEvent, and V2MoneyManagementOutboundPaymentReturnedEvent with related object V2.MoneyManagement.OutboundPaymentV2MoneyManagementOutboundTransferCanceledEvent, V2MoneyManagementOutboundTransferCreatedEvent, V2MoneyManagementOutboundTransferFailedEvent, V2MoneyManagementOutboundTransferPostedEvent, and V2MoneyManagementOutboundTransferReturnedEvent with related object V2.MoneyManagement.OutboundTransferV2MoneyManagementReceivedCreditAvailableEvent, V2MoneyManagementReceivedCreditFailedEvent, V2MoneyManagementReceivedCreditReturnedEvent, and V2MoneyManagementReceivedCreditSucceededEvent with related object V2.MoneyManagement.ReceivedCreditV2MoneyManagementReceivedDebitCanceledEvent, V2MoneyManagementReceivedDebitFailedEvent, V2MoneyManagementReceivedDebitPendingEvent, V2MoneyManagementReceivedDebitSucceededEvent, and V2MoneyManagementReceivedDebitUpdatedEvent with related object V2.MoneyManagement.ReceivedDebitAlreadyCanceledError, BlockedByStripeError, ControlledByDashboardError, FeatureNotEnabledError, FinancialAccountNotOpenError, InsufficientFundsError, InvalidPayoutMethodError, NotCancelableError, and RecipientNotNotifiableErrorSee SaaS platform payments with subscription billing using Accounts v2
V2.Core.AccountLink, V2.Core.Account, V2.Core.Person, V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccountclose, create, list, retrieve, and update methods on resource V2.Core.Accountcreate method on resource V2.Core.AccountLinkacknowledge_confirmation_of_payee, archive, create, initiate_confirmation_of_payee, and retrieve methods on resource V2.Core.Vault.GbBankAccountarchive, create, retrieve, and update methods on resource V2.Core.Vault.UsBankAccountV2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, and V2CoreAccountIncludingRequirementsUpdatedEventV2CoreAccountLinkCompletedEvent with related object V2.Core.AccountLinkV2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object V2.Core.PersonBilling.CreditBalanceSummaryRetrieveParams.customer, Billing.CreditBalanceTransactionListParams.customer, Billing.CreditGrantCreateParams.customer, BillingPortal.SessionCreateParams.customer, CustomerSessionCreateParams.customer, InvoiceItemCreateParams.customer, PaymentMethodAttachParams.customer, and SubscriptionCreateParams.customer to be optionalCreditNote.refunds to be requiredPaymentAttemptRecord.payment_method_details.custom and PaymentRecord.payment_method_details.custom from PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails | null to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetailsOrderCreateParams.payment.settings.payment_method_options.wechat_pay.client and OrderUpdateParams.payment.settings.payment_method_options.wechat_pay.client to be optional#2279 Support for APIs in the new API version 2025-03-31.basil
This release changes the pinned API version to 2025-03-31.basil.
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
SubscriptionItemUsageRecordSummary and SubscriptionItemUsageRecordlistUpcomingLines and retrieveUpcoming methods on resource InvoicecreateUsageRecord and listUsageRecordSummaries methods on resource SubscriptionItemsinvoice on Charge and PaymentIntentshipping_details on Checkout.Sessioncarrier, phone, and tracking_number on Checkout.Session.collected_information.shipping_details. Make name and address required instead of optional.refund on CreditNoteCreateParams, CreditNoteListPreviewLineItemsParams, CreditNotePreviewParams, and CreditNotetax_amounts on CreditNoteLineItem, CreditNote, and InvoiceLineItemamount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItemcoupon on CustomerCreateParams, CustomerUpdateParams, InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.phases[], and SubscriptionUpdateParamspromotion_code on CustomerCreateParams, CustomerUpdateParams, SubscriptionCreateParams, and SubscriptionUpdateParamsprice on InvoiceAddLinesParams.lines[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]. Use pricing` instead.billing_thresholds on InvoiceCreatePreviewParams.schedule_details.phases[].items[], InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionCreateParams, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, SubscriptionSchedule.default_settings, SubscriptionSchedule.phases[].items[], SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.default_settings, SubscriptionScheduleCreateParams.phases[].items[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.default_settings, SubscriptionScheduleUpdateParams.phases[].items[], SubscriptionScheduleUpdateParams.phases[], SubscriptionUpdateParams.items[], SubscriptionUpdateParams, and Subscriptionapplication_fee_amount, charge, paid_out_of_band, paid, payment_intent, quote, subscription, subscription_details, subscription_proration_date, tax, total_tax_amounts, and transfer_data on Invoicediscount on Invoice and Subscriptioninvoice_item, proration_details, proration, tax_rates, and type on InvoiceLineItemplan and subscription_item on InvoiceItem and InvoiceLineItemunit_amount on InvoiceItemCreateParams, InvoiceItemUpdateParams, and InvoiceItemsubscription and unit_amount_decimal on InvoiceItemnaver_pay on PaymentMethodUpdateParamsaggregate_usage on PlanCreateParams, Plan, Price.recurring, and PriceCreateParams.recurringcurrent_period_end and current_period_start on Subscriptionpage has been removed from all V2 list method params (e.g. EventService.list()); use the auto paginator or the next_page_url and previous_page_url fields instead (more info)Checkout.Session.collected_information to be requiredCheckout.Session.collected_information.shipping_details to be requiredCheckout.Session.collected_information.shipping_details.address to be requiredCheckout.Session.collected_information.shipping_details.name to be requiredPaymentIntentConfirmParams.payment_method_options.wechat_pay.client, PaymentIntentCreateParams.payment_method_options.wechat_pay.client, and PaymentIntentUpdateParams.payment_method_options.wechat_pay.client to be optionalpolitical_exposure on resources Person and Token and params Token.CreateParams from string to enum("existing" | "none")InvoicePaymentlist and retrieve methods on resource InvoicePaymentbillie_payments, nz_bank_account_becs_debit_payments, and satispay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitieshosted_payment_method_save on Account.settings.invoices and AccountUpdateParams.settings.invoicesinvoices on AccountCreateParams.settingsinformation_missing, invalid_signator, verification_failed_authorizer_authority, and verification_rejected_ownership_exemption_reason on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, AccountCapability.future_requirements.errors[].code, AccountCapability.requirements.errors[].code, AccountPerson.future_requirements.errors[].code, AccountPerson.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeforwarding_api_retryable_upstream_error and setup_intent_mobile_wallet_unsupported on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codestripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.typelast on enums Billing.Meter.default_aggregation.formula and Billing.MeterCreateParams.default_aggregation.formulapresentment_details on Charge, Checkout.Session, PaymentIntent, and Refundbillie and satispay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datanz_bank_account on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, Mandate.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataoptional_items on Checkout.SessionCreateParams, Checkout.Session, PaymentLinkCreateParams, and PaymentLinkpermissions on Checkout.SessionCreateParams and Checkout.Sessionbillie and satispay on enum Checkout.SessionCreateParams.payment_method_typescustom on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_modeshipping_options on Checkout.SessionUpdateParamsbillie, nz_bank_account, and satispay on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typebuyer_id on ConfirmationToken.payment_method_preview.naver_pay, CustomerPaymentMethod.naver_pay, and PaymentMethod.naver_paybillie, nz_bank_account, and satispay on enums ConfirmationToken.payment_method_preview.type, CustomerPaymentMethod.type, and PaymentMethod.typerefunds on CreditNoteCreateParams, CreditNoteListPreviewLineItemsParams, CreditNotePreviewParams, and CreditNotetotal_taxes on CreditNote and Invoicetaxes on CreditNoteLineItem and InvoiceLineItemcheckout_session on CustomerBalanceTransactioncheckout_session_subscription_payment_canceled and checkout_session_subscription_payment on enum CustomerBalanceTransaction.typebillie, nz_bank_account, and satispay on enums CustomerPaymentMethodListParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeinvoice.overpaid on enum Event.typeklarna and nz_bank_account on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typespricing on InvoiceAddLinesParams.lines[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]taxability_reason on InvoiceAddLinesParams.lines[].tax_amounts[], InvoiceLineItemUpdateParams.tax_amounts[], and InvoiceUpdateLinesParams.lines[].tax_amounts[]jurisdiction_level on InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data, InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data, and InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_dataamount_overpaid, confirmation_secret, and payments on Invoiceparent on InvoiceItem, InvoiceLineItem, and Invoiceexpired on enums Issuing.Authorization.status and Issuing.AuthorizationListParams.statusnetwork_fallback on enum Issuing.Authorization.request_history[].reasonnaver_pay on Mandate.payment_method_details and SetupAttempt.payment_method_detailssetup_future_usage on PaymentIntent.payment_method_options.naver_pay, PaymentIntentConfirmParams.payment_method_options.naver_pay, PaymentIntentCreateParams.payment_method_options.naver_pay, and PaymentIntentUpdateParams.payment_method_options.naver_payexpired on enum PaymentIntent.cancellation_reasondefault_value on PaymentLink.custom_fields[].dropdown, PaymentLink.custom_fields[].numeric, PaymentLink.custom_fields[].text, PaymentLinkCreateParams.custom_fields[].dropdown, PaymentLinkCreateParams.custom_fields[].numeric, PaymentLinkCreateParams.custom_fields[].text, PaymentLinkUpdateParams.custom_fields[].dropdown, PaymentLinkUpdateParams.custom_fields[].numeric, and PaymentLinkUpdateParams.custom_fields[].textbillie and satispay on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_typesnz_bank_transfer on Refund.destination_detailscanceled on enum Review.closed_reasoncurrent_period_end and current_period_start on SubscriptionItemwifi on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationinvoice.overpaid on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2025-03-01.dashboard and 2025-03-31.basil on enum WebhookEndpointCreateParams.api_version#2271 Beta SDK updates between Open API versions 1473 and 1505
succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.ReaderAccount.risk_controls.rejected_reason from enum to enum | nullCheckout.Session.collected_information.shipping_details and Checkout.Session.collected_information to be requiredtarget_date on Order.payment.settings.payment_method_options.acss_debit, Order.payment.settings.payment_method_options.sepa_debit, OrderCreateParams.payment.settings.payment_method_options.acss_debit, OrderCreateParams.payment.settings.payment_method_options.sepa_debit, OrderUpdateParams.payment.settings.payment_method_options.acss_debit, and OrderUpdateParams.payment.settings.payment_method_options.sepa_debit#2272 Merge master
prices on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and Billing.CreditGrantCreateParams.applicability_config.scopeBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type, Billing.CreditGrant.applicability_config.scope.price_type, and Billing.CreditGrantCreateParams.applicability_config.scope.price_type to be optionalpriority on Billing.CreditGrantCreateParams and Billing.CreditGranttarget_date on Checkout.Session.payment_method_options.acss_debit, Checkout.Session.payment_method_options.au_becs_debit, Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, Checkout.Session.payment_method_options.us_bank_account, Checkout.SessionCreateParams.payment_method_options.acss_debit, Checkout.SessionCreateParams.payment_method_options.au_becs_debit, Checkout.SessionCreateParams.payment_method_options.bacs_debit, Checkout.SessionCreateParams.payment_method_options.sepa_debit, Checkout.SessionCreateParams.payment_method_options.us_bank_account, PaymentIntent.payment_method_options.acss_debit, PaymentIntent.payment_method_options.au_becs_debit, PaymentIntent.payment_method_options.bacs_debit, PaymentIntent.payment_method_options.sepa_debit, PaymentIntent.payment_method_options.us_bank_account, PaymentIntentConfirmParams.payment_method_options.acss_debit, PaymentIntentConfirmParams.payment_method_options.au_becs_debit, PaymentIntentConfirmParams.payment_method_options.bacs_debit, PaymentIntentConfirmParams.payment_method_options.sepa_debit, PaymentIntentConfirmParams.payment_method_options.us_bank_account, PaymentIntentCreateParams.payment_method_options.acss_debit, PaymentIntentCreateParams.payment_method_options.au_becs_debit, PaymentIntentCreateParams.payment_method_options.bacs_debit, PaymentIntentCreateParams.payment_method_options.sepa_debit, PaymentIntentCreateParams.payment_method_options.us_bank_account, PaymentIntentUpdateParams.payment_method_options.acss_debit, PaymentIntentUpdateParams.payment_method_options.au_becs_debit, PaymentIntentUpdateParams.payment_method_options.bacs_debit, PaymentIntentUpdateParams.payment_method_options.sepa_debit, and PaymentIntentUpdateParams.payment_method_options.us_bank_accountrestrictions on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardcollected_information on Checkout.SessionUpdateParams and Checkout.SessionCheckout.Session.discounts, Refund.destination_details.blik.network_decline_code, and Refund.destination_details.swish.network_decline_code to be requiredmetadata on ProductCreateParams.default_price_dataTokenCreateParams.person.political_exposure from string to enum('existing'|'none')2025-02-24.acacia on enum WebhookEndpointCreateParams.api_versionOPENAPI_VERSION into npm bundlerejected_reason on Account.risk_controlsproduct_tax_code_selector on AccountSessionCreateParams.componentsprices on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and Billing.CreditGrantCreateParams.applicability_config.scopeBilling.CreditGrant.applicability_config.scope.price_type, Checkout.Session.collected_information.business_name, Checkout.Session.collected_information.email, Checkout.Session.collected_information.phone, Checkout.Session.collected_information.shipping_details, and Checkout.Session.collected_information.tax_ids to be optionalbrand_product on Charge.payment_method_details.amazon_pay.funding.card and Charge.payment_method_details.revolut_pay.funding.cardrestrictions on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardCheckout.Session.discounts to be requiredTokenCreateParams.person.political_exposure from string to enum('existing'|'none')close method on resource Treasury.FinancialAccountpay_by_bank_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesdirectorship_declaration and ownership_exemption_reason on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companyproof_of_ultimate_beneficial_ownership on AccountCreateParams.documents and AccountUpdateParams.documentsfinancial_account on AccountSession.components, AccountSessionCreateParams.components, and Treasury.OutboundTransfer.destination_payment_method_detailsfinancial_account_transactions, issuing_card, and issuing_cards_list on AccountSession.components and AccountSessionCreateParams.componentsadvice_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorBilling.CreditBalanceTransaction.credit.credits_application_invoice_voided, Card.regulated_status, Charge.payment_method_details.card.network_transaction_id, Charge.payment_method_details.card.regulated_status, ConfirmationToken.payment_method_preview.card.regulated_status, CreditNote.pretax_credit_amounts, Invoice.total_pretax_credit_amounts, Issuing.Authorization.merchant_data.tax_id, Issuing.Transaction.merchant_data.tax_id, and PaymentMethod.card.regulated_status to be requiredpay_by_bank on Charge.payment_method_details, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datacountry on Charge.payment_method_details.paypal, ConfirmationToken.payment_method_preview.paypal, and PaymentMethod.paypalpay_by_bank on enums Checkout.SessionCreateParams.payment_method_types[], CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeSD on enums Checkout.Session.shipping_address_collection.allowed_countries[], Checkout.SessionCreateParams.shipping_address_collection.allowed_countries[], PaymentLink.shipping_address_collection.allowed_countries[], PaymentLinkCreateParams.shipping_address_collection.allowed_countries[], and PaymentLinkUpdateParams.shipping_address_collection.allowed_countries[]discounts on Checkout.Sessionpay_by_bank on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typepay_by_bank on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typepay_by_bank on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]phone_number_collection on PaymentLinkUpdateParamsjpy on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tippingnickname on Treasury.FinancialAccountCreateParams, Treasury.FinancialAccountUpdateParams, and Treasury.FinancialAccountforwarding_settings on Treasury.FinancialAccountUpdateParamsis_default on Treasury.FinancialAccountdestination_payment_method_data on Treasury.OutboundTransferCreateParamsTreasury.OutboundTransfer.destination_payment_method_details.type from literal('us_bank_account') to enum('financial_account'|'us_bank_account')outbound_transfer on enums Treasury.ReceivedCredit.linked_flows.source_flow_details.type and Treasury.ReceivedCreditListParams.linked_flows.source_flow_typeoutbound_transfer on Treasury.ReceivedCredit.linked_flows.source_flow_details2025-01-27.acacia on enum WebhookEndpointCreateParams.api_versionRefund.destination_details.blik.network_decline_code and Refund.destination_details.swish.network_decline_code to be requiredstripe_account on Terminal.Reader.action.collect_payment_method, Terminal.Reader.action.confirm_payment_intent, Terminal.Reader.action.process_payment_intent, and Terminal.Reader.action.refund_paymentpay_by_bank_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesdirectorship_declaration on AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companyproof_of_ultimate_beneficial_ownership on AccountCreateParams.documents and AccountUpdateParams.documentstax_threshold_monitoring on AccountSessionCreateParams.componentsfinancial_account_transactions, financial_account, issuing_card, and issuing_cards_list on AccountSession.componentsBilling.CreditBalanceTransaction.credit.credits_application_invoice_voided to be requiredalways_invoice on enums BillingPortal.Configuration.features.subscription_cancel.proration_behavior, BillingPortal.ConfigurationCreateParams.features.subscription_cancel.proration_behavior, and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.proration_behaviorpay_by_bank on Charge.payment_method_details, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datapay_by_bank on enum Checkout.SessionCreateParams.payment_method_types[]SD on enums Checkout.Session.shipping_address_collection.allowed_countries[], Checkout.SessionCreateParams.shipping_address_collection.allowed_countries[], PaymentLink.shipping_address_collection.allowed_countries[], PaymentLinkCreateParams.shipping_address_collection.allowed_countries[], and PaymentLinkUpdateParams.shipping_address_collection.allowed_countries[]discounts on Checkout.Sessionpay_by_bank on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typepay_by_bank on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typepay_by_bank on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typepay_by_bank on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]jpy on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping2025-01-27.acacia on enum WebhookEndpointCreateParams.api_versionclose method on resource Treasury.FinancialAccountownership_exemption_reason on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companydirectorship_declaration on Account.companyadvice_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErroralways_invoice from enums BillingPortal.Configuration.features.subscription_cancel.proration_behavior, BillingPortal.ConfigurationCreateParams.features.subscription_cancel.proration_behavior, and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.proration_behaviorbrand_product on Card, Source.card_present, Source.card, and Source.three_d_secureCard.regulated_status, Charge.payment_method_details.card.network_transaction_id, Charge.payment_method_details.card.regulated_status, ConfirmationToken.payment_method_preview.card.regulated_status, CreditNote.pretax_credit_amounts, Invoice.total_pretax_credit_amounts, Issuing.Authorization.merchant_data.tax_id, Issuing.Transaction.merchant_data.tax_id, and PaymentMethod.card.regulated_status to be requiredcountry on Charge.payment_method_details.paypal, ConfirmationToken.payment_method_preview.paypal, and PaymentMethod.paypalal_tin on enums Checkout.Session.collected_information.tax_ids[].type and Order.tax_details.tax_ids[].typeal_tin on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typephone_number_collection on PaymentLinkUpdateParamsnickname on Treasury.FinancialAccountCreateParams, Treasury.FinancialAccountUpdateParams, and Treasury.FinancialAccountforwarding_settings on Treasury.FinancialAccountUpdateParamsis_default on Treasury.FinancialAccountdestination_payment_method_data on Treasury.OutboundTransferCreateParamsfinancial_account on Treasury.OutboundTransfer.destination_payment_method_detailsTreasury.OutboundTransfer.destination_payment_method_details.type from literal('us_bank_account') to enum('financial_account'|'us_bank_account')outbound_transfer on enums Treasury.ReceivedCredit.linked_flows.source_flow_details.type and Treasury.ReceivedCreditListParams.linked_flows.source_flow_typeoutbound_transfer on Treasury.ReceivedCredit.linked_flows.source_flow_details2024-12-18.acacia.
Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count to be optionalnetwork_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorpayout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.typecredits_application_invoice_voided on Billing.CreditBalanceTransaction.creditBilling.CreditBalanceTransaction.credit.type from literal('credits_granted') to enum('credits_application_invoice_voided'|'credits_granted')BillingPortal.Configuration.features.subscription_update.schedule_at_period_end, Issuing.Authorization.verified_by_fraud_challenge, LineItem.description, and Payout.trace_id to be requiredallow_redisplay on Card and Sourceregulated_status on Card, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card, and PaymentMethod.cardfunding on Charge.payment_method_details.amazon_pay and Charge.payment_method_details.revolut_paynetwork_transaction_id on Charge.payment_method_details.cardreference_prefix on Checkout.Session.payment_method_options.bacs_debit.mandate_options, Checkout.Session.payment_method_options.sepa_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntent.payment_method_options.bacs_debit.mandate_options, PaymentIntent.payment_method_options.sepa_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, SetupIntent.payment_method_options.bacs_debit.mandate_options, SetupIntent.payment_method_options.sepa_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, and SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_optionsal_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin 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.typeal_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typevisa_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidencerequest_signature on enums Forwarding.Request.replacements[] and Forwarding.RequestCreateParams.replacements[]account_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_transfer.financial_addresses[].sort_code, FundingInstructions.bank_transfer.financial_addresses[].spei, FundingInstructions.bank_transfer.financial_addresses[].zengin, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zenginaccount_holder_name on FundingInstructions.bank_transfer.financial_addresses[].spei and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].speidisabled_reason on Invoice.automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_taxtax_id on Issuing.Authorization.merchant_data and Issuing.Transaction.merchant_dataLineItem.description from string to string | nulltrial_period_days on PaymentLinkUpdateParams.subscription_dataal, am, ao, ba, bb, bs, cd, gn, kh, me, mk, mr, np, pe, sn, sr, tj, ug, uy, zm, and zw on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options2024-12-18.acacia on enum WebhookEndpointCreateParams.api_versionAccount.business_profile.annual_revenue and Account.business_profile.estimated_worker_count to be optionalallow_redisplay on Card and Sourceam_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums Checkout.Session.collected_information.tax_ids[].type and Order.tax_details.tax_ids[].typenetwork_fallback on enum Issuing.Authorization.request_history[].reasonam_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typeamount_refunded on PaymentRecordaccount on Terminal.Reader.action.collect_payment_method, Terminal.Reader.action.confirm_payment_intent, Terminal.Reader.action.process_payment_intent, and Terminal.Reader.action.refund_paymentautomatic_indirect_tax on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiespayout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.typereference_prefix on Checkout.Session.payment_method_options.bacs_debit.mandate_options, Checkout.Session.payment_method_options.sepa_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options, Order.payment.settings.payment_method_options.sepa_debit.mandate_options, OrderCreateParams.payment.settings.payment_method_options.sepa_debit.mandate_options, OrderUpdateParams.payment.settings.payment_method_options.sepa_debit.mandate_options, PaymentIntent.payment_method_options.bacs_debit.mandate_options, PaymentIntent.payment_method_options.sepa_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, SetupIntent.payment_method_options.bacs_debit.mandate_options, SetupIntent.payment_method_options.sepa_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, and SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_optionsdisabled_reason on Invoice.automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_taxIssuing.Authorization.verified_by_fraud_challenge to be requiredtrial_period_days on PaymentLinkUpdateParams.subscription_datanetwork_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorBillingPortal.Configuration.features.subscription_update.schedule_at_period_end and LineItem.description to be requiredfunding on Charge.payment_method_details.amazon_pay and Charge.payment_method_details.revolut_payamount_requested and partial_authorization on Charge.payment_method_details.cardmetadata on Checkout.SessionCreateParams.line_items[] and LineItemline_items on Checkout.Session.permissions.update, Checkout.SessionCreateParams.permissions.update, and Checkout.SessionUpdateParamsinvoice.overpaid on enum Event.typeadjustable_quantity and display on LineItemLineItem.description from string to string | nullrequest_partial_authorization on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, and PaymentIntentUpdateParams.payment_method_options.cardpayment_method_options on PaymentIntentIncrementAuthorizationParamsinvoice.overpaid on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]2024-11-20.acacia.
respond test helper method on resource Issuing.Authorizationauthorizer on AccountPersonsParams.relationship and TokenCreateParams.person.relationshipAccount.future_requirements.disabled_reason and Account.requirements.disabled_reason from string to enumAccountSession.components.account_management.features.disable_stripe_user_authentication, AccountSession.components.account_onboarding.features.disable_stripe_user_authentication, AccountSession.components.balances.features.disable_stripe_user_authentication, AccountSession.components.notification_banner.features.disable_stripe_user_authentication, and AccountSession.components.payouts.features.disable_stripe_user_authentication to be requiredadaptive_pricing on Checkout.SessionCreateParams and Checkout.Sessionmandate_options on Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, Checkout.SessionCreateParams.payment_method_options.bacs_debit, and Checkout.SessionCreateParams.payment_method_options.sepa_debitrequest_extended_authorization, request_incremental_authorization, request_multicapture, and request_overcapture on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardcapture_method on Checkout.SessionCreateParams.payment_method_options.kakao_pay, Checkout.SessionCreateParams.payment_method_options.kr_card, Checkout.SessionCreateParams.payment_method_options.naver_pay, Checkout.SessionCreateParams.payment_method_options.payco, and Checkout.SessionCreateParams.payment_method_options.samsung_paysubscribe on enums Checkout.Session.submit_type, Checkout.SessionCreateParams.submit_type, PaymentLink.submit_type, and PaymentLinkCreateParams.submit_typeli_vat 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.typeli_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typefinancial_account_statement on enums File.purpose and FileListParams.purposeaccount_holder_address, account_holder_name, account_type, and bank_address on FundingInstructions.bank_transfer.financial_addresses[].aba, FundingInstructions.bank_transfer.financial_addresses[].swift, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swiftservice_tax on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typemerchant_amount and merchant_currency on Issuing.AuthorizationCreateParams.testHelpersIssuing.AuthorizationCreateParams.testHelpers.amount to be optionalfraud_challenges and verified_by_fraud_challenge on Issuing.Authorizationlink on enums PaymentIntent.payment_method_options.card.network, PaymentIntentConfirmParams.payment_method_options.card.network, PaymentIntentCreateParams.payment_method_options.card.network, PaymentIntentUpdateParams.payment_method_options.card.network, SetupIntent.payment_method_options.card.network, SetupIntentConfirmParams.payment_method_options.card.network, SetupIntentCreateParams.payment_method_options.card.network, SetupIntentUpdateParams.payment_method_options.card.network, Subscription.payment_settings.payment_method_options.card.network, SubscriptionCreateParams.payment_settings.payment_method_options.card.network, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.networksubmit_type on PaymentLinkUpdateParamstrace_id on Payoutnetwork_decline_code on Refund.destination_details.blik and Refund.destination_details.swishTreasury.InboundTransfer.origin_payment_method from string to string | null2024-11-20.acacia on enum WebhookEndpointCreateParams.api_versionStripe.V2.BillingResource, Stripe.V2.CoreResource, and Stripe.V2Resource types from the public interface as they are no longer needed. SDK usage will not be affected but any references to these types in your application will need to be removed.