github stripe/stripe-node v21.1.0-alpha.1
on GitHub

pre-release5 hours ago

This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.

  • #2623 Update generated code for private-preview
    • Add support for new resource RiskSignals
    • Add support for upi_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
    • Add support for risk_signals on Account
    • Add support for financial_account_rewards and nesting_demo on AccountSession.components
    • Add support for fraud_intent on AccountSignals
    • ⚠️ Add support for new value related_accounts on enum AccountSignals.delinquency.indicators[].indicator
    • Add support for risk_reserved on Balance
    • ⚠️ Remove support for billable_items on Billing.Alert.spend_threshold.filters
    • Add support for upi on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Mandate.payment_method_details, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_options
    • ⚠️ Add support for new value tempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
    • ⚠️ Remove support for source_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balance
    • Add support for integration_identifier on Checkout.SessionCreateParams and Checkout.Session
    • ⚠️ Add support for new value application on enums Checkout.Session.automatic_tax.liability.type, Checkout.Session.invoice_creation.invoice_data.issuer.type, Checkout.SessionCreateParams.automatic_tax.liability.type, Checkout.SessionCreateParams.invoice_creation.invoice_data.issuer.type, Checkout.SessionCreateParams.subscription_data.invoice_settings.issuer.type, Checkout.SessionUpdateParams.automatic_tax.liability.type, Checkout.SessionUpdateParams.invoice_creation.invoice_data.issuer.type, Checkout.SessionUpdateParams.subscription_data.invoice_settings.issuer.type, Invoice.automatic_tax.liability.type, Invoice.issuer.type, InvoiceCreateParams.automatic_tax.liability.type, InvoiceCreateParams.issuer.type, InvoiceCreatePreviewParams.automatic_tax.liability.type, InvoiceCreatePreviewParams.issuer.type, InvoiceCreatePreviewParams.schedule_details.phases[].automatic_tax.liability.type, InvoiceCreatePreviewParams.schedule_details.phases[].invoice_settings.issuer.type, InvoiceUpdateParams.automatic_tax.liability.type, InvoiceUpdateParams.issuer.type, PaymentLink.automatic_tax.liability.type, PaymentLink.invoice_creation.invoice_data.issuer.type, PaymentLink.subscription_data.invoice_settings.issuer.type, PaymentLinkCreateParams.automatic_tax.liability.type, PaymentLinkCreateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkCreateParams.subscription_data.invoice_settings.issuer.type, PaymentLinkUpdateParams.automatic_tax.liability.type, PaymentLinkUpdateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkUpdateParams.subscription_data.invoice_settings.issuer.type, Quote.automatic_tax.liability.type, Quote.invoice_settings.issuer.type, QuoteCreateParams.automatic_tax.liability.type, QuoteCreateParams.invoice_settings.issuer.type, QuotePreviewInvoice.automatic_tax.liability.type, QuotePreviewInvoice.issuer.type, QuotePreviewSubscriptionSchedule.default_settings.automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.default_settings.invoice_settings.issuer.type, QuotePreviewSubscriptionSchedule.phases[].automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.phases[].invoice_settings.issuer.type, QuoteUpdateParams.automatic_tax.liability.type, QuoteUpdateParams.invoice_settings.issuer.type, Subscription.automatic_tax.liability.type, Subscription.invoice_settings.issuer.type, SubscriptionCreateParams.automatic_tax.liability.type, SubscriptionCreateParams.invoice_settings.issuer.type, SubscriptionSchedule.default_settings.automatic_tax.liability.type, SubscriptionSchedule.default_settings.invoice_settings.issuer.type, SubscriptionSchedule.phases[].automatic_tax.liability.type, SubscriptionSchedule.phases[].invoice_settings.issuer.type, SubscriptionScheduleCreateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleCreateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleCreateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleCreateParams.phases[].invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleUpdateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleUpdateParams.phases[].invoice_settings.issuer.type, SubscriptionUpdateParams.automatic_tax.liability.type, and SubscriptionUpdateParams.invoice_settings.issuer.type
    • Add support for new value upi on enum Checkout.SessionCreateParams.excluded_payment_method_types
    • Change type of Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code from string to emptyable(string)
    • Add support for crypto on Checkout.SessionCreateParams.payment_method_options
    • Add support for new value upi on enum Checkout.SessionCreateParams.payment_method_types
    • Add support for pending_invoice_item_interval on Checkout.SessionCreateParams.subscription_data and Checkout.SessionUpdateParams.subscription_data
    • ⚠️ Add support for new values elements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_mode
    • ⚠️ Remove support for values custom, embedded, and hosted from enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_mode
    • Change Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code to be optional
    • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.current_attempt.payment_method_details
    • ⚠️ Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
    • Add support for new value upi 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 upi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
    • Add support for metadata on CreditNoteCreateParams.lines[], CreditNoteLineItem, CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]
    • Add support for new value upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
    • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.fulfillment_details
    • Add support for line_item_keys on DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].digital.digital_options[] and DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].shipping.shipping_options[]
    • Add support for quantity_decimal on InvoiceAddLinesParams.lines[], InvoiceCreatePreviewParams.invoice_items[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]
    • Add support for expires_after_seconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pix
    • ⚠️ Add support for level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risk
    • ⚠️ Remove support for risk_level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risk
    • ⚠️ Add support for new values da, pl, and sv on enums Issuing.Cardholder.preferred_locales, Issuing.CardholderCreateParams.preferred_locales, and Issuing.CardholderUpdateParams.preferred_locales
    • Add support for lifecycle_controls on Issuing.CardCreateParams and Issuing.Card
    • ⚠️ Change type of Issuing.Token.network_data.visa.card_reference_id from string to string | null
    • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to enum | null
    • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to longInteger | null
    • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to longInteger | null
    • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to enum('credit'|'debit'|'prepaid'|'unknown') | null
    • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to string | null
    • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to boolean | null
    • Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
    • Add support for surcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
    • ⚠️ Add support for new value upi on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
    • Add support for mandate_options on PaymentIntent.payment_method_options.stripe_balance, PaymentIntentConfirmParams.payment_method_options.stripe_balance, PaymentIntentCreateParams.payment_method_options.stripe_balance, and PaymentIntentUpdateParams.payment_method_options.stripe_balance
    • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
    • Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_action
    • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
    • ⚠️ Add support for new value upi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
    • Add support for recommended_action and signals on Radar.PaymentEvaluation
    • ⚠️ Remove support for insights on Radar.PaymentEvaluation
    • ⚠️ Add support for new value crypto_fingerprint on enums Radar.ValueList.item_type and Radar.ValueListCreateParams.item_type
    • Add support for stripe_balance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
    • ⚠️ Add support for new value resolved on enum SharedPayment.GrantedToken.deactivated_reason
    • Add support for recurring_interval on SharedPayment.GrantedToken.usage_limits
    • ⚠️ Change type of SharedPayment.GrantedToken.usage_limits.expires_at from DateTime to DateTime | null
    • Add support for presentment_details on Subscription
    • ⚠️ Add support for new value canceled_by_retention_policy on enum Subscription.cancellation_details.reason
    • Add support for new value 2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_version
    • ⚠️ Remove support for invoice_resources on V2.Billing.Intent
    • ⚠️ Remove support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
    • Add support for recurring_credit_grant on V2.Billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[], V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[]
    • Add support for consumer_privacy_disclosures and consumer_storer 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_service
    • ⚠️ Remove support for include on V2.Billing.IntentCreateParams and V2.Billing.IntentReserveParams
    • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
  • #2607 Update generated code for private-preview
    • Add support for new resource V2.Core.AccountEvaluation
    • ⚠️ Remove support for resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponents
    • Add support for create method on resource V2.Core.AccountEvaluation
    • ⚠️ Remove support for retrieve method on resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponents
    • Add support for modify_rates method on resource V2.Billing.RateCard
    • Add support for remove_discounts method on resource V2.Billing.PricingPlanSubscription
    • ⚠️ Add support for new value eg_bank_account on enum V2.Account.configuration.recipient_data.default_outbound_destination.type
    • Add support for invoice_resources on V2.Billing.Intent
    • Add support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
    • Add support for expires_at on V2.Billing.Intent.status_transitions
    • Add support for discount on V2.Billing.IntentAction.apply and V2.Billing.IntentCreateParams.actions[].apply
    • Add support for timestamp on V2.Billing.IntentAction.apply.effective_at and V2.Billing.IntentCreateParams.actions[].apply.effective_at
    • ⚠️ Add support for new values current_billing_period_start and timestamp on enums V2.Billing.IntentAction.apply.effective_at.type and V2.Billing.IntentCreateParams.actions[].apply.effective_at.type
    • ⚠️ Add support for new value discount on enums V2.Billing.IntentAction.apply.type and V2.Billing.IntentCreateParams.actions[].apply.type
    • ⚠️ Change type of V2.Billing.IntentAction.deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentCreateParams.actions[].deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type from literal('license_fee') to enum('license_fee'|'recurring_credit_grant')
    • Add support for service_cycle on V2.Billing.LicenseFee and V2.Billing.RateCard
    • ⚠️ Remove support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
    • ⚠️ Remove support for service_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCard
    • ⚠️ Change type of V2.Billing.LicenseFee.transform_quantity.divide_by, V2.Billing.LicenseFeeCreateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeUpdateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeVersion.transform_quantity.divide_by, V2.Billing.RateCardRate.transform_quantity.divide_by, and V2.Billing.RateCardRateCreateParams.transform_quantity.divide_by from longInteger to int64_string
    • Add support for discount_details and pricing_plan_component_details on V2.Billing.PricingPlanSubscription
    • ⚠️ Add support for new value crypto_wallets on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • ⚠️ Remove support for value crypto from enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
    • Add support for balance_by_funds_type on V2.MoneyManagement.FinancialAccount.payments
    • ⚠️ Add support for new value next_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].type
    • Add support for treasury_transaction_entry on V2.MoneyManagement.TransactionEntry
    • Add support for treasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
    • ⚠️ Add support for new values treasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_other, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
    • Add support for treasury_transaction on V2.MoneyManagement.Transaction
    • ⚠️ Add support for new value no_valid_payment_method on enum V2.Payments.OffSessionPayment.failure_reason
    • Add support for metadata on V2.Payments.SettlementAllocationIntentSplit
    • ⚠️ Change type of V2.Reporting.ReportRun.result.file.size from longInteger to int64_string
    • Add support for statement_descriptor on V2.MoneyManagement.OutboundPaymentCreateParams and V2.MoneyManagement.OutboundTransferCreateParams
    • Add support for include on V2.Billing.IntentCreateParams, V2.Billing.IntentReserveParams, V2.Billing.PricingPlanSubscriptionListParams, V2.Billing.PricingPlanSubscriptionRetrieveParams, V2.MoneyManagement.FinancialAccountListParams, and V2.MoneyManagement.FinancialAccountRetrieveParams
    • Add support for event notifications V1AccountSignalsIncludingDelinquencyCreatedEvent, V2CoreAccountSignalsFraudulentWebsiteReadyEvent, and V2SignalsAccountSignalFraudulentMerchantReadyEvent
  • #2613 Merge to private-preview

See the changelog for more details.

Check out latest releases or
releases around stripe/stripe-node v21.1.0-alpha.1

Don't miss a new stripe-node release

NewReleases is sending notifications on new releases.

Get notifications