stripe/stripe-ruby v19.0.0

on GitHub

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.