stripe 15.0.0 → 15.3.0

data/lib/stripe/resources/payment_method_domain.rb

@@ -49,6 +49,17 @@ module Stripe
       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.
+        attr_reader :error_message
+      end
+      # The status of the payment method on the domain.
+      attr_reader :status
+      # Contains additional details about the status of a payment method for a specific payment method domain.
+      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.
@@ -152,6 +163,8 @@ module Stripe
     # Unique identifier for the object.
     attr_reader :id
     # Indicates the status of a specific payment method on a payment method domain.
+    attr_reader :klarna
+    # Indicates the status of a specific payment method on a payment method domain.
     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.
     attr_reader :livemode
@@ -195,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).
     def validate(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -210,7 +223,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).
     def self.validate(payment_method_domain, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/payout.rb

@@ -4,9 +4,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)
@@ -249,11 +249,11 @@ module Stripe
       )
     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.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/payouts", params: params, opts: opts)
     end

data/lib/stripe/resources/person.rb

@@ -4,9 +4,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
     include Stripe::APIOperations::Save
 
@@ -180,6 +180,28 @@ module Stripe
       attr_reader :pending_verification
     end
 
+    class UsCfpbData < Stripe::StripeObject
+      class EthnicityDetails < Stripe::StripeObject
+        # The persons ethnicity
+        attr_reader :ethnicity
+        # Please specify your origin, when other is selected.
+        attr_reader :ethnicity_other
+      end
+
+      class RaceDetails < Stripe::StripeObject
+        # The persons race.
+        attr_reader :race
+        # Please specify your race, when other is selected.
+        attr_reader :race_other
+      end
+      # The persons ethnicity details
+      attr_reader :ethnicity_details
+      # The persons race details
+      attr_reader :race_details
+      # The persons self-identified gender
+      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`.
@@ -210,7 +232,7 @@ module Stripe
       attr_reader :details_code
       # Attribute for field 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.
       attr_reader :status
     end
     # The account the person is associated with.
@@ -273,6 +295,8 @@ module Stripe
     attr_reader :requirements
     # Whether the last four digits of the person's Social Security number have been provided (U.S. only).
     attr_reader :ssn_last_4_provided
+    # Demographic data related to the person.
+    attr_reader :us_cfpb_data
     # Attribute for field verification
     attr_reader :verification
     # Always true for a deleted object

data/lib/stripe/resources/plan.rb

@@ -41,8 +41,7 @@ module Stripe
       attr_reader :round
     end
 
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class UpdateParams < Stripe::RequestParams
       # Whether the plan is currently available for new subscriptions.
@@ -323,7 +322,7 @@ module Stripe
     # Always true for a deleted object
     attr_reader :deleted
 
-    # 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.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/plans", params: params, opts: opts)
     end

data/lib/stripe/resources/price.rb

@@ -628,7 +628,7 @@ module Stripe
       request_stripe_object(method: :post, path: "/v1/prices", params: params, opts: 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.
     def self.list(params = {}, opts = {})
       request_stripe_object(method: :get, path: "/v1/prices", params: params, opts: opts)
     end

data/lib/stripe/resources/product.rb

@@ -41,8 +41,7 @@ module Stripe
       attr_reader :width
     end
 
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class UpdateParams < Stripe::RequestParams
       class MarketingFeature < Stripe::RequestParams

data/lib/stripe/resources/quote.rb

@@ -25,6 +25,8 @@ module Stripe
       attr_reader :enabled
       # 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.
       attr_reader :liability
+      # The tax provider powering automatic tax.
+      attr_reader :provider
       # The status of the most recent automated tax calculation for this quote.
       attr_reader :status
     end
@@ -165,6 +167,12 @@ module Stripe
     end
 
     class SubscriptionData < Stripe::StripeObject
+      class BillingMode < Stripe::StripeObject
+        # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+        attr_reader :type
+      end
+      # The billing mode of the quote.
+      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.
       attr_reader :description
       # When creating a new subscription, the date of which the subscription schedule will start after the quote is accepted. This date is ignored if it is in the past when the quote is accepted. Measured in seconds since the Unix epoch.
@@ -410,16 +418,33 @@ module Stripe
       end
 
       class SubscriptionData < Stripe::RequestParams
+        class BillingMode < Stripe::RequestParams
+          # Attribute for param field type
+          attr_accessor :type
+
+          def initialize(type: nil)
+            @type = type
+          end
+        end
+        # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+        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.
         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.
         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.
         attr_accessor :metadata
         # Integer representing the number of trial period days before the customer is charged for the first time.
         attr_accessor :trial_period_days
 
-        def initialize(description: nil, effective_date: nil, metadata: nil, trial_period_days: nil)
+        def initialize(
+          billing_mode: nil,
+          description: nil,
+          effective_date: nil,
+          metadata: nil,
+          trial_period_days: nil
+        )
+          @billing_mode = billing_mode
           @description = description
           @effective_date = effective_date
           @metadata = metadata
@@ -679,7 +704,7 @@ module Stripe
       class SubscriptionData < Stripe::RequestParams
         # 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.
         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.
         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.
         attr_accessor :metadata

data/lib/stripe/resources/radar/value_list.rb

@@ -17,8 +17,7 @@ module Stripe
         "radar.value_list"
       end
 
-      class DeleteParams < Stripe::RequestParams
-      end
+      class DeleteParams < Stripe::RequestParams; end
 
       class UpdateParams < Stripe::RequestParams
         # The name of the value list for use in rules.

data/lib/stripe/resources/radar/value_list_item.rb

@@ -16,8 +16,7 @@ module Stripe
         "radar.value_list_item"
       end
 
-      class DeleteParams < Stripe::RequestParams
-      end
+      class DeleteParams < Stripe::RequestParams; end
 
       class ListParams < Stripe::RequestParams
         class Created < Stripe::RequestParams

data/lib/stripe/resources/refund.rb

@@ -106,7 +106,12 @@ module Stripe
       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.
+        attr_reader :network_decline_code
+      end
+
       class Pix < Stripe::StripeObject; end
       class Revolut < Stripe::StripeObject; end
       class Sofort < Stripe::StripeObject; end
@@ -396,6 +401,8 @@ module Stripe
     attr_reader :object
     # ID of the PaymentIntent that's refunded.
     attr_reader :payment_intent
+    # Provides the reason for why the refund is pending. Possible values are: `processing`, `insufficient_funds`, or `charge_pending`.
+    attr_reader :pending_reason
     # Attribute for field presentment_details
     attr_reader :presentment_details
     # Reason for the refund, which is either user-provided (`duplicate`, `fraudulent`, or `requested_by_customer`) or generated by Stripe internally (`expired_uncaptured_charge`).

data/lib/stripe/resources/reversal.rb

@@ -8,7 +8,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/lib/stripe/resources/review.rb

@@ -4,7 +4,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
     extend Stripe::APIOperations::List

data/lib/stripe/resources/setup_attempt.rb

@@ -130,7 +130,7 @@ module Stripe
       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`.
         attr_reader :bank
         # The Bank Identifier Code of the customer's bank.
         attr_reader :bic