stripe 15.0.0 → 15.3.0

data/rbi/stripe/resources/payment_method_domain.rbi

@@ -47,6 +47,19 @@ module Stripe
       sig { returns(StatusDetails) }
       attr_reader :status_details
     end
+    class Klarna < Stripe::StripeObject
+      class StatusDetails < Stripe::StripeObject
+        # The error message associated with the status of the payment method on the domain.
+        sig { returns(String) }
+        attr_reader :error_message
+      end
+      # The status of the payment method on the domain.
+      sig { returns(String) }
+      attr_reader :status
+      # Contains additional details about the status of a payment method for a specific payment method domain.
+      sig { returns(StatusDetails) }
+      attr_reader :status_details
+    end
     class Link < Stripe::StripeObject
       class StatusDetails < Stripe::StripeObject
         # The error message associated with the status of the payment method on the domain.
@@ -95,6 +108,9 @@ module Stripe
     sig { returns(String) }
     attr_reader :id
     # Indicates the status of a specific payment method on a payment method domain.
+    sig { returns(Klarna) }
+    attr_reader :klarna
+    # Indicates the status of a specific payment method on a payment method domain.
     sig { returns(Link) }
     attr_reader :link
     # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
@@ -192,7 +208,7 @@ module Stripe
     #
     # To activate a payment method on an existing payment method domain, complete the required registration steps specific to the payment method, and then validate the payment method domain with this endpoint.
     #
-    # Related guides: [Payment method domains](https://stripe.com/docs/payments/payment-methods/pmd-registration).
+    # Related guides: [Payment method domains](https://docs.stripe.com/docs/payments/payment-methods/pmd-registration).
     sig {
       params(params: T.any(::Stripe::PaymentMethodDomain::ValidateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethodDomain)
      }
@@ -203,7 +219,7 @@ module Stripe
     #
     # To activate a payment method on an existing payment method domain, complete the required registration steps specific to the payment method, and then validate the payment method domain with this endpoint.
     #
-    # Related guides: [Payment method domains](https://stripe.com/docs/payments/payment-methods/pmd-registration).
+    # Related guides: [Payment method domains](https://docs.stripe.com/docs/payments/payment-methods/pmd-registration).
     sig {
       params(payment_method_domain: String, params: T.any(::Stripe::PaymentMethodDomain::ValidateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethodDomain)
      }

data/rbi/stripe/resources/payout.rbi

@@ -5,9 +5,9 @@
 module Stripe
   # A `Payout` object is created when you receive funds from Stripe, or when you
   # initiate a payout to either a bank account or debit card of a [connected
-  # Stripe account](https://stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
+  # Stripe account](https://docs.stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
   # and list all payouts. Payouts are made on [varying
-  # schedules](https://stripe.com/docs/connect/manage-payout-schedule), depending on your country and
+  # schedules](https://docs.stripe.com/docs/connect/manage-payout-schedule), depending on your country and
   # industry.
   #
   # Related guide: [Receiving payouts](https://stripe.com/docs/payouts)
@@ -259,11 +259,11 @@ module Stripe
      }
     def self.cancel(payout, params = {}, opts = {}); end
 
-    # To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://stripe.com/docs/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
+    # To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://docs.stripe.com/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
     #
     # If your API key is in test mode, money won't actually be sent, though every other action occurs as if you're in live mode.
     #
-    # If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://stripe.com/docs/api#balance_object) details available and pending amounts by source type.
+    # If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://docs.stripe.com/api#balance_object) details available and pending amounts by source type.
     sig {
       params(params: T.any(::Stripe::Payout::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Payout)
      }

data/rbi/stripe/resources/person.rbi

@@ -5,9 +5,9 @@
 module Stripe
   # This is an object representing a person associated with a Stripe account.
   #
-  # A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
+  # A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
   #
-  # See the [Standard onboarding](https://stripe.com/connect/standard-accounts) or [Express onboarding](https://stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://stripe.com/connect/handling-api-verification#person-information).
+  # See the [Standard onboarding](https://docs.stripe.com/connect/standard-accounts) or [Express onboarding](https://docs.stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://docs.stripe.com/connect/handling-api-verification#person-information).
   class Person < APIResource
     class AdditionalTosAcceptances < Stripe::StripeObject
       class Account < Stripe::StripeObject
@@ -226,6 +226,33 @@ module Stripe
       sig { returns(T::Array[String]) }
       attr_reader :pending_verification
     end
+    class UsCfpbData < Stripe::StripeObject
+      class EthnicityDetails < Stripe::StripeObject
+        # The persons ethnicity
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :ethnicity
+        # Please specify your origin, when other is selected.
+        sig { returns(T.nilable(String)) }
+        attr_reader :ethnicity_other
+      end
+      class RaceDetails < Stripe::StripeObject
+        # The persons race.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :race
+        # Please specify your race, when other is selected.
+        sig { returns(T.nilable(String)) }
+        attr_reader :race_other
+      end
+      # The persons ethnicity details
+      sig { returns(T.nilable(EthnicityDetails)) }
+      attr_reader :ethnicity_details
+      # The persons race details
+      sig { returns(T.nilable(RaceDetails)) }
+      attr_reader :race_details
+      # The persons self-identified gender
+      sig { returns(T.nilable(String)) }
+      attr_reader :self_identified_gender
+    end
     class Verification < Stripe::StripeObject
       class AdditionalDocument < Stripe::StripeObject
         # The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`.
@@ -267,7 +294,7 @@ module Stripe
       # Attribute for field document
       sig { returns(Document) }
       attr_reader :document
-      # The state of verification for the person. Possible values are `unverified`, `pending`, or `verified`.
+      # The state of verification for the person. Possible values are `unverified`, `pending`, or `verified`. Please refer [guide](https://stripe.com/docs/connect/handling-api-verification) to handle verification updates.
       sig { returns(String) }
       attr_reader :status
     end
@@ -361,6 +388,9 @@ module Stripe
     # Whether the last four digits of the person's Social Security number have been provided (U.S. only).
     sig { returns(T::Boolean) }
     attr_reader :ssn_last_4_provided
+    # Demographic data related to the person.
+    sig { returns(T.nilable(UsCfpbData)) }
+    attr_reader :us_cfpb_data
     # Attribute for field verification
     sig { returns(Verification) }
     attr_reader :verification

data/rbi/stripe/resources/plan.rbi

@@ -100,9 +100,7 @@ module Stripe
     # Always true for a deleted object
     sig { returns(T::Boolean) }
     attr_reader :deleted
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class UpdateParams < Stripe::RequestParams
       # Whether the plan is currently available for new subscriptions.
       sig { returns(T.nilable(T::Boolean)) }
@@ -340,7 +338,7 @@ module Stripe
         usage_type: nil
       ); end
     end
-    # You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
+    # You can now model subscriptions more flexibly using the [Prices API](https://docs.stripe.com/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
     sig {
       params(params: T.any(::Stripe::Plan::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Plan)
      }

data/rbi/stripe/resources/price.rbi

@@ -669,7 +669,7 @@ module Stripe
      }
     def self.create(params = {}, opts = {}); end
 
-    # Returns a list of your active prices, excluding [inline prices](https://stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
+    # Returns a list of your active prices, excluding [inline prices](https://docs.stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
     sig {
       params(params: T.any(::Stripe::Price::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
      }

data/rbi/stripe/resources/product.rbi

@@ -91,9 +91,7 @@ module Stripe
     # Always true for a deleted object
     sig { returns(T::Boolean) }
     attr_reader :deleted
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class UpdateParams < Stripe::RequestParams
       class MarketingFeature < Stripe::RequestParams
         # The marketing feature name. Up to 80 characters long.

data/rbi/stripe/resources/quote.rbi

@@ -21,6 +21,9 @@ module Stripe
       # The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
       sig { returns(T.nilable(Liability)) }
       attr_reader :liability
+      # The tax provider powering automatic tax.
+      sig { returns(T.nilable(String)) }
+      attr_reader :provider
       # The status of the most recent automated tax calculation for this quote.
       sig { returns(T.nilable(String)) }
       attr_reader :status
@@ -198,6 +201,14 @@ module Stripe
       attr_reader :finalized_at
     end
     class SubscriptionData < Stripe::StripeObject
+      class BillingMode < Stripe::StripeObject
+        # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+        sig { returns(String) }
+        attr_reader :type
+      end
+      # The billing mode of the quote.
+      sig { returns(BillingMode) }
+      attr_reader :billing_mode
       # The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
       sig { returns(T.nilable(String)) }
       attr_reader :description
@@ -567,10 +578,20 @@ module Stripe
         ); end
       end
       class SubscriptionData < Stripe::RequestParams
+        class BillingMode < Stripe::RequestParams
+          # Attribute for param field type
+          sig { returns(String) }
+          attr_accessor :type
+          sig { params(type: String).void }
+          def initialize(type: nil); end
+        end
+        # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+        sig { returns(T.nilable(::Stripe::Quote::CreateParams::SubscriptionData::BillingMode)) }
+        attr_accessor :billing_mode
         # The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
         sig { returns(T.nilable(String)) }
         attr_accessor :description
-        # When creating a new subscription, the date of which the subscription schedule will start after the quote is accepted. When updating a subscription, the date of which the subscription will be updated using a subscription schedule. The special value `current_period_end` can be provided to update a subscription at the end of its current period. The `effective_date` is ignored if it is in the past when the quote is accepted.
+        # When creating a new subscription, the date of which the subscription schedule will start after the quote is accepted. The `effective_date` is ignored if it is in the past when the quote is accepted.
         sig { returns(T.nilable(T.nilable(T.any(String, T.any(String, Integer))))) }
         attr_accessor :effective_date
         # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
@@ -580,9 +601,10 @@ module Stripe
         sig { returns(T.nilable(T.nilable(T.any(String, Integer)))) }
         attr_accessor :trial_period_days
         sig {
-          params(description: T.nilable(String), effective_date: T.nilable(T.nilable(T.any(String, T.any(String, Integer)))), metadata: T.nilable(T::Hash[String, String]), trial_period_days: T.nilable(T.nilable(T.any(String, Integer)))).void
+          params(billing_mode: T.nilable(::Stripe::Quote::CreateParams::SubscriptionData::BillingMode), description: T.nilable(String), effective_date: T.nilable(T.nilable(T.any(String, T.any(String, Integer)))), metadata: T.nilable(T::Hash[String, String]), trial_period_days: T.nilable(T.nilable(T.any(String, Integer)))).void
          }
         def initialize(
+          billing_mode: nil,
           description: nil,
           effective_date: nil,
           metadata: nil,
@@ -847,7 +869,7 @@ module Stripe
         # The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
         sig { returns(T.nilable(T.nilable(String))) }
         attr_accessor :description
-        # When creating a new subscription, the date of which the subscription schedule will start after the quote is accepted. When updating a subscription, the date of which the subscription will be updated using a subscription schedule. The special value `current_period_end` can be provided to update a subscription at the end of its current period. The `effective_date` is ignored if it is in the past when the quote is accepted.
+        # When creating a new subscription, the date of which the subscription schedule will start after the quote is accepted. The `effective_date` is ignored if it is in the past when the quote is accepted.
         sig { returns(T.nilable(T.nilable(T.any(String, T.any(String, Integer))))) }
         attr_accessor :effective_date
         # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.

data/rbi/stripe/resources/radar/value_list.rbi

@@ -41,9 +41,7 @@ module Stripe
       # Always true for a deleted object
       sig { returns(T::Boolean) }
       attr_reader :deleted
-      class DeleteParams < Stripe::RequestParams
-
-      end
+      class DeleteParams < Stripe::RequestParams; end
       class UpdateParams < Stripe::RequestParams
         # The name of the value list for use in rules.
         sig { returns(T.nilable(String)) }

data/rbi/stripe/resources/radar/value_list_item.rbi

@@ -32,9 +32,7 @@ module Stripe
       # Always true for a deleted object
       sig { returns(T::Boolean) }
       attr_reader :deleted
-      class DeleteParams < Stripe::RequestParams
-
-      end
+      class DeleteParams < Stripe::RequestParams; end
       class ListParams < Stripe::RequestParams
         class Created < Stripe::RequestParams
           # Minimum value to filter by (exclusive)

data/rbi/stripe/resources/refund.rbi

@@ -105,7 +105,11 @@ module Stripe
         attr_reader :reference_status
       end
       class Paynow < Stripe::StripeObject; end
-      class Paypal < Stripe::StripeObject; end
+      class Paypal < Stripe::StripeObject
+        # For refunds declined by the network, a decline code provided by the network which indicates the reason the refund failed.
+        sig { returns(T.nilable(String)) }
+        attr_reader :network_decline_code
+      end
       class Pix < Stripe::StripeObject; end
       class Revolut < Stripe::StripeObject; end
       class Sofort < Stripe::StripeObject; end
@@ -315,6 +319,9 @@ module Stripe
     # ID of the PaymentIntent that's refunded.
     sig { returns(T.nilable(T.any(String, Stripe::PaymentIntent))) }
     attr_reader :payment_intent
+    # Provides the reason for why the refund is pending. Possible values are: `processing`, `insufficient_funds`, or `charge_pending`.
+    sig { returns(String) }
+    attr_reader :pending_reason
     # Attribute for field presentment_details
     sig { returns(PresentmentDetails) }
     attr_reader :presentment_details

data/rbi/stripe/resources/reversal.rbi

@@ -9,7 +9,7 @@ module Stripe
   # platform's balance and subtract from the destination account's balance.
   #
   # Reversing a transfer that was made for a [destination
-  # charge](https://stripe.com/docs/connect/destination-charges) is allowed only up to the amount of
+  # charge](https://docs.stripe.com/docs/connect/destination-charges) is allowed only up to the amount of
   # the charge. It is possible to reverse a
   # [transfer_group](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options)
   # transfer only if the destination account has enough balance to cover the

data/rbi/stripe/resources/review.rbi

@@ -5,7 +5,7 @@
 module Stripe
   # Reviews can be used to supplement automated fraud detection with human expertise.
   #
-  # Learn more about [Radar](https://stripe.com/radar) and reviewing payments
+  # Learn more about [Radar](https://docs.stripe.com/radar) and reviewing payments
   # [here](https://stripe.com/docs/radar/reviews).
   class Review < APIResource
     class IpAddressLocation < Stripe::StripeObject

data/rbi/stripe/resources/setup_attempt.rbi

@@ -154,7 +154,7 @@ module Stripe
       end
       class Cashapp < Stripe::StripeObject; 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.