• #2367 Pull in V2 FinancialAccount changes for June release
  • Add support for close and create methods on resource V2.MoneyManagement.FinancialAccount
  • Add support for new value storer on enums V2.Core.Account.applied_configurations and V2.Core.AccountCloseParams.applied_configurations
  • Add support for storer on V2.Core.Account.configuration, V2.Core.AccountCreateParams.configuration, and V2.Core.AccountUpdateParams.configuration
  • Add support for new values financial_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[].capability
  • Add support for new value storer on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configuration
  • Add support for status_details on V2.MoneyManagement.FinancialAccount
  • Add support for status on V2.MoneyManagement.FinancialAccountListParams
  • Add support for new value configuration.storer on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • Add support for thin events V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2.Core.Account
  • Add support for error types AlreadyExistsError and NonZeroBalanceError
• #2362 Prathmesh/merge node beta

See the changelog for more details.

• #2344 Update generated code for beta
  • Change type of 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, SubscriptionCreateParams.billing_mode, and SubscriptionScheduleCreateParams.billing_mode from enum('classic'|'flexible') to billing_mode
  • Add support for submission_method on Dispute.evidence_details
  • Add support for on_demand and subscriptions on OrderCreateParams.payment.settings.payment_method_options.klarna and OrderUpdateParams.payment.settings.payment_method_options.klarna
  • Change type of Order.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')
  • Add support for crypto on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_details
  • Add support for new value buut on enums PaymentAttemptRecord.payment_method_details.ideal.bank and PaymentRecord.payment_method_details.ideal.bank
  • Add support for new value BUUTNL2A on enums PaymentAttemptRecord.payment_method_details.ideal.bic and PaymentRecord.payment_method_details.ideal.bic
  • Change type of PaymentIntent.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')
  • Change Quote.subscription_data.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode to be required
  • Add support for new value crypto on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Change type of QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode from enum('classic'|'flexible') to SubscriptionsResourceBillingMode
  • Change type of SubscriptionMigrateParams.billing_mode from literal('flexible') to billing_mode_migrate
  • Remove support for billing_mode_details on Subscription
  • Add support for new value xx 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.country
  • Add support for new value unsupported_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.Ac...

• #2348 Update generated code
  • Add support for migrate method on resource Subscription
  • Add support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
  • Add support for crypto_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for proof_of_address on AccountCreateParams.documents and AccountUpdateParams.documents
  • Add support for monthly_payout_days and weekly_payout_days on Account.settings.payouts.schedule, AccountCreateParams.settings.payouts.schedule, and AccountUpdateParams.settings.payouts.schedule
  • Change Account.settings.invoices.hosted_payment_method_save to be required
  • Add support for crypto 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_data
  • Change type of Charge.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')
  • Add support for new value 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.bank
  • Add support for new value BUUTNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for subscriptions on Checkout.SessionCreateParams.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Add support for new value crypto on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for billing_mode on Checkout.SessionCreateParams.subscription_data, InvoiceCreatePreviewParams.schedule_details, InvoiceCreatePreviewParams.subscription_details, Quote.subscription_data, QuoteCreateParams.subscription_data, SubscriptionCreateParams, SubscriptionScheduleCreateParams, SubscriptionSchedule, and Subscription
  • Add support for new value crypto 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.type
  • Add support for new value crypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new value crypto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value compliance on enum Dispute.payment_method_details.card.case_type
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSessionCreateParams and Identity.VerificationSession
  • Add support for matching on Identity.VerificationSession.options
  • Add support for new value crypto 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_types
  • Add support for klarna on Mandate.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for on_demand on PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Change type of PaymentIntent.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')
  • Add support for ua on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Change type of Terminal.LocationUpdateParams.display_name from string to emptyable(string)
  • Add support for collect_payment_method and confirm_payment_intent on Terminal.Reader.action
  • Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.action.type
  • Add support for status on Treasury.FinancialAccountListParams
  • Add support for new value terminal.reader.action_updated on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-06-30.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for snapshot event TerminalReaderActionUpdatedEvent with resource Terminal.Reader
• #2356 Add mise config for node version
• #2354 Add stripeContext to theRequestOptions and StripeConfig interfaces.

See the changelog for more details.

• #2358 Pull in OffSessionPayment changes for the May release

See the changelog for more details.

• #2346 Allow data to be set in only POST rawRequests
  • Fix bug where rawRequest incorrectly emits a warning when sending v2 GET requests

See the changelog for more details.

This release changes the pinned API version to 2025-05-28.preview.

• #2324 Update generated code for beta

  Breaking changes

  • Remove support for deprecated previews
    • Remove support for resources Billing.MeterErrorReport, GiftCards.Card, and GiftCards.Transaction
    • Remove support for create, list, retrieve, update, and validate methods on resource GiftCards.Card
    • Remove support for cancel, confirm, create, list, retrieve, and update methods on resource GiftCards.Transaction
    • Remove support for provisioning on ProductCreateParams and Product
    • Remove support for snapshot event BillingMeterErrorReportTriggeredEvent with resource Billing.MeterErrorReport
    • Remove support for error codes gift_card_balance_insufficient, gift_card_code_exists, and gift_card_inactive on QuotePreviewInvoice.last_finalization_error and StripeError
  • Remove support for values credits_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_mode
  • Change type of Checkout.SessionUpdateParams.line_items[].quantity from emptyable(longInteger) to longInteger
  • Change CreditNote.post_payment_amount to be required
  • Change CreditNote.pre_payment_amount to be required
  • Change type of InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Remove support for credits on OrderCreateParams, OrderUpdateParams, and Order
  • Remove support for amount_remaining on Order
  • Remove support for amount_credit on Order.total_details
  • Change type of PaymentAttemptRecord.metadata and PaymentRecord.metadata from map(string: string) | null to map(string: string)
  • Change type of PaymentRecordReportPaymentAttemptCanceledParams.metadata, PaymentRecordReportPaymentAttemptFailedParams.metadata, PaymentRecordReportPaymentAttemptGuaranteedParams.metadata, PaymentRecordReportPaymentAttemptParams.metadata, and PaymentRecordReportPaymentParams.metadata from map(string: string) to emptyable(map(string: string))
  • Change type of Privacy.RedactionJob.status from string to enum
  • Change type of Privacy.RedactionJob.validation_behavior from string to enum('error'|'fix')
  • Change type of Privacy.RedactionJobValidationError.code from string to enum
  • Change type of Privacy.RedactionJobValidationError.erroring_object from map(string: string) to RedactionResourceErroringObject
  • Remove support for status_details and status on Tax.Association

  Other changes

  • Add support for migrate method on resource Subscription
  • Add support for distance, 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_rental
  • Add support for driver_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[]
  • Add support for new values 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_mode
  • Add support for institution on FinancialConnections.Account
  • Add support for countries on FinancialConnections.Institution
  • Add support for location 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_pay
  • Add support for hooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
  • Remove support for async_workflows on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
  • Add support for card_present on PaymentIntentAmountDetailsLineItem.payment_method_options
  • Add support for livemode on Privacy.RedactionJob
  • Add support for billing_thresholds on QuotePreviewSubscriptionSchedule.default_settings, QuotePreviewSubscriptionSchedule.phases[].items[], and QuotePreviewSubscriptionSchedule.phases[]
  • Add support for billing_mode_details on Subscription
  • Add support for tax_transaction_attempts on Tax.Association
  • Add support for confirm_config on Terminal.Reader.action.confirm_payment_intent and Terminal.ReaderConfirmPaymentIntentParams
  • Add support for error code forwarding_api_upstream_error on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

This release changes the pinned API version to 2025-05-28.basil.

• #2338 Update generated code
  • Add support for attach_payment method on resource Invoice
  • Add support for collect_inputs method on resource Terminal.Reader
  • Add support for succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.Reader
  • Add support for pix_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for disputes_list and payment_disputes on AccountSession.components and AccountSessionCreateParams.components
  • Add support for refund_and_dispute_prefunding on Balance
  • Add support for balance_type on BalanceTransaction
  • Change Billing.AlertCreateParams.usage_threshold.meter to be required
  • Add support for location and reader on Charge.payment_method_details.affirm and Charge.payment_method_details.wechat_pay
  • Add support for payment_method_remove on Checkout.SessionCreateParams.saved_payment_method_options
  • Add support for setup_future_usage on Checkout.Session.payment_method_options.naver_pay
  • Change ConfirmationToken.payment_method_preview.naver_pay.buyer_id and PaymentMethod.naver_pay.buyer_id to be required
  • Add support for post_payment_amount and pre_payment_amount on CreditNote
  • Add support for new value mixed on enum CreditNote.type
  • Add support for new value invoice_payment.paid on enum Event.type
  • Add support for sex, unparsed_place_of_birth, and unparsed_sex on Identity.VerificationReport.document and Identity.VerificationSession.verified_outputs
  • Add support for 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 Subscription
  • Add support for satispay on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for capture_method on PaymentIntent.payment_method_options.billie
  • Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for network_decline_code on Refund.destination_details.paypal
  • Add support for metadata on Tax.CalculationCreateParams.line_items[] and Tax.CalculationLineItem
  • Add support for new value simulated_stripe_s700 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_type
  • Add support for return_url on Terminal.Reader.action.process_payment_intent.process_config and Terminal.ReaderProcessPaymentIntentParams.process_config
  • Add support for collect_inputs on Terminal.Reader.action
  • Add support for new value collect_inputs on enum Terminal.Reader.action.type
  • Add support for new value invoice_payment.paid on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-05-28.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for snapshot event InvoicePaymentPaidEvent with resource InvoicePayment
  • Add support for error code forwarding_api_upstream_error on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

• #2308 RawRequest now allows you set host and streaming in request options.

  const file = await stripe.rawRequest(
    'GET',
    '/v1/files/file_123/contents',
    {},
    {host: 'files.stripe.com', streaming: true}
  );

• #2320 fix: examples/webhook-signing/nestjs/package.json to reduce vulnerabilities
• #2326 Adds CONTRIBUTING.md

See the changelog for more details.

• #2307 Update generated code for beta
  This release changes the pinned API version to 2025-04-30.preview.

  • Add support for billing_mode on Checkout.SessionCreateParams.subscription_data, InvoiceCreatePreviewParams.schedule_details, InvoiceCreatePreviewParams.subscription_details, Quote.subscription_data, QuoteCreateParams.subscription_data, QuotePreviewSubscriptionSchedule, SubscriptionCreateParams, SubscriptionScheduleCreateParams, SubscriptionSchedule, and Subscription
  • Add support for new values aw_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[].type
  • Change Checkout.Session.automatic_tax.provider, Invoice.automatic_tax.provider, Quote.automatic_tax.provider, and QuotePreviewInvoice.automatic_tax.provider to be required
  • Add support for account_number on ConfirmationToken.payment_method_preview.acss_debit and PaymentMethod.acss_debit
  • Add support for new value balance_settings.updated on enum Event.type
  • Add support for new values aw_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[].type
  • Add support for new value balance_settings.updated on enums WebhookEndpointUpdateParams.enabled_events

See the changelog for more details.

This release changes the pinned API version to 2025-04-30.basil.

• #2311 Update generated code
  • Add support for minority_owned_business_designation on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
  • Add support for registration_date on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • Add support for us_cfpb_data on AccountCreatePersonParams, AccountUpdatePersonParams, Person, and TokenCreateParams.person
  • Add support for new value verification_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[].code
  • Add support for new value tax_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.code
  • Add support for tax_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_details
  • Add support for wallet_options on Checkout.SessionCreateParams and Checkout.Session
  • Add support for provider on Checkout.Session.automatic_tax, Invoice.automatic_tax, and Quote.automatic_tax
  • Add support for new values aw_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.type
  • Add support for payment_method_options on ConfirmationTokenCreateParams.testHelpers
  • Add support for installments on ConfirmationToken.payment_method_options.card
  • Add support for new values aw_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.type
  • Add support for context on Event
  • Add support for new value affirm 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_types
  • Change type of InvoiceLineItem.parent.subscription_item_details.subscription from string to string | null
  • Add support for billie on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for pix on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for klarna on PaymentMethodDomain
  • Add support for pending_reason on Refund
  • Change type of Tax.CalculationLineItem.reference from string | null to string
  • Add support for aw, az, bd, bf, bj, cm, cv, et, in, kg, la, and ph on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Add support for new value 2025-04-30.basil on enum WebhookEndpointCreateParams.api_version
• #2202 Add build scripts to generate source maps
• #2169 Put @types/node as an optional peerDependency
• #2164 Bump micromatch from 4.0.5 to 4.0.8
• #2230 Bump cross-spawn from 7.0.3 to 7.0.6

See the changelog for more details.