stripe 15.0.0 → 15.3.0

data/rbi/stripe/resources/balance.rbi

@@ -155,6 +155,58 @@ module Stripe
       sig { returns(SourceTypes) }
       attr_reader :source_types
     end
+    class RefundAndDisputePrefunding < Stripe::StripeObject
+      class Available < Stripe::StripeObject
+        class SourceTypes < Stripe::StripeObject
+          # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
+          sig { returns(Integer) }
+          attr_reader :bank_account
+          # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
+          sig { returns(Integer) }
+          attr_reader :card
+          # Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
+          sig { returns(Integer) }
+          attr_reader :fpx
+        end
+        # Balance amount.
+        sig { returns(Integer) }
+        attr_reader :amount
+        # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+        sig { returns(String) }
+        attr_reader :currency
+        # Attribute for field source_types
+        sig { returns(SourceTypes) }
+        attr_reader :source_types
+      end
+      class Pending < Stripe::StripeObject
+        class SourceTypes < Stripe::StripeObject
+          # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
+          sig { returns(Integer) }
+          attr_reader :bank_account
+          # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
+          sig { returns(Integer) }
+          attr_reader :card
+          # Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
+          sig { returns(Integer) }
+          attr_reader :fpx
+        end
+        # Balance amount.
+        sig { returns(Integer) }
+        attr_reader :amount
+        # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+        sig { returns(String) }
+        attr_reader :currency
+        # Attribute for field source_types
+        sig { returns(SourceTypes) }
+        attr_reader :source_types
+      end
+      # Funds that are available for use.
+      sig { returns(T::Array[Available]) }
+      attr_reader :available
+      # Funds that are pending
+      sig { returns(T::Array[Pending]) }
+      attr_reader :pending
+    end
     # Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://stripe.com/docs/api#transfers) or [Payouts API](https://stripe.com/docs/api#payouts). You can find the available balance for each currency and payment type in the `source_types` property.
     sig { returns(T::Array[Available]) }
     attr_reader :available
@@ -176,5 +228,8 @@ module Stripe
     # Funds that aren't available in the balance yet. You can find the pending balance for each currency and each payment type in the `source_types` property.
     sig { returns(T::Array[Pending]) }
     attr_reader :pending
+    # Attribute for field refund_and_dispute_prefunding
+    sig { returns(RefundAndDisputePrefunding) }
+    attr_reader :refund_and_dispute_prefunding
   end
 end

data/rbi/stripe/resources/balance_transaction.rbi

@@ -31,6 +31,9 @@ module Stripe
     # The date that the transaction's net funds become available in the Stripe balance.
     sig { returns(Integer) }
     attr_reader :available_on
+    # The balance that this transaction impacts.
+    sig { returns(String) }
+    attr_reader :balance_type
     # Time at which the object was created. Measured in seconds since the Unix epoch.
     sig { returns(Integer) }
     attr_reader :created

data/rbi/stripe/resources/bank_account.rbi

@@ -5,11 +5,11 @@
 module Stripe
   # These bank accounts are payment methods on `Customer` objects.
   #
-  # On the other hand [External Accounts](https://stripe.com/api#external_accounts) are transfer
+  # On the other hand [External Accounts](https://docs.stripe.com/api#external_accounts) are transfer
   # destinations on `Account` objects for connected accounts.
   # They can be bank accounts or debit cards as well, and are documented in the links above.
   #
-  # Related guide: [Bank debits and transfers](https://stripe.com/payments/bank-debits-transfers)
+  # Related guide: [Bank debits and transfers](https://docs.stripe.com/payments/bank-debits-transfers)
   class BankAccount < APIResource
     class FutureRequirements < Stripe::StripeObject
       class Error < Stripe::StripeObject

data/rbi/stripe/resources/billing/alert.rbi

@@ -101,13 +101,13 @@ module Stripe
           sig { returns(Integer) }
           attr_accessor :gte
           # The [Billing Meter](/api/billing/meter) ID whose usage is monitored.
-          sig { returns(T.nilable(String)) }
+          sig { returns(String) }
           attr_accessor :meter
           # Whether the alert should only fire only once, or once per billing cycle.
           sig { returns(String) }
           attr_accessor :recurrence
           sig {
-            params(filters: T.nilable(T::Array[::Stripe::Billing::Alert::CreateParams::UsageThreshold::Filter]), gte: Integer, meter: T.nilable(String), recurrence: String).void
+            params(filters: T.nilable(T::Array[::Stripe::Billing::Alert::CreateParams::UsageThreshold::Filter]), gte: Integer, meter: String, recurrence: String).void
            }
           def initialize(filters: nil, gte: nil, meter: nil, recurrence: nil); end
         end

data/rbi/stripe/resources/billing_portal/session.rbi

@@ -17,7 +17,7 @@ module Stripe
     # Create sessions on-demand when customers intend to manage their subscriptions
     # and billing details.
     #
-    # Related guide: [Customer management](https://stripe.com/customer-management)
+    # Related guide: [Customer management](https://docs.stripe.com/customer-management)
     class Session < APIResource
       class Flow < Stripe::StripeObject
         class AfterCompletion < Stripe::StripeObject
@@ -87,7 +87,7 @@ module Stripe
             sig { returns(Integer) }
             attr_reader :quantity
           end
-          # The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
+          # The coupon or promotion code to apply to this subscription update.
           sig { returns(T.nilable(T::Array[Discount])) }
           attr_reader :discounts
           # The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
@@ -249,7 +249,7 @@ module Stripe
                }
               def initialize(id: nil, price: nil, quantity: nil); end
             end
-            # The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
+            # The coupon or promotion code to apply to this subscription update.
             sig {
               returns(T.nilable(T::Array[::Stripe::BillingPortal::Session::CreateParams::FlowData::SubscriptionUpdateConfirm::Discount]))
              }

data/rbi/stripe/resources/capability.rbi

@@ -75,7 +75,7 @@ module Stripe
       # Fields that are due and can be satisfied by providing the corresponding alternative fields instead.
       sig { returns(T.nilable(T::Array[Alternative])) }
       attr_reader :alternatives
-      # Date by which the fields in `currently_due` must be collected to keep the capability enabled for the account. These fields may disable the capability sooner if the next threshold is reached before they are collected.
+      # The date by which all required account information must be both submitted and verified. This includes fields listed in `currently_due` as well as those in `pending_verification`. If any required information is missing or unverified by this date, the account may be disabled. Note that `current_deadline` may change if additional `currently_due` requirements are requested.
       sig { returns(T.nilable(Integer)) }
       attr_reader :current_deadline
       # Fields that need to be collected to keep the capability enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the capability is disabled.

data/rbi/stripe/resources/charge.rbi

@@ -41,6 +41,9 @@ module Stripe
       # Billing phone number (including extension).
       sig { returns(T.nilable(String)) }
       attr_reader :phone
+      # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+      sig { returns(T.nilable(String)) }
+      attr_reader :tax_id
     end
     class FraudDetails < Stripe::StripeObject
       # Assessments from Stripe. If set, the value is `fraudulent`.
@@ -189,6 +192,12 @@ module Stripe
         attr_reader :transit_number
       end
       class Affirm < Stripe::StripeObject
+        # ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+        sig { returns(String) }
+        attr_reader :location
+        # ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+        sig { returns(String) }
+        attr_reader :reader
         # The Affirm transaction ID associated with this payment.
         sig { returns(T.nilable(String)) }
         attr_reader :transaction_id
@@ -344,7 +353,7 @@ module Stripe
             # One of `month`.
             sig { returns(T.nilable(String)) }
             attr_reader :interval
-            # Type of installment plan, one of `fixed_count`.
+            # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
             sig { returns(String) }
             attr_reader :type
           end
@@ -587,7 +596,7 @@ module Stripe
         # Attribute for field incremental_authorization
         sig { returns(IncrementalAuthorization) }
         attr_reader :incremental_authorization
-        # Installment details for this payment (Mexico only).
+        # Installment details for this payment.
         #
         # For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
         sig { returns(T.nilable(Installments)) }
@@ -642,10 +651,10 @@ module Stripe
           # The type of account being debited or credited
           sig { returns(String) }
           attr_reader :account_type
-          # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+          # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
           sig { returns(T.nilable(String)) }
           attr_reader :application_cryptogram
-          # Mnenomic of the Application Identifier.
+          # The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
           sig { returns(T.nilable(String)) }
           attr_reader :application_preferred_name
           # Identifier for this transaction.
@@ -657,13 +666,13 @@ module Stripe
           # Describes the method used by the cardholder to verify ownership of the card. One of the following: `approval`, `failure`, `none`, `offline_pin`, `offline_pin_and_signature`, `online_pin`, or `signature`.
           sig { returns(T.nilable(String)) }
           attr_reader :cardholder_verification_method
-          # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+          # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
           sig { returns(T.nilable(String)) }
           attr_reader :dedicated_file_name
-          # The outcome of a series of EMV functions performed by the card reader.
+          # A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
           sig { returns(T.nilable(String)) }
           attr_reader :terminal_verification_results
-          # An indication of various EMV functions performed during the transaction.
+          # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
           sig { returns(T.nilable(String)) }
           attr_reader :transaction_status_information
         end
@@ -737,7 +746,7 @@ module Stripe
         # Defines whether the authorized amount can be over-captured or not
         sig { returns(T::Boolean) }
         attr_reader :overcapture_supported
-        # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+        # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :preferred_locales
         # How card details were read in this transaction.
@@ -758,6 +767,20 @@ module Stripe
         sig { returns(T.nilable(String)) }
         attr_reader :cashtag
       end
+      class Crypto < Stripe::StripeObject
+        # The wallet address of the customer.
+        sig { returns(String) }
+        attr_reader :buyer_address
+        # The blockchain network that the transaction was sent on.
+        sig { returns(String) }
+        attr_reader :network
+        # The token currency that the transaction was sent with.
+        sig { returns(String) }
+        attr_reader :token_currency
+        # The blockchain transaction hash of the crypto payment.
+        sig { returns(String) }
+        attr_reader :transaction_hash
+      end
       class CustomerBalance < Stripe::StripeObject; end
       class Eps < Stripe::StripeObject
         # The customer's bank. Should be one of `arzte_und_apotheker_bank`, `austrian_anadi_bank_ag`, `bank_austria`, `bankhaus_carl_spangler`, `bankhaus_schelhammer_und_schattera_ag`, `bawag_psk_ag`, `bks_bank_ag`, `brull_kallmus_bank_ag`, `btv_vier_lander_bank`, `capital_bank_grawe_gruppe_ag`, `deutsche_bank_ag`, `dolomitenbank`, `easybank_ag`, `erste_bank_und_sparkassen`, `hypo_alpeadriabank_international_ag`, `hypo_noe_lb_fur_niederosterreich_u_wien`, `hypo_oberosterreich_salzburg_steiermark`, `hypo_tirol_bank_ag`, `hypo_vorarlberg_bank_ag`, `hypo_bank_burgenland_aktiengesellschaft`, `marchfelder_bank`, `oberbank_ag`, `raiffeisen_bankengruppe_osterreich`, `schoellerbank_ag`, `sparda_bank_wien`, `volksbank_gruppe`, `volkskreditbank_ag`, or `vr_bank_braunau`.
@@ -802,7 +825,7 @@ module Stripe
         attr_reader :transaction_id
       end
       class Ideal < Stripe::StripeObject
-        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
         sig { returns(T.nilable(String)) }
         attr_reader :bank
         # The Bank Identifier Code of the customer's bank.
@@ -827,10 +850,10 @@ module Stripe
           # The type of account being debited or credited
           sig { returns(String) }
           attr_reader :account_type
-          # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+          # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
           sig { returns(T.nilable(String)) }
           attr_reader :application_cryptogram
-          # Mnenomic of the Application Identifier.
+          # The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
           sig { returns(T.nilable(String)) }
           attr_reader :application_preferred_name
           # Identifier for this transaction.
@@ -842,13 +865,13 @@ module Stripe
           # Describes the method used by the cardholder to verify ownership of the card. One of the following: `approval`, `failure`, `none`, `offline_pin`, `offline_pin_and_signature`, `online_pin`, or `signature`.
           sig { returns(T.nilable(String)) }
           attr_reader :cardholder_verification_method
-          # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+          # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
           sig { returns(T.nilable(String)) }
           attr_reader :dedicated_file_name
-          # The outcome of a series of EMV functions performed by the card reader.
+          # A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
           sig { returns(T.nilable(String)) }
           attr_reader :terminal_verification_results
-          # An indication of various EMV functions performed during the transaction.
+          # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
           sig { returns(T.nilable(String)) }
           attr_reader :transaction_status_information
         end
@@ -899,7 +922,7 @@ module Stripe
         # This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
         sig { returns(T.nilable(String)) }
         attr_reader :network_transaction_id
-        # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+        # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :preferred_locales
         # How card details were read in this transaction.
@@ -1233,6 +1256,12 @@ module Stripe
         # Uniquely identifies this particular WeChat Pay account. You can use this attribute to check whether two WeChat accounts are the same.
         sig { returns(T.nilable(String)) }
         attr_reader :fingerprint
+        # ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+        sig { returns(String) }
+        attr_reader :location
+        # ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+        sig { returns(String) }
+        attr_reader :reader
         # Transaction ID of this particular WeChat Pay transaction.
         sig { returns(T.nilable(String)) }
         attr_reader :transaction_id
@@ -1289,6 +1318,9 @@ module Stripe
       # Attribute for field cashapp
       sig { returns(Cashapp) }
       attr_reader :cashapp
+      # Attribute for field crypto
+      sig { returns(Crypto) }
+      attr_reader :crypto
       # Attribute for field customer_balance
       sig { returns(CustomerBalance) }
       attr_reader :customer_balance
@@ -2003,9 +2035,9 @@ module Stripe
     end
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     sig {
       params(params: T.any(::Stripe::Charge::CaptureParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Charge)
      }
@@ -2013,15 +2045,15 @@ module Stripe
 
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     sig {
       params(charge: String, params: T.any(::Stripe::Charge::CaptureParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Charge)
      }
     def self.capture(charge, params = {}, opts = {}); end
 
-    # This method is no longer recommended—use the [Payment Intents API](https://stripe.com/docs/api/payment_intents)
+    # This method is no longer recommended—use the [Payment Intents API](https://docs.stripe.com/docs/api/payment_intents)
     # to initiate a new payment instead. Confirmation of the PaymentIntent creates the Charge
     # object used to request payment.
     sig {