• #1843 Update generated code for private-preview
  • Add support for new resources SharedPayment::IssuedToken and V2::Data::Reporting::QueryRun
  • Add support for create and retrieve methods on resource V2::Data::Reporting::QueryRun
  • Add support for pause and resume methods on resource V2::Payments::OffSessionPayment
  • Add support for tenant_keys, tenant_operator, and tenant_values on Billing::BillingMeterMeterEventSummaryListParams
  • Add support for money_services on ChargeCaptureParams::PaymentDetail, ChargeUpdateParams::PaymentDetail, PaymentIntentCaptureParams::PaymentDetail, PaymentIntentConfirmParams::PaymentDetail, PaymentIntentCreateParams::PaymentDetail, and PaymentIntentUpdateParams::PaymentDetail
  • Add support for payment_method_options on DelegatedCheckout::RequestedSessionCreateParams, DelegatedCheckout::RequestedSessionUpdateParams, and DelegatedCheckout::RequestedSession
  • ⚠️ Remove support for payment_method_data on DelegatedCheckout::RequestedSessionConfirmParams, DelegatedCheckout::RequestedSessionCreateParams, and DelegatedCheckout::RequestedSessionUpdateParams
  • Add support for card_brands and payment_method_types on DelegatedCheckout::RequestedSession::SellerDetail
  • Change type of DelegatedCheckout::RequestedSession.shared_payment_issued_token from string to expandable($SharedPayment.IssuedToken)
  • Add support for check_scan on Invoice::PaymentSetting::PaymentMethodOption, InvoiceCreateParams::PaymentSetting::PaymentMethodOption, InvoiceUpdateParams::PaymentSetting::PaymentMethodOption, QuotePreviewInvoice::PaymentSetting::PaymentMethodOption, Subscription::PaymentSetting::PaymentMethodOption, SubscriptionCreateParams::PaymentSetting::PaymentMethodOption, and SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption
  • Add support for processor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams::Failed, PaymentRecordReportPaymentAttemptParams::Guaranteed, PaymentRecordReportPaymentParams::Failed, and PaymentRecordReportPaymentParams::Guaranteed
  • Add support for payment_details on PaymentIntentConfirmParams::PaymentMethodOption::CardPresent, PaymentIntentConfirmParams::PaymentMethodOption::Card, PaymentIntentCreateParams::PaymentMethodOption::CardPresent, PaymentIntentCreateParams::PaymentMethodOption::Card, PaymentIntentUpdateParams::PaymentMethodOption::CardPresent, and PaymentIntentUpdateParams::PaymentMethodOption::Card
  • ⚠️ Remove support for bill_from on QuotePreviewSubscriptionSchedule::BillingSchedule, Subscription::BillingSchedule, and SubscriptionSchedule::BillingSchedule
  • Add support for agent_details, payment_method_details, and risk_details on SharedPayment::GrantedToken
  • Add support for paper_checks on V2::Account::Configuration::RecipientDatum::Feature, V2::AccountCreateParams::Configuration::RecipientDatum::Feature, V2::AccountUpdateParams::Configuration::RecipientDatum::Feature, V2::Core::Account::Configuration::Recipient::Capability, V2::Core::Account::Configuration::Storer::Capability::OutboundPayment, V2::Core::AccountCreateParams::Configuration::Recipient::Capability, V2::Core::AccountCreateParams::Configuration::Storer::Capability::OutboundPayment, V2::Core::AccountUpdateParams::Configuration::Recipient::Capability, and V2::Core::AccountUpdateParams::Configuration::Storer::Capability::OutboundPayment
  • ⚠️ Change type of V2::Billing::Cadence::SettingsDatum::Collection::PaymentMethodOption.konbini, V2::Billing::CollectionSetting::PaymentMethodOption.konbini, V2::Billing::CollectionSettingCreateParams::PaymentMethodOption.konbini, V2::Billing::CollectionSettingUpdateParams::PaymentMethodOption.konbini, and V2::Billing::CollectionSettingVersion::PaymentMethodOption.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2::Billing::Cadence::SettingsDatum::Collection::PaymentMethodOption.sepa_debit, V2::Billing::CollectionSetting::PaymentMethodOption.sepa_debit, V2::Billing::CollectionSettingCreateParams::PaymentMethodOption.sepa_debit, V2::Billing::CollectionSettingUpdateParams::PaymentMethodOption.sepa_debit, and V2::Billing::CollectionSettingVersion::PaymentMethodOption.sepa_debit from map(string: dynamic) to an object
  • Add support for id on V2::Billing::CadenceSpendModifier::MaxBillingPeriodSpend::Amount::CustomPricingUnit, V2::Billing::IntentAction::Apply::SpendModifierRule::MaxBillingPeriodSpend::Amount::CustomPricingUnit, and V2::Billing::IntentCreateParams::Action::Apply::SpendModifierRule::MaxBillingPeriodSpend::Amount::CustomPricingUnit
  • ⚠️ Change type of V2::Core::Event::Reason::Request::Client.stripe_action from map(string: dynamic) to an object
  • ⚠️ Change type of V2::MoneyManagement::InboundTransfer::TransferHistory.bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2::MoneyManagement::InboundTransfer::TransferHistory.bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2::MoneyManagement::InboundTransfer::TransferHistory.bank_debit_succeeded from map(string: dynamic) to an object
  • ⚠️ Remove support for town on V2::MoneyManagement::OutboundPayment::TrackingDetail::PaperCheck::MailingAddress
  • Change V2::MoneyManagement::OutboundPayment::DeliveryOption::PaperCheck.memo to be required
  • Add support for application_fee_amount_requested on V2::Payments::OffSessionPayment
  • ⚠️ Remove support for compartment_id on V2::Payments::OffSessionPayment
  • Add support for retry_until on V2::Payments::OffSessionPayment::RetryDetail
  • ⚠️ Change V2::Reporting::ReportRun::Result.file to be optional
  • Add support for application_fee_amount on V2::Payments::OffSessionPaymentCaptureParams and V2::Payments::OffSessionPaymentCreateParams
  • Add support for alert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEvent
  • Add support for api_key on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEvent
  • Add support for stripe_access_grant on EventsV2IamStripeAccessGrantApprovedEvent, EventsV2IamStripeAccessGrantCanceledEvent, EventsV2IamStripeAccessGrantDeniedEvent, EventsV2IamStripeAccessGrantRemovedEvent, EventsV2IamStripeAccessGrantRequestedEvent, and EventsV2IamStripeAccessGrantUpdatedEvent
  • Add support for event notifications V2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object V2::Data::Reporting::QueryRun
  • Add support for event notifications V2PaymentsOffSessionPaymentPausedEvent and V2PaymentsOffSessionPaymentResumedEvent with related object V2::Payments::OffSessionPayment

See the changelog for more details.

• #1840 Update generated code for beta
  • Fix "Unable to resolve constant" sorbet errors for Params classes

See the changelog for more details.

• #1839 Update generated code for private-preview
  • Fix "Unable to resolve constant" sorbet errors for Params classes

See the changelog for more details.

This release changes the pinned API version to 2026-03-25.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.

• #1833 Update generated code for beta
• #1832 Update generated code for beta
  • Release specs are identical.
• #1801 Update generated code for beta
  • Add support for new resources ProductCatalog::TrialOffer, Tax::Location, and V2::Core::BatchJob
  • Add support for create method on resource ProductCatalog::TrialOffer
  • Add support for create, list, and retrieve methods on resource Tax::Location
  • Add support for cancel, create, and retrieve methods on resource V2::Core::BatchJob
  • Add support for performance_location on Tax::CalculationCreateParams::LineItem and Tax::CalculationLineItem
  • Add support for trial_offer on InvoiceCreatePreviewParams::ScheduleDetail::Amendment::ItemAction::Add, InvoiceCreatePreviewParams::ScheduleDetail::Amendment::ItemAction::Set, InvoiceCreatePreviewParams::ScheduleDetail::Phase::Item, QuoteCreateParams::Line::Action::AddItem, QuoteCreateParams::Line::Action::SetItem, QuoteLine::Action::AddItem, QuoteLine::Action::SetItem, QuotePreviewSubscriptionSchedule::Phase::Item, QuoteUpdateParams::Line::Action::AddItem, QuoteUpdateParams::Line::Action::SetItem, SubscriptionSchedule::Phase::Item, SubscriptionScheduleAmendParams::Amendment::ItemAction::Add, SubscriptionScheduleAmendParams::Amendment::ItemAction::Set, SubscriptionScheduleCreateParams::Phase::Item, and SubscriptionScheduleUpdateParams::Phase::Item
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for source_type on Charge::PaymentMethodDetail::StripeBalance, ConfirmationToken::PaymentMethodPreview::StripeBalance, ConfirmationTokenCreateParams::PaymentMethodDatum::StripeBalance, PaymentAttemptRecord::PaymentMethodDetail::StripeBalance, PaymentIntentConfirmParams::PaymentMethodDatum::StripeBalance, PaymentIntentCreateParams::PaymentMethodDatum::StripeBalance, PaymentIntentUpdateParams::PaymentMethodDatum::StripeBalance, PaymentMethod::StripeBalance, PaymentMethodCreateParams::StripeBalance, PaymentRecord::PaymentMethodDetail::StripeBalance, SetupIntentConfirmParams::PaymentMethodDatum::StripeBalance, SetupIntentCreateParams::PaymentMethodDatum::StripeBalance, and SetupIntentUpdateParams::PaymentMethodDatum::StripeBalance
  • Add support for tax_details on Checkout::SessionCreateParams::LineItem::PriceDatum::ProductDatum, Checkout::SessionUpdateParams::LineItem::PriceDatum::ProductDatum, InvoiceAddLinesParams::Line::PriceDatum::ProductDatum, InvoiceLineItemUpdateParams::PriceDatum::ProductDatum, InvoiceUpdateLinesParams::Line::PriceDatum::ProductDatum, PaymentLinkCreateParams::LineItem::PriceDatum::ProductDatum, PlanCreateParams::Product, PriceCreateParams::ProductDatum, ProductCreateParams, and ProductUpdateParams
  • Add support for pending_invoice_item_interval on Checkout::SessionUpdateParams::SubscriptionDatum
  • Add support for hosted and ui_mode on FinancialConnections::SessionCreateParams and FinancialConnections::Session
  • Add support for url on FinancialConnections::Session
  • Add support for expires_after_seconds on Invoice::PaymentSetting::PaymentMethodOption::Pix, InvoiceCreateParams::PaymentSetting::PaymentMethodOption::Pix, InvoiceUpdateParams::PaymentSetting::PaymentMethodOption::Pix, QuotePreviewInvoice::PaymentSetting::PaymentMethodOption::Pix, Subscription::PaymentSetting::PaymentMethodOption::Pix, SubscriptionCreateParams::PaymentSetting::PaymentMethodOption::Pix, and SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption::Pix
  • Add support for current_trial on InvoiceCreatePreviewParams::SubscriptionDetail::Item, SubscriptionCreateParams::Item, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams::Item
  • Add support for surcharge on PaymentIntent::AmountDetail, PaymentIntentCaptureParams::AmountDetail, PaymentIntentConfirmParams::AmountDetail, PaymentIntentCreateParams::AmountDetail, PaymentIntentIncrementAuthorizationParams::AmountDetail, and PaymentIntentUpdateParams::AmountDetail
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for mandate_options on PaymentIntent::PaymentMethodOption::StripeBalance
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripe_balance on SetupIntent::PaymentMethodOption, SetupIntentConfirmParams::PaymentMethodOption, SetupIntentCreateParams::PaymentMethodOption, and SetupIntentUpdateParams::PaymentMethodOption
  • Add support for billing_cycle_anchor on Subscription::TrialSetting::EndBehavior, SubscriptionCreateParams::TrialSetting::EndBehavior, and SubscriptionUpdateParams::TrialSetting::EndBehavior
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax::Registration::CountryOption::Me
  • Add support for requirements on TaxCode
  • ⚠️ Change type of V2::Billing::Cadence::SettingsDatum::Collection::PaymentMethodOption::Card::MandateOption.amount, V2::Billing::CollectionSetting::PaymentMethodOption::Card::MandateOption.amount, V2::Billing::CollectionSettingCreateParams::PaymentMethodOption::Card::MandateOption.amount, V2::Billing::CollectionSettingUpdateParams::PaymentMethodOption::Card::MandateOption.amount, and V2::Billing::CollectionSettingVersion::PaymentMethodOption::Card::MandateOption.amount from longInteger to int64_string
  • Add support for timezone on V2::Core::Account::Default, V2::Core::AccountCreateParams::Default, and V2::Core::AccountUpdateParams::Default
  • Add support for azure_event_grid on V2::Core::EventDestinationCreateParams and V2::Core::EventDestination
  • Add support for supported_currencies on V2::Core::Vault::GbBankAccount, V2::Core::Vault::UsBankAccount, and V2::MoneyManagement::PayoutMethod::Card
  • ⚠️ Change V2::Core::Vault::GbBankAccount.sort_code and V2::Core::Vault::GbBankAccountCreateParams.sort_code to be optional
  • Add support for restricted on V2::MoneyManagement::PayoutMethod
  • Add support for currencies on V2::MoneyManagement::PayoutMethodsBankAccountSpec::Country::Field
  • Add support for counterparty and description on V2::MoneyManagement::Transaction
  • ⚠️ Add support for currency on V2::Core::Vault::GbBankAccountCreateParams, V2::Core::Vault::UsBankAccountCreateParams, V2::MoneyManagement::OutboundSetupIntentCreateParams::PayoutMethodDatum::BankAccount, V2::MoneyManagement::OutboundSetupIntentCreateParams::PayoutMethodDatum::Card, V2::MoneyManagement::OutboundSetupIntentUpdateParams::PayoutMethodDatum::BankAccount, and V2::MoneyManagement::OutboundSetupIntentUpdateParams::PayoutMethodDatum::Card
  • Add support for iban on V2::Core::Vault::GbBankAccountCreateParams
  • Change V2::Core::Vault::GbBankAccountCreateParams.account_number to be optional
  • Add support for event notifications V2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object V2::Core::BatchJob
• #1826 Merge to beta
• #1809 Merge to beta

See the changelog for more details.

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

• #1836 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for financial_account_rewards and nesting_demo on AccountSession::Component
  • Add support for upi_payments on Account::Capability, AccountCreateParams::Capability, and AccountUpdateParams::Capability
  • Add support for risk_signals on Account
  • Add support for fraud_intent on AccountSignals
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for billable_items on Billing::Alert::SpendThreshold::Filter
  • Add support for upi on Charge::PaymentMethodDetail, Checkout::Session::PaymentMethodOption, Checkout::SessionCreateParams::PaymentMethodOption, ConfirmationToken::PaymentMethodPreview, ConfirmationTokenCreateParams::PaymentMethodDatum, Mandate::PaymentMethodDetail, PaymentAttemptRecord::PaymentMethodDetail, PaymentIntent::PaymentMethodOption, PaymentIntentConfirmParams::PaymentMethodDatum, PaymentIntentConfirmParams::PaymentMethodOption, PaymentIntentCreateParams::PaymentMethodDatum, PaymentIntentCreateParams::PaymentMethodOption, PaymentIntentUpdateParams::PaymentMethodDatum, PaymentIntentUpdateParams::PaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord::PaymentMethodDetail, SetupAttempt::PaymentMethodDetail, SetupIntent::PaymentMethodOption, SetupIntentConfirmParams::PaymentMethodDatum, SetupIntentConfirmParams::PaymentMethodOption, SetupIntentCreateParams::PaymentMethodDatum, SetupIntentCreateParams::PaymentMethodOption, SetupIntentUpdateParams::PaymentMethodDatum, and SetupIntentUpdateParams::PaymentMethodOption
  • ⚠️ Remove support for source_type on Charge::PaymentMethodDetail::StripeBalance, ConfirmationToken::PaymentMethodPreview::StripeBalance, ConfirmationTokenCreateParams::PaymentMethodDatum::StripeBalance, PaymentAttemptRecord::PaymentMethodDetail::StripeBalance, PaymentIntentConfirmParams::PaymentMethodDatum::StripeBalance, PaymentIntentCreateParams::PaymentMethodDatum::StripeBalance, PaymentIntentUpdateParams::PaymentMethodDatum::StripeBalance, PaymentMethod::StripeBalance, PaymentMethodCreateParams::StripeBalance, PaymentRecord::PaymentMethodDetail::StripeBalance, SetupIntentConfirmParams::PaymentMethodDatum::StripeBalance, SetupIntentCreateParams::PaymentMethodDatum::StripeBalance, and SetupIntentUpdateParams::PaymentMethodDatum::StripeBalance
  • Add support for integration_identifier on Checkout::SessionCreateParams and Checkout::Session
  • Change type of Checkout::SessionCreateParams::LineItem::PriceDatum::ProductDatum::TaxDetail.tax_code, Checkout::SessionUpdateParams::LineItem::PriceDatum::ProductDatum::TaxDetail.tax_code, InvoiceAddLinesParams::Line::PriceDatum::ProductDatum::TaxDetail.tax_code, InvoiceLineItemUpdateParams::PriceDatum::ProductDatum::TaxDetail.tax_code, InvoiceUpdateLinesParams::Line::PriceDatum::ProductDatum::TaxDetail.tax_code, PaymentLinkCreateParams::LineItem::PriceDatum::ProductDatum::TaxDetail.tax_code, PlanCreateParams::Product::TaxDetail.tax_code, PriceCreateParams::ProductDatum::TaxDetail.tax_code, ProductCreateParams::TaxDetail.tax_code, and ProductUpdateParams::TaxDetail.tax_code from string to emptyable(string)
  • Add support for crypto on Checkout::SessionCreateParams::PaymentMethodOption
  • Add support for pending_invoice_item_interval on Checkout::SessionCreateParams::SubscriptionDatum and Checkout::SessionUpdateParams::SubscriptionDatum
  • Change Checkout::SessionCreateParams::LineItem::PriceDatum::ProductDatum::TaxDetail.tax_code, Checkout::SessionUpdateParams::LineItem::PriceDatum::ProductDatum::TaxDetail.tax_code, InvoiceAddLinesParams::Line::PriceDatum::ProductDatum::TaxDetail.tax_code, InvoiceLineItemUpdateParams::PriceDatum::ProductDatum::TaxDetail.tax_code, InvoiceUpdateLinesParams::Line::PriceDatum::ProductDatum::TaxDetail.tax_code, PaymentLinkCreateParams::LineItem::PriceDatum::ProductDatum::TaxDetail.tax_code, PlanCreateParams::Product::TaxDetail.tax_code, PriceCreateParams::ProductDatum::TaxDetail.tax_code, ProductCreateParams::TaxDetail.tax_code, and ProductUpdateParams::TaxDetail.tax_code to be optional
  • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout::Session::CurrentAttempt::PaymentMethodDetail
  • Add support for metadata on CreditNoteCreateParams::Line, CreditNoteLineItem, CreditNoteListPreviewLineItemsParams::Line, and CreditNotePreviewParams::Line
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout::RequestedSession::FulfillmentDetail
  • Add support for line_item_keys on DelegatedCheckout::RequestedSession::FulfillmentDetail::FulfillmentOption::Digital::DigitalOption and DelegatedCheckout::RequestedSession::FulfillmentDetail::FulfillmentOption::Shipping::ShippingOption
  • Add support for quantity_decimal on InvoiceAddLinesParams::Line, InvoiceCreatePreviewParams::InvoiceItem, InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams::Line
  • Add support for expires_after_seconds on Invoice::PaymentSetting::PaymentMethodOption::Pix, InvoiceCreateParams::PaymentSetting::PaymentMethodOption::Pix, InvoiceUpdateParams::PaymentSetting::PaymentMethodOption::Pix, QuotePreviewInvoice::PaymentSetting::PaymentMethodOption::Pix, Subscription::PaymentSetting::PaymentMethodOption::Pix, SubscriptionCreateParams::PaymentSetting::PaymentMethodOption::Pix, and SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption::Pix
  • ⚠️ Add support for level on Issuing::AuthorizationCreateParams::RiskAssessment::CardTestingRisk and Issuing::AuthorizationCreateParams::RiskAssessment::MerchantDisputeRisk
  • ⚠️ Remove support for risk_level on Issuing::AuthorizationCreateParams::RiskAssessment::CardTestingRisk and Issuing::AuthorizationCreateParams::RiskAssessment::MerchantDisputeRisk
  • Add support for lifecycle_controls on Issuing::CardCreateParams and Issuing::Card
  • ⚠️ Change type of Issuing::Token::NetworkDatum::Visa.card_reference_id from string to nullable(string)
  • ⚠️ Change type of PaymentAttemptRecord::PaymentMethodDetail::Card.brand and PaymentRecord::PaymentMethodDetail::Card.brand from enum to nullable(enum)
  • ⚠️ Change type of PaymentAttemptRecord::PaymentMethodDetail::Card.exp_month and PaymentRecord::PaymentMethodDetail::Card.exp_month from longInteger to nullable(longInteger)
  • ⚠️ Change type of PaymentAttemptRecord::PaymentMethodDetail::Card.exp_year and PaymentRecord::PaymentMethodDetail::Card.exp_year from longInteger to nullable(longInteger)
  • ⚠️ Change type of PaymentAttemptRecord::PaymentMethodDetail::Card.funding and PaymentRecord::PaymentMethodDetail::Card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))
  • ⚠️ Change type of PaymentAttemptRecord::PaymentMethodDetail::Card.last4 and PaymentRecord::PaymentMethodDetail::Card.last4 from string to nullable(string)
  • ⚠️ Change type of PaymentAttemptRecord::PaymentMethodDetail::Card.moto and PaymentRecord::PaymentMethodDetail::Card.moto from boolean to nullable(boolean)
  • Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord::PaymentMethodDetail::Card::ThreeDSecure and PaymentRecord::PaymentMethodDetail::Card::ThreeDSecure
  • Add support for surcharge on PaymentIntent::AmountDetail, PaymentIntentCaptureParams::AmountDetail, PaymentIntentConfirmParams::AmountDetail, PaymentIntentCreateParams::AmountDetail, PaymentIntentIncrementAuthorizationParams::AmountDetail, and PaymentIntentUpdateParams::AmountDetail
  • Add support for mandate_options on PaymentIntent::PaymentMethodOption::StripeBalance, PaymentIntentConfirmParams::PaymentMethodOption::StripeBalance, PaymentIntentCreateParams::PaymentMethodOption::StripeBalance, and PaymentIntentUpdateParams::PaymentMethodOption::StripeBalance
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent::NextAction and SetupIntent::NextAction
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for recommended_action and signals on Radar::PaymentEvaluation
  • ⚠️ Remove support for insights on Radar::PaymentEvaluation
  • Add support for stripe_balance on SetupIntent::PaymentMethodOption, SetupIntentConfirmParams::PaymentMethodOption, SetupIntentCreateParams::PaymentMethodOption, and SetupIntentUpdateParams::PaymentMethodOption
  • Add support for recurring_interval on SharedPayment::GrantedToken::UsageLimit
  • ⚠️ Change type of SharedPayment::GrantedToken::UsageLimit.expires_at from DateTime to nullable(DateTime)
  • Add support for presentment_details on Subscription
  • ⚠️ Remove support for invoice_resources on V2::Billing::Intent
  • ⚠️ Remove support for amount_due and customer_balance_applied on V2::Billing::Intent::AmountDetail
  • Add support for recurring_credit_grant on V2::Billing::IntentAction::Modify::PricingPlanSubscriptionDetail::Override::PartialPeriodBehavior, `V2::Billing::IntentAction::Subscribe::...

This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

• ⚠️ Breaking change: #1829 Add decimal_string coercion for v1 and v2 API fields
  • All decimal_string fields changed type from String to BigDecimal in both request params and response objects. Code that reads or writes these fields as String will need to use BigDecimal instead. Affected fields across v1 and v2 APIs:
    • Checkout::Session: fx_rate
    • Climate::Order: metric_tons; Climate::Product: metric_tons_available
    • CreditNoteLineItem: unit_amount_decimal
    • InvoiceItem: quantity_decimal, unit_amount_decimal
    • InvoiceLineItem: quantity_decimal, unit_amount_decimal
    • Issuing::Authorization / Issuing::Transaction (and TestHelpers): quantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimal
    • Plan: amount_decimal, flat_amount_decimal, unit_amount_decimal
    • Price: unit_amount_decimal, flat_amount_decimal (including currency_options and tiers)
    • V2::Core::Account / V2::Core::AccountPerson: percent_ownership
    • Request params on Invoice, Product, Quote, Subscription, SubscriptionItem, SubscriptionSchedule, PaymentLink: unit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)
• ⚠️ Breaking change: #1828 ⚠️ Throw an error when using the wrong webhook parsing method
• ⚠️ Breaking change: #1823 ⚠️ Drop support for Ruby 2.6
• #1825 Require cgi/escape instead of cgi
• #1814 Add runtime support for V2 int64 string-encoded fields
• #1817 Remove AlipayAccount and RecipientTransfer resource files
  • ⚠️ Removes Stripe::AlipayAccount and Stripe::RecipientTransfer resource classes (dead code since v7.0.0)
• #1816 remove v2-specific guards for removing nils from request params
• #1824 Add gem dependency on logger

See the changelog for more details.

• #1818 Update generated code for private-preview
  • Add support for simulate_crypto_deposit test helper method on resource PaymentIntent
  • Add support for deposit_options and mode on PaymentIntent::PaymentMethodOption::Crypto, PaymentIntentConfirmParams::PaymentMethodOption::Crypto, PaymentIntentCreateParams::PaymentMethodOption::Crypto, and PaymentIntentUpdateParams::PaymentMethodOption::Crypto
  • Add support for crypto_display_details on PaymentIntent::NextAction
• #1812 Update generated code for private-preview
  • Add support for new resources Orchestration::PaymentAttempt and Radar::CustomerEvaluation
  • Add support for retrieve method on resource Orchestration::PaymentAttempt
  • Add support for create and update methods on resource Radar::CustomerEvaluation
  • Add support for approve method on resource Checkout::Session
  • Add support for report_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecord
  • Add support for create_us_paper_check_on_application on AccountSessionCreateParams::Component::CheckScanning::Feature
  • ⚠️ Change AccountSignals.delinquency to be optional
  • Add support for approval_method on Checkout::SessionCreateParams and Checkout::Session
  • Add support for current_attempt on Checkout::Session
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout::RequestedSessionUpdateParams::FulfillmentDetail
  • Add support for pricing_plan_subscription_details on InvoiceItem::Parent and InvoiceLineItem::Parent
  • ⚠️ Remove support for license_fee_subscription_details on InvoiceItem::Parent and InvoiceLineItem::Parent
  • ⚠️ Remove support for pricing_plan_subscription and pricing_plan_version on InvoiceItem::Parent::RateCardSubscriptionDetail and InvoiceLineItem::Parent::RateCardSubscriptionDetail
  • Add support for token_details on Issuing::Authorization
  • Add support for failure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParams::Failed, and PaymentRecordReportPaymentParams::Failed
  • Change PaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optional
  • Change PaymentRecordReportPaymentAttemptFailedParams.failed_at to be optional
  • Change PaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optional
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • ⚠️ Change Radar::IssuingAuthorizationEvaluationCreateParams::CardDetail.bin_country to be required
  • Add support for recurring_interval on SharedPayment::GrantedTokenCreateParams::UsageLimit
  • Change SharedPayment::GrantedTokenCreateParams::UsageLimit.expires_at to be optional
  • Add support for home_rule_tax on Tax::Registration::CountryOption::Me and Tax::RegistrationCreateParams::CountryOption::Me

See the changelog for more details.

• #1806 Update generated code for private-preview
  • Add support for new resource Radar::IssuingAuthorizationEvaluation
  • Add support for create method on resource Radar::IssuingAuthorizationEvaluation
  • ⚠️ Rename affiliate_attributions to affiliate_attribution on DelegatedCheckout::RequestedSessionConfirmParams and DelegatedCheckout::RequestedSessionCreateParams
  • Add support for amount_to_counter on Dispute
  • Add support for frozen_fields on InvoiceItem
  • Add support for consumer on V2::Core::Account::Configuration::CardCreator::Capability, V2::Core::Account::Identity::Attestation::TermsOfService::CardCreator, V2::Core::AccountCreateParams::Configuration::CardCreator::Capability, V2::Core::AccountCreateParams::Identity::Attestation::TermsOfService::CardCreator, V2::Core::AccountUpdateParams::Configuration::CardCreator::Capability, and V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService::CardCreator
  • Add support for fifth_third on V2::Core::Account::Configuration::CardCreator::Capability::Commercial, V2::Core::Account::Identity::Attestation::TermsOfService::CardCreator::Commercial, V2::Core::AccountCreateParams::Configuration::CardCreator::Capability::Commercial, V2::Core::AccountCreateParams::Identity::Attestation::TermsOfService::CardCreator::Commercial, V2::Core::AccountUpdateParams::Configuration::CardCreator::Capability::Commercial, and V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService::CardCreator::Commercial
  • Add support for prepaid_card on V2::Core::Account::Configuration::CardCreator::Capability::Commercial::CrossRiverBank, V2::Core::Account::Identity::Attestation::TermsOfService::CardCreator::Commercial::CrossRiverBank, V2::Core::AccountCreateParams::Configuration::CardCreator::Capability::Commercial::CrossRiverBank, V2::Core::AccountCreateParams::Identity::Attestation::TermsOfService::CardCreator::Commercial::CrossRiverBank, V2::Core::AccountUpdateParams::Configuration::CardCreator::Capability::Commercial::CrossRiverBank, and V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService::CardCreator::Commercial::CrossRiverBank
  • Add support for payment_method_data on V2::Payments::OffSessionPaymentCreateParams
  • Change V2::Payments::OffSessionPaymentCreateParams.payment_method to be optional

See the changelog for more details.

• #1811 Retry on Net::HTTPFatalError
  • Fixes a bug where Net::HTTPFatalError errors were being thrown and not retried (unlike other 5xx responses from the Stripe API)

See the changelog for more details.

• #1805 Add Stripe-Request-Trigger header
• #1803 Add agent information to UserAgent

See the changelog for more details.