stripe 15.0.0 → 15.3.0

data/rbi/stripe/services/payment_method_service.rbi

@@ -51,21 +51,11 @@ module Stripe
          }
         def initialize(account_number: nil, institution_number: nil, transit_number: nil); end
       end
-      class Affirm < Stripe::RequestParams
-
-      end
-      class AfterpayClearpay < Stripe::RequestParams
-
-      end
-      class Alipay < Stripe::RequestParams
-
-      end
-      class Alma < Stripe::RequestParams
-
-      end
-      class AmazonPay < Stripe::RequestParams
-
-      end
+      class Affirm < Stripe::RequestParams; end
+      class AfterpayClearpay < Stripe::RequestParams; end
+      class Alipay < Stripe::RequestParams; end
+      class Alma < Stripe::RequestParams; end
+      class AmazonPay < Stripe::RequestParams; end
       class AuBecsDebit < Stripe::RequestParams
         # The account number for the bank account.
         sig { returns(String) }
@@ -86,12 +76,8 @@ module Stripe
         sig { params(account_number: T.nilable(String), sort_code: T.nilable(String)).void }
         def initialize(account_number: nil, sort_code: nil); end
       end
-      class Bancontact < Stripe::RequestParams
-
-      end
-      class Billie < Stripe::RequestParams
-
-      end
+      class Bancontact < Stripe::RequestParams; end
+      class Billie < Stripe::RequestParams; end
       class BillingDetails < Stripe::RequestParams
         class Address < Stripe::RequestParams
           # City, district, suburb, town, or village.
@@ -138,14 +124,15 @@ module Stripe
         # Billing phone number (including extension).
         sig { returns(T.nilable(T.nilable(String))) }
         attr_accessor :phone
+        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :tax_id
         sig {
-          params(address: T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::CreateParams::BillingDetails::Address))), email: T.nilable(T.nilable(String)), name: T.nilable(T.nilable(String)), phone: T.nilable(T.nilable(String))).void
+          params(address: T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::CreateParams::BillingDetails::Address))), email: T.nilable(T.nilable(String)), name: T.nilable(T.nilable(String)), phone: T.nilable(T.nilable(String)), tax_id: T.nilable(String)).void
          }
-        def initialize(address: nil, email: nil, name: nil, phone: nil); end
-      end
-      class Blik < Stripe::RequestParams
-
+        def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil); end
       end
+      class Blik < Stripe::RequestParams; end
       class Boleto < Stripe::RequestParams
         # The tax ID of the customer (CPF for individual consumers or CNPJ for businesses consumers)
         sig { returns(String) }
@@ -191,12 +178,9 @@ module Stripe
           token: nil
         ); end
       end
-      class Cashapp < Stripe::RequestParams
-
-      end
-      class CustomerBalance < Stripe::RequestParams
-
-      end
+      class Cashapp < Stripe::RequestParams; end
+      class Crypto < Stripe::RequestParams; end
+      class CustomerBalance < Stripe::RequestParams; end
       class Eps < Stripe::RequestParams
         # The customer's bank.
         sig { returns(T.nilable(String)) }
@@ -214,12 +198,8 @@ module Stripe
         sig { params(account_holder_type: T.nilable(String), bank: String).void }
         def initialize(account_holder_type: nil, bank: nil); end
       end
-      class Giropay < Stripe::RequestParams
-
-      end
-      class Grabpay < Stripe::RequestParams
-
-      end
+      class Giropay < Stripe::RequestParams; end
+      class Grabpay < Stripe::RequestParams; end
       class Ideal < Stripe::RequestParams
         # The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
         sig { returns(T.nilable(String)) }
@@ -227,12 +207,8 @@ module Stripe
         sig { params(bank: T.nilable(String)).void }
         def initialize(bank: nil); end
       end
-      class InteracPresent < Stripe::RequestParams
-
-      end
-      class KakaoPay < Stripe::RequestParams
-
-      end
+      class InteracPresent < Stripe::RequestParams; end
+      class KakaoPay < Stripe::RequestParams; end
       class Klarna < Stripe::RequestParams
         class Dob < Stripe::RequestParams
           # The day of birth, between 1 and 31.
@@ -255,21 +231,11 @@ module Stripe
          }
         def initialize(dob: nil); end
       end
-      class Konbini < Stripe::RequestParams
-
-      end
-      class KrCard < Stripe::RequestParams
-
-      end
-      class Link < Stripe::RequestParams
-
-      end
-      class Mobilepay < Stripe::RequestParams
-
-      end
-      class Multibanco < Stripe::RequestParams
-
-      end
+      class Konbini < Stripe::RequestParams; end
+      class KrCard < Stripe::RequestParams; end
+      class Link < Stripe::RequestParams; end
+      class Mobilepay < Stripe::RequestParams; end
+      class Multibanco < Stripe::RequestParams; end
       class NaverPay < Stripe::RequestParams
         # Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
         sig { returns(T.nilable(String)) }
@@ -308,9 +274,7 @@ module Stripe
           suffix: nil
         ); end
       end
-      class Oxxo < Stripe::RequestParams
-
-      end
+      class Oxxo < Stripe::RequestParams; end
       class P24 < Stripe::RequestParams
         # The customer's bank.
         sig { returns(T.nilable(String)) }
@@ -318,24 +282,12 @@ module Stripe
         sig { params(bank: T.nilable(String)).void }
         def initialize(bank: nil); end
       end
-      class PayByBank < Stripe::RequestParams
-
-      end
-      class Payco < Stripe::RequestParams
-
-      end
-      class Paynow < Stripe::RequestParams
-
-      end
-      class Paypal < Stripe::RequestParams
-
-      end
-      class Pix < Stripe::RequestParams
-
-      end
-      class Promptpay < Stripe::RequestParams
-
-      end
+      class PayByBank < Stripe::RequestParams; end
+      class Payco < Stripe::RequestParams; end
+      class Paynow < Stripe::RequestParams; end
+      class Paypal < Stripe::RequestParams; end
+      class Pix < Stripe::RequestParams; end
+      class Promptpay < Stripe::RequestParams; end
       class RadarOptions < Stripe::RequestParams
         # A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
         sig { returns(T.nilable(String)) }
@@ -343,15 +295,9 @@ module Stripe
         sig { params(session: T.nilable(String)).void }
         def initialize(session: nil); end
       end
-      class RevolutPay < Stripe::RequestParams
-
-      end
-      class SamsungPay < Stripe::RequestParams
-
-      end
-      class Satispay < Stripe::RequestParams
-
-      end
+      class RevolutPay < Stripe::RequestParams; end
+      class SamsungPay < Stripe::RequestParams; end
+      class Satispay < Stripe::RequestParams; end
       class SepaDebit < Stripe::RequestParams
         # IBAN of the bank account.
         sig { returns(String) }
@@ -366,12 +312,8 @@ module Stripe
         sig { params(country: String).void }
         def initialize(country: nil); end
       end
-      class Swish < Stripe::RequestParams
-
-      end
-      class Twint < Stripe::RequestParams
-
-      end
+      class Swish < Stripe::RequestParams; end
+      class Twint < Stripe::RequestParams; end
       class UsBankAccount < Stripe::RequestParams
         # Account holder type: individual or company.
         sig { returns(T.nilable(String)) }
@@ -399,12 +341,8 @@ module Stripe
           routing_number: nil
         ); end
       end
-      class WechatPay < Stripe::RequestParams
-
-      end
-      class Zip < Stripe::RequestParams
-
-      end
+      class WechatPay < Stripe::RequestParams; end
+      class Zip < Stripe::RequestParams; end
       # If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::AcssDebit)) }
       attr_accessor :acss_debit
@@ -435,7 +373,7 @@ module Stripe
       # If this is a `bancontact` PaymentMethod, this hash contains details about the Bancontact payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Bancontact)) }
       attr_accessor :bancontact
-      # If this is a `billie` PaymentMethod, this hash contains details about the billie payment method.
+      # If this is a `billie` PaymentMethod, this hash contains details about the Billie payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Billie)) }
       attr_accessor :billie
       # Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
@@ -453,6 +391,9 @@ module Stripe
       # If this is a `cashapp` PaymentMethod, this hash contains details about the Cash App Pay payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Cashapp)) }
       attr_accessor :cashapp
+      # If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
+      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Crypto)) }
+      attr_accessor :crypto
       # The `Customer` to whom the original PaymentMethod is attached.
       sig { returns(T.nilable(String)) }
       attr_accessor :customer
@@ -540,13 +481,13 @@ module Stripe
       # Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::RadarOptions)) }
       attr_accessor :radar_options
-      # If this is a `Revolut Pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
+      # If this is a `revolut_pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::RevolutPay)) }
       attr_accessor :revolut_pay
       # If this is a `samsung_pay` PaymentMethod, this hash contains details about the SamsungPay payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::SamsungPay)) }
       attr_accessor :samsung_pay
-      # If this is a `satispay` PaymentMethod, this hash contains details about the satispay payment method.
+      # If this is a `satispay` PaymentMethod, this hash contains details about the Satispay payment method.
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Satispay)) }
       attr_accessor :satispay
       # If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
@@ -574,7 +515,7 @@ module Stripe
       sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Zip)) }
       attr_accessor :zip
       sig {
-        params(acss_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::AcssDebit), affirm: T.nilable(::Stripe::PaymentMethodService::CreateParams::Affirm), afterpay_clearpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::AfterpayClearpay), alipay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Alipay), allow_redisplay: T.nilable(String), alma: T.nilable(::Stripe::PaymentMethodService::CreateParams::Alma), amazon_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::AmazonPay), au_becs_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::AuBecsDebit), bacs_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::BacsDebit), bancontact: T.nilable(::Stripe::PaymentMethodService::CreateParams::Bancontact), billie: T.nilable(::Stripe::PaymentMethodService::CreateParams::Billie), billing_details: T.nilable(::Stripe::PaymentMethodService::CreateParams::BillingDetails), blik: T.nilable(::Stripe::PaymentMethodService::CreateParams::Blik), boleto: T.nilable(::Stripe::PaymentMethodService::CreateParams::Boleto), card: T.nilable(::Stripe::PaymentMethodService::CreateParams::Card), cashapp: T.nilable(::Stripe::PaymentMethodService::CreateParams::Cashapp), customer: T.nilable(String), customer_balance: T.nilable(::Stripe::PaymentMethodService::CreateParams::CustomerBalance), eps: T.nilable(::Stripe::PaymentMethodService::CreateParams::Eps), expand: T.nilable(T::Array[String]), fpx: T.nilable(::Stripe::PaymentMethodService::CreateParams::Fpx), giropay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Giropay), grabpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Grabpay), ideal: T.nilable(::Stripe::PaymentMethodService::CreateParams::Ideal), interac_present: T.nilable(::Stripe::PaymentMethodService::CreateParams::InteracPresent), kakao_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::KakaoPay), klarna: T.nilable(::Stripe::PaymentMethodService::CreateParams::Klarna), konbini: T.nilable(::Stripe::PaymentMethodService::CreateParams::Konbini), kr_card: T.nilable(::Stripe::PaymentMethodService::CreateParams::KrCard), link: T.nilable(::Stripe::PaymentMethodService::CreateParams::Link), metadata: T.nilable(T::Hash[String, String]), mobilepay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Mobilepay), multibanco: T.nilable(::Stripe::PaymentMethodService::CreateParams::Multibanco), naver_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::NaverPay), nz_bank_account: T.nilable(::Stripe::PaymentMethodService::CreateParams::NzBankAccount), oxxo: T.nilable(::Stripe::PaymentMethodService::CreateParams::Oxxo), p24: T.nilable(::Stripe::PaymentMethodService::CreateParams::P24), pay_by_bank: T.nilable(::Stripe::PaymentMethodService::CreateParams::PayByBank), payco: T.nilable(::Stripe::PaymentMethodService::CreateParams::Payco), payment_method: T.nilable(String), paynow: T.nilable(::Stripe::PaymentMethodService::CreateParams::Paynow), paypal: T.nilable(::Stripe::PaymentMethodService::CreateParams::Paypal), pix: T.nilable(::Stripe::PaymentMethodService::CreateParams::Pix), promptpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Promptpay), radar_options: T.nilable(::Stripe::PaymentMethodService::CreateParams::RadarOptions), revolut_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::RevolutPay), samsung_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::SamsungPay), satispay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Satispay), sepa_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::SepaDebit), sofort: T.nilable(::Stripe::PaymentMethodService::CreateParams::Sofort), swish: T.nilable(::Stripe::PaymentMethodService::CreateParams::Swish), twint: T.nilable(::Stripe::PaymentMethodService::CreateParams::Twint), type: T.nilable(String), us_bank_account: T.nilable(::Stripe::PaymentMethodService::CreateParams::UsBankAccount), wechat_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::WechatPay), zip: T.nilable(::Stripe::PaymentMethodService::CreateParams::Zip)).void
+        params(acss_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::AcssDebit), affirm: T.nilable(::Stripe::PaymentMethodService::CreateParams::Affirm), afterpay_clearpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::AfterpayClearpay), alipay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Alipay), allow_redisplay: T.nilable(String), alma: T.nilable(::Stripe::PaymentMethodService::CreateParams::Alma), amazon_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::AmazonPay), au_becs_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::AuBecsDebit), bacs_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::BacsDebit), bancontact: T.nilable(::Stripe::PaymentMethodService::CreateParams::Bancontact), billie: T.nilable(::Stripe::PaymentMethodService::CreateParams::Billie), billing_details: T.nilable(::Stripe::PaymentMethodService::CreateParams::BillingDetails), blik: T.nilable(::Stripe::PaymentMethodService::CreateParams::Blik), boleto: T.nilable(::Stripe::PaymentMethodService::CreateParams::Boleto), card: T.nilable(::Stripe::PaymentMethodService::CreateParams::Card), cashapp: T.nilable(::Stripe::PaymentMethodService::CreateParams::Cashapp), crypto: T.nilable(::Stripe::PaymentMethodService::CreateParams::Crypto), customer: T.nilable(String), customer_balance: T.nilable(::Stripe::PaymentMethodService::CreateParams::CustomerBalance), eps: T.nilable(::Stripe::PaymentMethodService::CreateParams::Eps), expand: T.nilable(T::Array[String]), fpx: T.nilable(::Stripe::PaymentMethodService::CreateParams::Fpx), giropay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Giropay), grabpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Grabpay), ideal: T.nilable(::Stripe::PaymentMethodService::CreateParams::Ideal), interac_present: T.nilable(::Stripe::PaymentMethodService::CreateParams::InteracPresent), kakao_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::KakaoPay), klarna: T.nilable(::Stripe::PaymentMethodService::CreateParams::Klarna), konbini: T.nilable(::Stripe::PaymentMethodService::CreateParams::Konbini), kr_card: T.nilable(::Stripe::PaymentMethodService::CreateParams::KrCard), link: T.nilable(::Stripe::PaymentMethodService::CreateParams::Link), metadata: T.nilable(T::Hash[String, String]), mobilepay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Mobilepay), multibanco: T.nilable(::Stripe::PaymentMethodService::CreateParams::Multibanco), naver_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::NaverPay), nz_bank_account: T.nilable(::Stripe::PaymentMethodService::CreateParams::NzBankAccount), oxxo: T.nilable(::Stripe::PaymentMethodService::CreateParams::Oxxo), p24: T.nilable(::Stripe::PaymentMethodService::CreateParams::P24), pay_by_bank: T.nilable(::Stripe::PaymentMethodService::CreateParams::PayByBank), payco: T.nilable(::Stripe::PaymentMethodService::CreateParams::Payco), payment_method: T.nilable(String), paynow: T.nilable(::Stripe::PaymentMethodService::CreateParams::Paynow), paypal: T.nilable(::Stripe::PaymentMethodService::CreateParams::Paypal), pix: T.nilable(::Stripe::PaymentMethodService::CreateParams::Pix), promptpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Promptpay), radar_options: T.nilable(::Stripe::PaymentMethodService::CreateParams::RadarOptions), revolut_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::RevolutPay), samsung_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::SamsungPay), satispay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Satispay), sepa_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::SepaDebit), sofort: T.nilable(::Stripe::PaymentMethodService::CreateParams::Sofort), swish: T.nilable(::Stripe::PaymentMethodService::CreateParams::Swish), twint: T.nilable(::Stripe::PaymentMethodService::CreateParams::Twint), type: T.nilable(String), us_bank_account: T.nilable(::Stripe::PaymentMethodService::CreateParams::UsBankAccount), wechat_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::WechatPay), zip: T.nilable(::Stripe::PaymentMethodService::CreateParams::Zip)).void
        }
       def initialize(
         acss_debit: nil,
@@ -593,6 +534,7 @@ module Stripe
         boleto: nil,
         card: nil,
         cashapp: nil,
+        crypto: nil,
         customer: nil,
         customer_balance: nil,
         eps: nil,
@@ -689,10 +631,13 @@ module Stripe
         # Billing phone number (including extension).
         sig { returns(T.nilable(T.nilable(String))) }
         attr_accessor :phone
+        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :tax_id
         sig {
-          params(address: T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::UpdateParams::BillingDetails::Address))), email: T.nilable(T.nilable(String)), name: T.nilable(T.nilable(String)), phone: T.nilable(T.nilable(String))).void
+          params(address: T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::UpdateParams::BillingDetails::Address))), email: T.nilable(T.nilable(String)), name: T.nilable(T.nilable(String)), phone: T.nilable(T.nilable(String)), tax_id: T.nilable(String)).void
          }
-        def initialize(address: nil, email: nil, name: nil, phone: nil); end
+        def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil); end
       end
       class Card < Stripe::RequestParams
         class Networks < Stripe::RequestParams
@@ -716,12 +661,8 @@ module Stripe
          }
         def initialize(exp_month: nil, exp_year: nil, networks: nil); end
       end
-      class Link < Stripe::RequestParams
-
-      end
-      class PayByBank < Stripe::RequestParams
-
-      end
+      class Link < Stripe::RequestParams; end
+      class PayByBank < Stripe::RequestParams; end
       class UsBankAccount < Stripe::RequestParams
         # Bank account holder type.
         sig { returns(T.nilable(String)) }
@@ -789,25 +730,25 @@ module Stripe
     end
     # Attaches a PaymentMethod object to a Customer.
     #
-    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
-    # or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
+    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
+    # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
     # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
     # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
     # future use, which makes later declines and payment friction more likely.
-    # See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
+    # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
     # future payments.
     #
     # To use this PaymentMethod as the default for invoice or subscription payments,
-    # set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
+    # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
     # on the Customer to the PaymentMethod's ID.
     sig {
       params(payment_method: String, params: T.any(::Stripe::PaymentMethodService::AttachParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
      }
     def attach(payment_method, params = {}, opts = {}); end
 
-    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
+    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://docs.stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
     #
-    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
+    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://docs.stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
     sig {
       params(params: T.any(::Stripe::PaymentMethodService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
      }
@@ -819,13 +760,13 @@ module Stripe
      }
     def detach(payment_method, params = {}, opts = {}); end
 
-    # Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer_list) API instead.
+    # Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead.
     sig {
       params(params: T.any(::Stripe::PaymentMethodService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
      }
     def list(params = {}, opts = {}); end
 
-    # Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer)
+    # Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer)
     sig {
       params(payment_method: String, params: T.any(::Stripe::PaymentMethodService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
      }

data/rbi/stripe/services/payout_service.rbi

@@ -166,11 +166,11 @@ module Stripe
      }
     def 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::PayoutService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Payout)
      }

data/rbi/stripe/services/plan_service.rbi

@@ -4,9 +4,7 @@
 # typed: true
 module Stripe
   class PlanService < StripeService
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
       sig { returns(T.nilable(T::Array[String])) }
@@ -251,7 +249,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::PlanService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Plan)
      }

data/rbi/stripe/services/price_service.rbi

@@ -516,7 +516,7 @@ module Stripe
      }
     def 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::PriceService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
      }
@@ -528,7 +528,7 @@ module Stripe
      }
     def retrieve(price, params = {}, opts = {}); end
 
-    # Search for prices you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for prices you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.

data/rbi/stripe/services/product_feature_service.rbi

@@ -4,9 +4,7 @@
 # typed: true
 module Stripe
   class ProductFeatureService < StripeService
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
       sig { returns(T.nilable(T::Array[String])) }

data/rbi/stripe/services/product_service.rbi

@@ -5,9 +5,7 @@
 module Stripe
   class ProductService < StripeService
     attr_reader :features
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
       sig { returns(T.nilable(T::Array[String])) }
@@ -461,7 +459,7 @@ module Stripe
      }
     def retrieve(id, params = {}, opts = {}); end
 
-    # Search for products you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for products you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.

data/rbi/stripe/services/promotion_code_service.rbi

@@ -199,7 +199,7 @@ module Stripe
      }
     def list(params = {}, opts = {}); end
 
-    # Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://stripe.com/docs/api/promotion_codes/list) with the desired code.
+    # Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://docs.stripe.com/docs/api/promotion_codes/list) with the desired code.
     sig {
       params(promotion_code: String, params: T.any(::Stripe::PromotionCodeService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PromotionCode)
      }

data/rbi/stripe/services/quote_service.rbi

@@ -199,10 +199,22 @@ 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::QuoteService::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.
@@ -212,9 +224,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::QuoteService::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,
@@ -488,7 +501,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/services/radar/early_fraud_warning_service.rbi

@@ -75,7 +75,7 @@ module Stripe
 
       # Retrieves the details of an early fraud warning that has previously been created.
       #
-      # Please refer to the [early fraud warning](https://stripe.com/docs/api#early_fraud_warning_object) object reference for more details.
+      # Please refer to the [early fraud warning](https://docs.stripe.com/api#early_fraud_warning_object) object reference for more details.
       sig {
         params(early_fraud_warning: String, params: T.any(::Stripe::Radar::EarlyFraudWarningService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Radar::EarlyFraudWarning)
        }

data/rbi/stripe/services/radar/value_list_item_service.rbi

@@ -5,9 +5,7 @@
 module Stripe
   module Radar
     class ValueListItemService < StripeService
-      class DeleteParams < Stripe::RequestParams
-
-      end
+      class DeleteParams < Stripe::RequestParams; end
       class RetrieveParams < Stripe::RequestParams
         # Specifies which fields in the response should be expanded.
         sig { returns(T.nilable(T::Array[String])) }

data/rbi/stripe/services/radar/value_list_service.rbi

@@ -5,9 +5,7 @@
 module Stripe
   module Radar
     class ValueListService < StripeService
-      class DeleteParams < Stripe::RequestParams
-
-      end
+      class DeleteParams < Stripe::RequestParams; end
       class RetrieveParams < Stripe::RequestParams
         # Specifies which fields in the response should be expanded.
         sig { returns(T.nilable(T::Array[String])) }