PaymentMethodBalancecheck_balance method on resource PaymentMethodbenefits on Card, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card, and PaymentMethod.cardbenefit on PaymentIntent.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_detailssetup_details on SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentUpdateParams, 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.attestations.terms_of_service, V2.Core.AccountCreateParams.configuration, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, V2.Core.AccountUpdateParams.configuration, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_servicecommercial.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.requirements.entries[].impact.restricts_capabilities[].capabilitycard_creator on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configurationconfiguration.card_creator on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.includeV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationCardCreatorUpdatedEvent with related object V2.Core.AccountV1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, and V1CustomerDiscountUpdatedEvent with related object Discount#2453 add missing fetchEvent type for UnknownEventNotification
fetchEvent() declaration to the Stripe.Events.UnknownEventNotification interfaceStripe.Events.fetchRelatedObject so that it's always defined and returns null if there's no related_object. This fixes the situation where the UnknownEventNotification says that fetchRelatedObject() is defined, but calling it throws an error.#2447 Update param in deprecation docs link
#2444 Update CHANGELOG.md to point to right API version
This release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 19.0.0 and 19.1.0-beta.1 which contain breaking changes. Please review the changelog for these versions if upgrading from older SDK versions.
StripeClient.parseThinEvent__experimental and PushedThinEvent classes. They've been replaced with StripeClient.parseEventNotification and the *EventNotification classes respectively.V2.MoneyManagement.RecipientVerificationacknowledge, create, recipient_verifications, and retrieve methods on resource V2.MoneyManagement.RecipientVerificationupdate method on resources V2.Billing.PricingPlanSubscription and V2.Billing.ServiceActioncrypto_wallets on V2.Account.configuration.recipient_data.features, V2.AccountCreateParams.configuration.recipient_data.features, V2.AccountUpdateParams.configuration.recipient_data.features, V2.Core.Account.configuration.recipient.capabilities, V2.Core.AccountCreateParams.configuration.recipient.capabilities, and V2.Core.AccountUpdateParams.configuration.recipient.capabilitiescrypto on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitycrypto_wallet on enum V2.Account.configuration.recipient_data.default_outbound_destination.typecrypto_wallets on enum V2.Account.configuration.supportable_features.recipient_datacrypto_wallets on enum V2.Account.requirements[].impact.required_for_featureslookup_key on V2.Billing.CadenceCreateParams, V2.Billing.CadenceUpdateParams, and V2.Billing.Cadencesettings_data on V2.Billing.CadenceV2.Billing.Cadence.payer.billing_profile from string | null to stringv1_event_id on V2.Core.Eventrecipient_verification on V2.MoneyManagement.OutboundPaymentCreateParams, V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundTransferCreateParams, and V2.MoneyManagement.OutboundTransfercrypto_wallet on V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data and V2.MoneyManagement.PayoutMethodcustom_pricing_unit_details on V2.Billing.RateCardRate.custom_pricing_unit_amount, V2.Billing.ServiceAction.credit_grant.amount.custom_pricing_unit, and V2.Billing.ServiceAction.credit_grant_per_tenant.amount.custom_pricing_unitorigin_type on V2.MoneyManagement.ReceivedDebit.bank_transfersepa_credit_transfer on enum V2.FinancialAddressCreditSimulationCreditParams.networkcredentials.sepa_bank_account.iban on enums V2.MoneyManagement.FinancialAddressListParams.include and V2.MoneyManagement.FinancialAddressRetrieveParams.includesepa_bank_account on V2.MoneyManagement.FinancialAddressCreateParamsprice on V2.Billing.RateCardRateCreateParamsV2.Billing.LicenseFeeUpdateParams.display_name to be optionallookup_keys on V2.Billing.CadenceListParamsV2.Billing.CadenceCancelParams.include, V2.Billing.CadenceCreateParams.include, V2.Billing.CadenceListParams.include, V2.Billing.CadenceRetrieveParams.include, and V2.Billing.CadenceUpdateParams.include from literal('invoice_discount_rules') to enum('invoice_discount_rules'|'settings_data')customer and type on V2.Billing.CadenceCreateParams.payerV2.Billing.CadenceCreateParams.payer.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.MoneyManagement.RecipientVerificationaccount_rate_limit_exceeded on RateLimitErrorThis release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 19.0.0 which contains breaking changes. Please review the changelog for 19.0.0 if upgrading from older SDK versions.
attach_cadence method on resource Subscriptionbilling_cadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionUpdateParams, 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, retrieve, and update 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, retrieve, and update methods on resource V2.Billing.Cadencecrypto_wallet on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typeprofile on V2.Core.Account.defaults, V2.Core.AccountCreateParams.defaults, and V2.Core.AccountUpdateParams.defaultsi_p on V2.Core.Account.identity.attestations.directorship_declaration, V2.Core.Account.identity.attestations.ownership_declaration, V2.Core.Account.identity.attestations.terms_of_service.account, V2.Core.Account.identity.attestations.terms_of_service.storer, V2.Core.Account.identity.individual.additional_terms_of_service.account, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.account, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.storer, V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.account, V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.storer, V2.Core.Person.additional_terms_of_service.account, V2.Core.PersonCreateParams.additional_terms_of_service.account, and V2.Core.PersonUpdateParams.additional_terms_of_service.accountip on V2.Core.Account.identity.attestations.directorship_declaration, V2.Core.Account.identity.attestations.ownership_declaration, V2.Core.Account.identity.attestations.terms_of_service.account, V2.Core.Account.identity.attestations.terms_of_service.storer, V2.Core.Account.identity.individual.additional_terms_of_service.account, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.account, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.storer, V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.account, V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.storer, V2.Core.Person.additional_terms_of_service.account, V2.Core.PersonCreateParams.additional_terms_of_service.account, and V2.Core.PersonUpdateParams.additional_terms_of_service.accountdoing_business_as, product_description, and url on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_detailssettlement_currency on V2.MoneyManagement.FinancialAddresssepa_bank_account on V2.MoneyManagement.FinancialAddress.credentials and V2.MoneyManagement.ReceivedCredit.bank_transfersepa_bank_account on enum V2.MoneyManagement.FinancialAddress.credentials.typeamount_details and payments_orchestration on V2.Payments.OffSessionPaymentCreateParams and V2.Payments.OffSessionPaymentauthorization_expired on enum V2.Payments.OffSessionPayment.failure_reasonretry_policy on V2.Payments.OffSessionPayment.retry_details and V2.Payments.OffSessionPaymentCreateParams.retry_detailsheuristic and scheduled on enums V2.Payments.OffSessionPayment.retry_details.retry_strategy and V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategyV2.MoneyManagement.OutboundPaymentQuote.fx_quote.lock_duration from literal('five_minutes') to enum('five_minutes'|'none')V2.MoneyManagement.OutboundPaymentQuote.fx_quote.lock_expires_at from DateTime to DateTime | nullnone on enum V2.MoneyManagement.OutboundPaymentQuote.fx_quote.lock_statuscrypto_wallet on enums V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.type, V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.type, and V2.MoneyManagement.PayoutMethod.typeorigin_type on V2.MoneyManagement.ReceivedCredit.bank_transferpayment_method_type on V2.MoneyManagement.ReceivedCredit.bank_transferprevented on enum Dispute.statusmandate_data and payment_method_options on V2.Payments.OffSessionPaymentCreateParamstype on V2.MoneyManagement.FinancialAddressCreateParamscurrency on V2.MoneyManagement.FinancialAddressCreateParamsfinancial_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 BalanceSettingUpdateParams.payments.payouts and BalanceSettings.payments.payoutssaturday and sunday from enums BalanceSettingUpdateParams.payments.payouts.schedule.weekly_payout_days and BalanceSettings.payments.payouts.schedule.weekly_payout_daysBalanceSettingUpdateParams.payments.settlement_timing.delay_days_override from longInteger to emptyable(longInteger)BalanceSettingUpdateParams.payments to be optionaldelay_days_override on BalanceSettings.payments.settlement_timingautomatic_tax and invoice_creation on Checkout.SessionUpdateParamsunit_label on Checkout.SessionUpdateParams.line_items[].price_data.product_datainvoice_settings on Checkout.SessionUpdateParams.subscription_dataCheckout.Session.collected_information.business_name to be requiredintended_submission_method on DisputeUpdateParams and DisputeDispute.smart_disputes.recommended_evidence from string to array(string)pix on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionspix 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_typesbilling_schedules on InvoiceCreatePreviewParams.subscription_details, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscriptionpaypay on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_detailswallet on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.cardPaymentAttemptRecord.processor_details.custom.payment_reference and PaymentRecord.processor_details.custom.payment_reference from string to string | nullflexible on QuotePreviewSubscriptionSchedule.billing_modebilled_until on SubscriptionItemfinancial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on QuotePreviewInvoice.last_finalization_errorThis release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)
#2427 Move V2.Event API resources to V2.Core.Events
Stripe.V2 to Stripe.V2.Core. This enables us to correctly match the API path to the namespace
Stripe.V2.EventDestination -> Stripe.V2.Core.EventDestinationStripe.V2.Event -> Stripe.V2.Core.EventStripe.V2.EventBase -> Stripe.V2.Core.EventBaseStripe.V2.Events.RelatedObject -> Stripe.V2.Core.Events.RelatedObject#2370 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.
StripeClient.parseThinEvent to StripeClient.parseEventNotification and remove the Stripe.ThinEvent interface.
Stripe.V2.EventNotification which is a union of all possible event notifications instead of Stripe.ThinEvent. When applicable, these event notifications will have the relatedObject field and a function fetchRelatedObject(). They also have a fetchEvent() method to retrieve their corresponding event.UnknownEventNotification to then access the relatedObject field and the function fetchRelatedObject()#2432 Drop support for Node < 16 & clarify policy
#2426 Add StripeContext object
StripeContext class. It can be used anywhere the context option is supplied and gets serialized to a string when making requests.EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext#2398 ⚠️ 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.StripeClient.v2 namespace) from a null union to optional (e.g. prop: string | null -> prop?: string).#2420 Fixed file uploading in Bun runtimes
FetchHttpClient (e.g. Bun). This bug affected Node SDK versions between 18.1.0 to 18.5.0.#2405 support more npm tags
beta npm tag. Instead, we'll use latest, public-preview, or private-preview to more closely align with Stripe's release phases#2402, #2413, #2430, #2428 Update generated code based on incoming API changes in the 2025-09-30.clover API version.
balance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.componentssaturday and sunday from enums Account.settings.payouts.schedule.weekly_payout_days, AccountCreateParams.settings.payouts.schedule.weekly_payout_days, and AccountUpdateParams.settings.payouts.schedule.weekly_payout_days
external_request and unsupported_business_type 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[].codelink and pay_by_bank on PaymentMethodUpdateParamscoupon on Discount, PromotionCodeCreateParams, and PromotionCode. Use Discount.source.coupon, PromotionCodeCreateParams.promotion.coupon and PromotionCode.coupon instead.Invoice.id to be required.prevented on enum Dispute.statusBalanceSettingsretrieve and update methods on resource BalanceSettingsmb_way_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiessource on Discounttrial_update_behavior on BillingPortal.Configuration.features.subscription_update, BillingPortal.ConfigurationCreateParams.features.subscription_update, and BillingPortal.ConfigurationUpdateParams.features.subscription_updatemb_way on Charge.payment_method_details, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_databranding_settings and name_collection on Checkout.SessionCreateParams and Checkout.Sessionexcluded_payment_method_types on Checkout.SessionCreateParams, Checkout.Session, PaymentIntentConfirmParams, and PaymentIntentUpdateParamsunit_label on Checkout.SessionCreateParams.line_items[].price_data.product_data, InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, and PaymentLinkCreateParams.line_items[].price_data.product_dataalma, billie, and satispay on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_optionsdemo_pay on Checkout.SessionCreateParams.payment_method_optionscapture_method on Checkout.Session.payment_method_options.affirm, Checkout.Session.payment_method_options.afterpay_clearpay, Checkout.Session.payment_method_options.amazon_pay, Checkout.Session.payment_method_options.card, Checkout.Session.payment_method_options.cashapp, Checkout.Session.payment_method_options.klarna, Checkout.Session.payment_method_options.link, Checkout.Session.payment_method_options.mobilepay, Checkout.Session.payment_method_options.revolut_pay, Checkout.SessionCreateParams.payment_method_options.affirm, Checkout.SessionCreateParams.payment_method_options.afterpay_clearpay, Checkout.SessionCreateParams.payment_method_options.amazon_pay, Checkout.SessionCreateParams.payment_method_options.card, Checkout.SessionCreateParams.payment_method_options.cashapp, Checkout.SessionCreateParams.payment_method_options.klarna, Checkout.SessionCreateParams.payment_method_options.link, Checkout.SessionCreateParams.payment_method_options.mobilepay, and Checkout.SessionCreateParams.payment_method_options.revolut_payflexible on Checkout.SessionCreateParams.subscription_data.billing_mode, InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, Quote.subscription_data.billing_mode, QuoteCreateParams.subscription_data.billing_mode, Subscription.billing_mode, SubscriptionCreateParams.billing_mode, SubscriptionMigrateParams.billing_mode, SubscriptionSchedule.billing_mode, and SubscriptionScheduleCreateParams.billing_modebusiness_name and individual_name on Checkout.Session.collected_information, Checkout.Session.customer_details, CustomerCreateParams, CustomerUpdateParams, and Customermb_way 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.typemb_way on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typemb_way on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typechargeback_loss_reason_code on Dispute.payment_method_details.klarnanet_amount and proration_details on InvoiceItemiterations on InvoiceCreatePreviewParams.schedule_details.phases[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]fraud_disputability_likelihood and risk_assessment on Issuing.AuthorizationCreateParams.testHelperssecond_line on Issuing.Cardmb_way on enums PaymentIntent.excluded_payment_method_types and PaymentIntentCreateParams.excluded_payment_method_typesfr_meal_voucher_conecs on PaymentMethodConfigurationCreateParams and PaymentMethodConfigurationUpdateParamspromotion on PromotionCodeCreateParams and PromotionCodeacknowledged and payment_never_settled on enum Review.closed_reasonprovider on Tax.Settings.defaultsbbpos_wisepad3 on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationaddress_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.LocationCreateParams, Terminal.LocationUpdateParams, and Terminal.LocationTerminal.LocationCreateParams.address to be optionalTerminal.LocationCreateParams.display_name to be optional2025-09-30.clover on enum WebhookEndpointCreateParams.api_versionfinancial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorretrieve 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.Cadenceattach_cadence method on resource Subscriptioncurrency and external_customer_id on Billing.AlertTriggeredcustom_pricing_unit on Billing.AlertTriggered, Billing.CreditBalanceSummary.balances[].available_balance, Billing.CreditBalanceSummary.balances[].ledger_balance, Billing.CreditBalanceTransaction.credit.amount, Billing.CreditBalanceTransaction.debit.amount, Billing.CreditGrant.amount, and Billing.CreditGrantCreateParams.amountcustomer on Billing.AlertListParamsBilling.Alert.alert_type, Billing.AlertCreateParams.alert_type, and Billing.AlertListParams.alert_type from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')credit_balance_threshold on Billing.AlertCreateParams and Billing.Alertbillable_items on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and Billing.CreditGrantCreateParams.applicability_config.scopeBilling.CreditBalanceSummary.balances[].available_balance.type, Billing.CreditBalanceSummary.balances[].ledger_balance.type, Billing.CreditBalanceTransaction.credit.amount.type, Billing.CreditBalanceTransaction.debit.amount.type, Billing.CreditGrant.amount.type, and Billing.CreditGrantCreateParams.amount.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 InvoiceCreatePreviewParams, SubscriptionCreateParams, 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, retrieve, and update 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 resources V2.Core.ClaimableSandboxcancel, create, list, retrieve, and update methods on resources V2.Billing.Cadence and V2.Billing.RateCardSubscriptioncreate, list, retrieve, and update 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, del, list, and retrieve methods on resource V2.Billing.RateCardRatecreate, del, list, retrieve, and update 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.ReportRunRateLimitErrorThis 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.AccountUpdateParams.configuration.customer, V2.Core.AccountUpdateParams.configuration.merchant, V2.Core.AccountUpdateParams.configuration.recipient, and V2.Core.AccountUpdateParams.configuration.storerao_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.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].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.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type, V2.Core.Person.id_numbers[].type, V2.Core.PersonCreateParams.id_numbers[].type, and V2.Core.PersonUpdateParams.id_numbers[].typeBilling.AlertTriggered.value from longInteger to decimal_stringdisplay_name on V2.MoneyManagement.FinancialAccountCreateParams and V2.MoneyManagement.FinancialAccountcurrency_conversion on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categorycurrency_conversion on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowcurrency_conversion on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typepayments on BalanceSettingUpdateParams and BalanceSettingsdebit_negative_balances, payouts, and settlement_timing on BalanceSettingUpdateParams and BalanceSettingsmandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pixcoupon_data on Checkout.SessionCreateParams.discounts[]mandate_options on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pixCheckout.Session.payment_method_options.pix.setup_future_usage, Checkout.SessionCreateParams.payment_method_options.pix.setup_future_usage, PaymentIntent.payment_method_options.pix.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage, PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')amount on Mandate.multi_use, PaymentAttemptRecord, and PaymentRecordcurrency on Mandate.multi_usepix on Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_optionslimit on PaymentAttemptRecordListParamsamount_authorized, amount_refunded, and application on PaymentAttemptRecord and PaymentRecordprocessor_details on PaymentAttemptRecord, PaymentRecordReportPaymentParams, and PaymentRecordpayment_reference on PaymentAttemptRecord, PaymentRecordReportPaymentParams, and PaymentRecordinstallments on PaymentAttemptRecord.payment_method_details.alma and PaymentRecord.payment_method_details.almatransaction_id on PaymentAttemptRecord.payment_method_details.alma, PaymentAttemptRecord.payment_method_details.amazon_pay, PaymentAttemptRecord.payment_method_details.billie, PaymentAttemptRecord.payment_method_details.kakao_pay, PaymentAttemptRecord.payment_method_details.kr_card, PaymentAttemptRecord.payment_method_details.naver_pay, PaymentAttemptRecord.payment_method_details.payco, PaymentAttemptRecord.payment_method_details.revolut_pay, PaymentAttemptRecord.payment_method_details.samsung_pay, PaymentAttemptRecord.payment_method_details.satispay, PaymentRecord.payment_method_details.alma, PaymentRecord.payment_method_details.amazon_pay, PaymentRecord.payment_method_details.billie, PaymentRecord.payment_method_details.kakao_pay, PaymentRecord.payment_method_details.kr_card, PaymentRecord.payment_method_details.naver_pay, PaymentRecord.payment_method_details.payco, PaymentRecord.payment_method_details.revolut_pay, PaymentRecord.payment_method_details.samsung_pay, and PaymentRecord.payment_method_details.satispaylocation and reader on PaymentAttemptRecord.payment_method_details.paynow and PaymentRecord.payment_method_details.paynowlatest_active_mandate on PaymentMethodPayout.payout_method to be requiredmetadata and period on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]pix_display_qr_code on SetupIntent.next_actionreader_security on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationcustomer_session_expired and india_recurring_payment_mandate_canceled on QuotePreviewInvoice.last_finalization_error2025-08-27.basil.
balance_report, payout_details, and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.componentsname on BillingPortal.ConfigurationCreateParams, BillingPortal.ConfigurationUpdateParams, and BillingPortal.Configurationinstallments on Charge.payment_method_details.almatransaction_id on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispaylocation and reader on Charge.payment_method_details.paynowamount_includes_iof on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pixblock and resolution on enum Dispute.payment_method_details.card.case_typeterminal_android_apk on enums File.purpose and FileListParams.purposeterminal_android_apk on enum FileCreateParams.purposemetadata and period on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]exp_month and exp_year on Issuing.CardCreateParamsexcluded_payment_method_types on PaymentIntentCreateParams and PaymentIntentpayout_method on PayoutCreateParams and Payoutmxn on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tippingcard on Terminal.ReaderPresentPaymentMethodParams.testHelperscard on enum Terminal.ReaderPresentPaymentMethodParams.testHelpers.type2025-08-27.basil on enum WebhookEndpointCreateParams.api_versioncustomer_session_expired and india_recurring_payment_mandate_canceled on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorInvoicePaymentlist and retrieve methods on resource InvoicePaymentThis 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 BalanceSettingUpdateParams.payouts.schedule and BalanceSettings.payouts.schedulemonthly_anchor and weekly_anchor on BalanceSettingUpdateParams.payouts.schedule and BalanceSettings.payouts.scheduledelay_days_override on BalanceSettingUpdateParams.settlement_timingdelay_days on BalanceSettingUpdateParams.settlement_timingupdate_discounts on Checkout.SessionCreateParams.permissionsdiscounts and subscription_data on Checkout.SessionUpdateParamssmart_disputes on Disputeupi on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsupi 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_typestransaction_id on PaymentAttemptRecord.payment_method_details.cashapp and PaymentRecord.payment_method_details.cashappamount_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentUpdateParamspayment_details on PaymentIntentIncrementAuthorizationParamsstorer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_servicecollection_options on V2.Core.AccountLink.use_case.account_onboarding, V2.Core.AccountLink.use_case.account_update, V2.Core.AccountLinkCreateParams.use_case.account_onboarding, and V2.Core.AccountLinkCreateParams.use_case.account_updateV2.Core.AccountLink.use_case.account_onboarding.configurations, V2.Core.AccountLink.use_case.account_update.configurations, V2.Core.AccountLinkCreateParams.use_case.account_onboarding.configurations, and V2.Core.AccountLinkCreateParams.use_case.account_update.configurations from literal('recipient') to enum('customer'|'merchant'|'recipient'|'storer')bank_account_type on V2.MoneyManagement.PayoutMethod.bank_accountV2CoreAccountLinkReturnedEventV2MoneyManagementPayoutMethodUpdatedEvent with related object V2.MoneyManagement.PayoutMethodV2CoreAccountLinkCompletedEventV2OffSessionPaymentRequiresCaptureEvent with related object V2.Payments.OffSessionPaymentThis release changes the pinned API version to 2025-07-30.basil.
instant_payouts_promotion on AccountSession.components and AccountSessionCreateParams.componentsadjustable_quantity on BillingPortal.Configuration.features.subscription_update.products[], BillingPortal.ConfigurationCreateParams.features.subscription_update.products[], and BillingPortal.ConfigurationUpdateParams.features.subscription_update.products[]disabled from enum Capability.statustransaction_id on Charge.payment_method_details.cashapporigin_context on Checkout.SessionCreateParams and Checkout.Sessiontemplate on Checkout.Session.invoice_creation.invoice_data.rendering_options, Checkout.SessionCreateParams.invoice_creation.invoice_data.rendering_options, PaymentLink.invoice_creation.invoice_data.rendering_options, PaymentLinkCreateParams.invoice_creation.invoice_data.rendering_options, and PaymentLinkUpdateParams.invoice_creation.invoice_data.rendering_optionssetup_future_usage on Checkout.Session.payment_method_options.pix and Checkout.SessionCreateParams.payment_method_options.pixnz_bank_account on enum Checkout.SessionCreateParams.payment_method_typesIdentity.VerificationSession.related_person.account to be requiredIdentity.VerificationSession.related_person.person to be requiredduration on InvoiceCreatePreviewParams.schedule_details.phases[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')price_data on PaymentLinkCreateParams.line_items[]PaymentLinkCreateParams.line_items[].price to be optionalAmerica/Coyhaique on enum Reporting.ReportRunCreateParams.parameters.timezonestandard on Tax.Registration.country_options.ae, Tax.Registration.country_options.au, Tax.Registration.country_options.ch, Tax.Registration.country_options.gb, Tax.Registration.country_options.jp, Tax.Registration.country_options.no, Tax.Registration.country_options.nz, Tax.Registration.country_options.sg, Tax.RegistrationCreateParams.country_options.ae, Tax.RegistrationCreateParams.country_options.al, Tax.RegistrationCreateParams.country_options.ao, Tax.RegistrationCreateParams.country_options.au, Tax.RegistrationCreateParams.country_options.aw, Tax.RegistrationCreateParams.country_options.ba, Tax.RegistrationCreateParams.country_options.bb, Tax.RegistrationCreateParams.country_options.bd, Tax.RegistrationCreateParams.country_options.bf, Tax.RegistrationCreateParams.country_options.bh, Tax.RegistrationCreateParams.country_options.bs, Tax.RegistrationCreateParams.country_options.cd, Tax.RegistrationCreateParams.country_options.ch, Tax.RegistrationCreateParams.country_options.et, Tax.RegistrationCreateParams.country_options.gb, Tax.RegistrationCreateParams.country_options.gn, Tax.RegistrationCreateParams.country_options.is, Tax.RegistrationCreateParams.country_options.jp, Tax.RegistrationCreateParams.country_options.me, Tax.RegistrationCreateParams.country_options.mk, Tax.RegistrationCreateParams.country_options.mr, Tax.RegistrationCreateParams.country_options.no, Tax.RegistrationCreateParams.country_options.nz, Tax.RegistrationCreateParams.country_options.om, Tax.RegistrationCreateParams.country_options.rs, Tax.RegistrationCreateParams.country_options.sg, Tax.RegistrationCreateParams.country_options.sr, Tax.RegistrationCreateParams.country_options.uy, Tax.RegistrationCreateParams.country_options.za, and Tax.RegistrationCreateParams.country_options.zwinbound_goods on enums Tax.Registration.country_options.at.standard.place_of_supply_scheme, Tax.Registration.country_options.be.standard.place_of_supply_scheme, Tax.Registration.country_options.bg.standard.place_of_supply_scheme, Tax.Registration.country_options.cy.standard.place_of_supply_scheme, Tax.Registration.country_options.cz.standard.place_of_supply_scheme, Tax.Registration.country_options.de.standard.place_of_supply_scheme, Tax.Registration.country_options.dk.standard.place_of_supply_scheme, Tax.Registration.country_options.ee.standard.place_of_supply_scheme, Tax.Registration.country_options.es.standard.place_of_supply_scheme, Tax.Registration.country_options.fi.standard.place_of_supply_scheme, Tax.Registration.country_options.fr.standard.place_of_supply_scheme, Tax.Registration.country_options.gr.standard.place_of_supply_scheme, Tax.Registration.country_options.hr.standard.place_of_supply_scheme, Tax.Registration.country_options.hu.standard.place_of_supply_scheme, Tax.Registration.country_options.ie.standard.place_of_supply_scheme, Tax.Registration.country_options.it.standard.place_of_supply_scheme, Tax.Registration.country_options.lt.standard.place_of_supply_scheme, Tax.Registration.country_options.lu.standard.place_of_supply_scheme, Tax.Registration.country_options.lv.standard.place_of_supply_scheme, Tax.Registration.country_options.mt.standard.place_of_supply_scheme, Tax.Registration.country_options.nl.standard.place_of_supply_scheme, Tax.Registration.country_options.pl.standard.place_of_supply_scheme, Tax.Registration.country_options.pt.standard.place_of_supply_scheme, Tax.Registration.country_options.ro.standard.place_of_supply_scheme, Tax.Registration.country_options.se.standard.place_of_supply_scheme, Tax.Registration.country_options.si.standard.place_of_supply_scheme, Tax.Registration.country_options.sk.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.at.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.be.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.bg.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.cy.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.cz.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.de.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.dk.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ee.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.es.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.fi.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.fr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.gr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.hr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.hu.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ie.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.it.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lu.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lv.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.mt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.nl.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.pl.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.pt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ro.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.se.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.si.standard.place_of_supply_scheme, and Tax.RegistrationCreateParams.country_options.sk.standard.place_of_supply_schemeaed, bgn, huf, and ron on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping2025-07-30.basil on enum WebhookEndpointCreateParams.api_versionStripe.API_VERSIONclose and create methods on resource V2.MoneyManagement.FinancialAccountstorer on enums V2.Core.Account.applied_configurations and V2.Core.AccountCloseParams.applied_configurationsstorer on V2.Core.Account.configuration, V2.Core.AccountCreateParams.configuration, and V2.Core.AccountUpdateParams.configurationfinancial_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.requirements.entries[].impact.restricts_capabilities[].capabilitystorer on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configurationstatus_details on V2.MoneyManagement.FinancialAccountstatus on V2.MoneyManagement.FinancialAccountListParamsconfiguration.storer on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.includeV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2.Core.AccountAlreadyExistsError and NonZeroBalanceErrorCheckout.SessionCreateParams.subscription_data.billing_mode, InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, Quote.subscription_data.billing_mode, QuoteCreateParams.subscription_data.billing_mode, SubscriptionCreateParams.billing_mode, and SubscriptionScheduleCreateParams.billing_mode from enum('classic'|'flexible') to billing_modesubmission_method on Dispute.evidence_detailson_demand and subscriptions on OrderCreateParams.payment.settings.payment_method_options.klarna and OrderUpdateParams.payment.settings.payment_method_options.klarnaOrder.payment.settings.payment_method_options.klarna.setup_future_usage, OrderCreateParams.payment.settings.payment_method_options.klarna.setup_future_usage, and OrderUpdateParams.payment.settings.payment_method_options.klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')crypto on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_detailsbuut on enums PaymentAttemptRecord.payment_method_details.ideal.bank and PaymentRecord.payment_method_details.ideal.bankBUUTNL2A on enums PaymentAttemptRecord.payment_method_details.ideal.bic and PaymentRecord.payment_method_details.ideal.bicPaymentIntent.payment_method_options.gopay.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.gopay.setup_future_usage, PaymentIntentCreateParams.payment_method_options.gopay.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.gopay.setup_future_usage from literal('none') to enum('none'|'off_session')Quote.subscription_data.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode to be requiredcrypto on enum QuotePreviewInvoice.payment_settings.payment_method_typesQuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode from enum('classic'|'flexible') to SubscriptionsResourceBillingModeSubscriptionMigrateParams.billing_mode from literal('flexible') to billing_mode_migratebilling_mode_details on Subscriptionxx on enums V2.Core.Account.configuration.customer.automatic_indirect_tax.location.country, V2.Core.Account.configuration.customer.shipping.address.country, V2.Core.Account.configuration.merchant.support.address.country, V2.Core.Account.identity.business_details.address.country, V2.Core.Account.identity.business_details.script_addresses.kana.country, V2.Core.Account.identity.business_details.script_addresses.kanji.country, V2.Core.Account.identity.country, V2.Core.Account.identity.individual.additional_addresses[].country, V2.Core.Account.identity.individual.address.country, V2.Core.Account.identity.individual.script_addresses.kana.country, V2.Core.Account.identity.individual.script_addresses.kanji.country, V2.Core.AccountCreateParams.configuration.customer.shipping.address.country, V2.Core.AccountCreateParams.configuration.merchant.support.address.country, V2.Core.AccountCreateParams.identity.business_details.address.country, V2.Core.AccountCreateParams.identity.business_details.script_addresses.kana.country, V2.Core.AccountCreateParams.identity.business_details.script_addresses.kanji.country, V2.Core.AccountCreateParams.identity.country, V2.Core.AccountCreateParams.identity.individual.additional_addresses[].country, V2.Core.AccountCreateParams.identity.individual.address.country, V2.Core.AccountCreateParams.identity.individual.script_addresses.kana.country, V2.Core.AccountCreateParams.identity.individual.script_addresses.kanji.country, V2.Core.AccountUpdateParams.configuration.customer.shipping.address.country, V2.Core.AccountUpdateParams.configuration.merchant.support.address.country, V2.Core.AccountUpdateParams.identity.business_details.address.country, V2.Core.AccountUpdateParams.identity.business_details.script_addresses.kana.country, V2.Core.AccountUpdateParams.identity.business_details.script_addresses.kanji.country, V2.Core.AccountUpdateParams.identity.country, V2.Core.AccountUpdateParams.identity.individual.additional_addresses[].country, V2.Core.AccountUpdateParams.identity.individual.address.country, V2.Core.AccountUpdateParams.identity.individual.script_addresses.kana.country, V2.Core.AccountUpdateParams.identity.individual.script_addresses.kanji.country, V2.Core.Person.additional_addresses[].country, V2.Core.Person.address.country, V2.Core.Person.script_addresses.kana.country, V2.Core.Person.script_addresses.kanji.country, V2.Core.PersonCreateParams.additional_addresses[].country, V2.Core.PersonCreateParams.address.country, V2.Core.PersonCreateParams.script_addresses.kana.country, V2.Core.PersonCreateParams.script_addresses.kanji.country, V2.Core.PersonUpdateParams.additional_addresses[].country, V2.Core.PersonUpdateParams.address.country, V2.Core.PersonUpdateParams.script_addresses.kana.country, V2.Core.PersonUpdateParams.script_addresses.kanji.country, and V2.MoneyManagement.FinancialAccount.countryunsupported_entity_type on enums V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.affirm_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.alma_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.blik_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.boleto_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.card_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.eps_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.fpx_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.ideal_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.jcb_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.klarna_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.konbini_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.link_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.p24_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.payco_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.paynow_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.swish_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.twint_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.zip_payments.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.cards.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts.status_details[].code, and V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers.status_details[].codeproof_of_address on V2.Core.Account.identity.business_details.documents, V2.Core.AccountCreateParams.identity.business_details.documents, and V2.Core.AccountUpdateParams.identity.business_details.documentsxx on enums V2.Core.Account.identity.individual.nationalities, V2.Core.AccountCreateParams.identity.individual.nationalities, V2.Core.AccountUpdateParams.identity.individual.nationalities, V2.Core.Person.nationalities, V2.Core.PersonCreateParams.nationalities, and V2.Core.PersonUpdateParams.nationalitiesmetadata on V2.MoneyManagement.FinancialAccountdescription on V2.MoneyManagement.FinancialAccountpending on enum V2.MoneyManagement.FinancialAccount.statusattempts on V2.Payments.OffSessionPaymentV2.Payments.OffSessionPayment.transfer_data.amount from integer to integer | nullfrom_account, outbound_payment, and outbound_transfer on V2.MoneyManagement.ReceivedCredit.balance_transferV2.MoneyManagement.ReceivedCredit.balance_transfer.type from literal('payout_v1') to enum('outbound_payment'|'outbound_transfer'|'payout_v1')V2.MoneyManagement.ReceivedCredit.balance_transfer.payout_v1 from string to string | nullV2.Payments.OffSessionPaymentCreateParams.transfer_data.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 RecipientNotNotifiableErrormigrate method on resource Subscriptioncollect_payment_method and confirm_payment_intent methods on resource Terminal.Readercrypto_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesproof_of_address on AccountCreateParams.documents and AccountUpdateParams.documentsmonthly_payout_days and weekly_payout_days on Account.settings.payouts.schedule, AccountCreateParams.settings.payouts.schedule, and AccountUpdateParams.settings.payouts.scheduleAccount.settings.invoices.hosted_payment_method_save to be requiredcrypto on Charge.payment_method_details, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataCharge.payment_method_details.card.installments.plan.type, ConfirmationToken.payment_method_options.card.installments.plan.type, ConfirmationTokenCreateParams.testHelpers.payment_method_options.card.installments.plan.type, InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.type, InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.type, PaymentIntent.payment_method_options.card.installments.available_plans[].type, PaymentIntent.payment_method_options.card.installments.plan.type, PaymentIntentConfirmParams.payment_method_options.card.installments.plan.type, PaymentIntentCreateParams.payment_method_options.card.installments.plan.type, and PaymentIntentUpdateParams.payment_method_options.card.installments.plan.type from literal('fixed_count') to enum('bonus'|'fixed_count'|'revolving')buut on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bankBUUTNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bicsubscriptions on Checkout.SessionCreateParams.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarnacrypto on enum Checkout.SessionCreateParams.payment_method_typesbilling_mode on Checkout.SessionCreateParams.subscription_data, InvoiceCreatePreviewParams.schedule_details, InvoiceCreatePreviewParams.subscription_details, Quote.subscription_data, QuoteCreateParams.subscription_data, SubscriptionCreateParams, SubscriptionScheduleCreateParams, SubscriptionSchedule, and Subscriptioncrypto 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.typecrypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typecrypto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeDispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')compliance on enum Dispute.payment_method_details.card.case_typeterminal.reader.action_updated on enum Event.typerelated_person on Identity.VerificationSessionCreateParams and Identity.VerificationSessionmatching on Identity.VerificationSession.optionscrypto 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_typesklarna on Mandate.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_optionson_demand on PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarnaPaymentIntent.payment_method_options.klarna.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.klarna.setup_future_usage, PaymentIntentCreateParams.payment_method_options.klarna.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')ua on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionsTerminal.LocationUpdateParams.display_name from string to emptyable(string)collect_payment_method and confirm_payment_intent on Terminal.Reader.actioncollect_payment_method and confirm_payment_intent on enum Terminal.Reader.action.typestatus on Treasury.FinancialAccountListParamsterminal.reader.action_updated on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2025-06-30.basil on enum WebhookEndpointCreateParams.api_versionTerminalReaderActionUpdatedEvent with resource Terminal.ReaderstripeContext to theRequestOptions and StripeConfig interfaces.POST rawRequests
rawRequest incorrectly emits a warning when sending v2 GET requestsThis release changes the pinned API version to 2025-05-28.preview.
#2324 Update generated code for beta
Billing.MeterErrorReport, GiftCards.Card, and GiftCards.Transactioncreate, list, retrieve, update, and validate methods on resource GiftCards.Cardcancel, confirm, create, list, retrieve, and update methods on resource GiftCards.Transactionprovisioning on ProductCreateParams and ProductBillingMeterErrorReportTriggeredEvent with resource Billing.MeterErrorReportgift_card_balance_insufficient, gift_card_code_exists, and gift_card_inactive on QuotePreviewInvoice.last_finalization_error and StripeErrorcredits_attributed_to_debits and legacy_prorations from enums Checkout.SessionCreateParams.subscription_data.billing_mode, InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, Quote.subscription_data.billing_mode, QuoteCreateParams.subscription_data.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, SubscriptionCreateParams.billing_mode, SubscriptionSchedule.billing_mode, and SubscriptionScheduleCreateParams.billing_modeCheckout.SessionUpdateParams.line_items[].quantity from emptyable(longInteger) to longIntegerCreditNote.post_payment_amount to be requiredCreditNote.pre_payment_amount to be requiredInvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')credits on OrderCreateParams, OrderUpdateParams, and Orderamount_remaining on Orderamount_credit on Order.total_detailsPaymentAttemptRecord.metadata and PaymentRecord.metadata from map(string: string) | null to map(string: string)PaymentRecordReportPaymentAttemptCanceledParams.metadata, PaymentRecordReportPaymentAttemptFailedParams.metadata, PaymentRecordReportPaymentAttemptGuaranteedParams.metadata, PaymentRecordReportPaymentAttemptParams.metadata, and PaymentRecordReportPaymentParams.metadata from map(string: string) to emptyable(map(string: string))Privacy.RedactionJob.status from string to enumPrivacy.RedactionJob.validation_behavior from string to enum('error'|'fix')Privacy.RedactionJobValidationError.code from string to enumPrivacy.RedactionJobValidationError.erroring_object from map(string: string) to RedactionResourceErroringObjectstatus_details and status on Tax.Associationmigrate method on resource Subscriptiondistance, pickup_location_name, return_location_name, and vehicle_identification_number on ChargeCaptureParams.payment_details.car_rental, ChargeUpdateParams.payment_details.car_rental, PaymentIntent.payment_details.car_rental, PaymentIntentCaptureParams.payment_details.car_rental, PaymentIntentConfirmParams.payment_details.car_rental, PaymentIntentCreateParams.payment_details.car_rental, and PaymentIntentUpdateParams.payment_details.car_rentaldriver_identification_number and driver_tax_number on ChargeCaptureParams.payment_details.car_rental.drivers[], ChargeUpdateParams.payment_details.car_rental.drivers[], PaymentIntent.payment_details.car_rental.drivers[], PaymentIntentCaptureParams.payment_details.car_rental.drivers[], PaymentIntentConfirmParams.payment_details.car_rental.drivers[], PaymentIntentCreateParams.payment_details.car_rental.drivers[], and PaymentIntentUpdateParams.payment_details.car_rental.drivers[]classic and flexible on enums Checkout.SessionCreateParams.subscription_data.billing_mode, InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, Quote.subscription_data.billing_mode, QuoteCreateParams.subscription_data.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, SubscriptionCreateParams.billing_mode, SubscriptionSchedule.billing_mode, and SubscriptionScheduleCreateParams.billing_modeinstitution on FinancialConnections.Accountcountries on FinancialConnections.Institutionlocation and reader on PaymentAttemptRecord.payment_method_details.affirm, PaymentAttemptRecord.payment_method_details.wechat_pay, PaymentRecord.payment_method_details.affirm, and PaymentRecord.payment_method_details.wechat_payhooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntentasync_workflows on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntentcard_present on PaymentIntentAmountDetailsLineItem.payment_method_optionslivemode on Privacy.RedactionJobbilling_thresholds on QuotePreviewSubscriptionSchedule.default_settings, QuotePreviewSubscriptionSchedule.phases[].items[], and QuotePreviewSubscriptionSchedule.phases[]billing_mode_details on Subscriptiontax_transaction_attempts on Tax.Associationconfirm_config on Terminal.Reader.action.confirm_payment_intent and Terminal.ReaderConfirmPaymentIntentParamsforwarding_api_upstream_error on QuotePreviewInvoice.last_finalization_error