stripe 20.2.0.pre.alpha.2 → 20.2.0.pre.alpha.3

data/lib/stripe/resources/shared_payment/granted_token.rb

@@ -80,9 +80,9 @@ module Stripe
 
         class Card < ::Stripe::StripeObject
           class Checks < ::Stripe::StripeObject
-            # If a address line1 was provided, results of the check, one of `pass`, `fail`, `unavailable`, or `unchecked`.
+            # If an address line1 was provided, results of the check, one of `pass`, `fail`, `unavailable`, or `unchecked`.
             attr_reader :address_line1_check
-            # If a address postal code was provided, results of the check, one of `pass`, `fail`, `unavailable`, or `unchecked`.
+            # If an address postal code was provided, results of the check, one of `pass`, `fail`, `unavailable`, or `unchecked`.
             attr_reader :address_postal_code_check
             # If a CVC was provided, results of the check, one of `pass`, `fail`, `unavailable`, or `unchecked`.
             attr_reader :cvc_check
@@ -441,6 +441,33 @@ module Stripe
         end
       end
 
+      class ReferralFeeDetails < ::Stripe::StripeObject
+        class Rate < ::Stripe::StripeObject
+          # The percentage of the payment amount which will be calculated as a fee.
+          attr_reader :percentage
+          # The type of fee rate.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field rate
+        attr_reader :rate
+
+        def self.inner_class_types
+          @inner_class_types = { rate: Rate }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class RiskDetails < ::Stripe::StripeObject
         class Insights < ::Stripe::StripeObject
           class Bot < ::Stripe::StripeObject
@@ -631,6 +658,8 @@ module Stripe
       attr_reader :object
       # Details of the PaymentMethod that was shared via this token.
       attr_reader :payment_method_details
+      # Referral fees may be charged when a SharedPaymentGrantedToken is used. This behavior is controlled by the issuer of the token. This field provides details about the referral fee rate.
+      attr_reader :referral_fee_details
       # Risk details of the SharedPaymentGrantedToken.
       attr_reader :risk_details
       # Metadata about the SharedPaymentGrantedToken.
@@ -685,6 +714,7 @@ module Stripe
         @inner_class_types = {
           agent_details: AgentDetails,
           payment_method_details: PaymentMethodDetails,
+          referral_fee_details: ReferralFeeDetails,
           risk_details: RiskDetails,
           usage_details: UsageDetails,
           usage_limits: UsageLimits,

data/lib/stripe/resources/shared_payment/issued_token.rb

@@ -56,6 +56,23 @@ module Stripe
         end
       end
 
+      class ReferralFeeDetails < ::Stripe::StripeObject
+        # The Customer to be invoiced for fees assessed.
+        attr_reader :customer
+        # The account to be invoiced for fees assessed.
+        attr_reader :customer_account
+        # The percentage of the payment charged as a referral fee.
+        attr_reader :referral_fee_percent
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class RiskDetails < ::Stripe::StripeObject
         class Insights < ::Stripe::StripeObject
           class Bot < ::Stripe::StripeObject
@@ -261,6 +278,8 @@ module Stripe
       attr_reader :object
       # ID of an existing PaymentMethod.
       attr_reader :payment_method
+      # Referral fee details of the SharedPaymentIssuedToken.
+      attr_reader :referral_fee_details
       # If the customer does not exit their browser while authenticating, they will be redirected to this specified URL after completion.
       attr_reader :return_url
       # Risk details of the SharedPaymentIssuedToken.
@@ -313,6 +332,7 @@ module Stripe
       def self.inner_class_types
         @inner_class_types = {
           next_action: NextAction,
+          referral_fee_details: ReferralFeeDetails,
           risk_details: RiskDetails,
           seller_details: SellerDetails,
           usage_details: UsageDetails,

data/lib/stripe/resources/terminal/reader.rb

@@ -704,10 +704,27 @@ module Stripe
           @field_remappings = {}
         end
       end
+
+      class DeviceHealthDetail < ::Stripe::StripeObject
+        # The type of condition affecting the reader's device health.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       # The most recent action performed by the reader.
       attr_reader :action
       # Always true for a deleted object
       attr_reader :deleted
+      # The overall device health of the reader: `healthy` or `unhealthy`. Renamed to `no_issues_detected` and `needs_attention` respectively; see `device_health_details` for the specific conditions.
+      attr_reader :device_health
+      # The set of conditions affecting the reader's device health. Empty when there are no conditions.
+      attr_reader :device_health_details
       # The current software version of the reader.
       attr_reader :device_sw_version
       # Device type of the reader.
@@ -1095,7 +1112,7 @@ module Stripe
       end
 
       def self.inner_class_types
-        @inner_class_types = { action: Action }
+        @inner_class_types = { action: Action, device_health_details: DeviceHealthDetail }
       end
 
       def self.field_remappings

data/lib/stripe/resources/v2/core/event.rb

@@ -6,7 +6,7 @@ module Stripe
     module Core
       # Events are generated to keep you informed of activity in your business account. APIs in the /v2 namespace generate [thin events](https://docs.stripe.com/event-destinations#benefits-of-thin-events) which have small, unversioned payloads that include a reference to the ID of the object that has changed. The Events v2 API returns these new thin events. [Retrieve the event object](https://docs.stripe.com/event-destinations#fetch-data) for additional data about the event. Use the related object ID in the event payload to [fetch the API resource](https://docs.stripe.com/event-destinations#retrieve-the-object-associated-with-thin-events) of the object associated with the event. Comparatively, events generated by most API v1 include a versioned snapshot of an API object in their payload.
       # You can access events through the [Retrieve Event API](https://docs.stripe.com/api/v2/core/events/retrieve) for 30 days.
-      class Event < APIResource
+      class Event < EventBase
         OBJECT_NAME = "v2.core.event"
         def self.object_name
           "v2.core.event"

data/lib/stripe/resources/v2/core/event_base.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      class EventBase < APIResource
+        # internal use: a requestor scoped to this event's own Stripe-Context,
+        # discarding any Stripe-Account the configured requestor may carry.
+        # `context`, not account, is what routes a direct-retrieve `Event` (and
+        # requests made through #fetch_related_object) to the right account --
+        # mirrors how EventNotification#initialize scopes @client.
+        private def scoped_requestor
+          @scoped_requestor ||= begin
+            scoped_config = @requestor.config.reverse_duplicate_merge(
+              stripe_account: nil, stripe_context: context
+            )
+            APIRequestor.new(scoped_config)
+          end
+        end
+
+        # Overridden so that every generated `fetch_related_object` (which calls
+        # this method) routes through #scoped_requestor. Still combines with this
+        # event's retained @opts so a retained api_key/stripe_version override
+        # survives, but with @opts's own stripe_account/stripe_context forced to
+        # the safe values first, since those are exactly what may be stale left
+        # over from how this Event itself was retrieved.
+        protected def _request(method:, path:, base_address:, params: {}, opts: {})
+          req_opts = RequestOptions.extract_opts_from_hash(opts)
+          safe_opts = @opts.merge(stripe_account: nil, stripe_context: context)
+          req_opts = RequestOptions.combine_opts(safe_opts, req_opts)
+          scoped_requestor.execute_request(method, path, base_address, params: params, opts: req_opts)
+        end
+      end
+    end
+  end
+end

data/lib/stripe/resources/v2/money_management/outbound_payment.rb

@@ -197,11 +197,32 @@ module Stripe
                 @field_remappings = {}
               end
             end
+
+            class CheckSend < ::Stripe::StripeObject
+              # The ID of a file to include as an attachment with the check.
+              attr_reader :attachment_file
+              # Memo printed on the memo field of the check.
+              attr_reader :memo
+              # Open Enum. Shipping speed of the check. Defaults to standard.
+              attr_reader :shipping_speed
+              # Signature printed on the check.
+              attr_reader :signature
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
             # Options for bank account payout methods.
             attr_reader :bank_account
+            # Options for check send payout methods.
+            attr_reader :check_send
 
             def self.inner_class_types
-              @inner_class_types = { bank_account: BankAccount }
+              @inner_class_types = { bank_account: BankAccount, check_send: CheckSend }
             end
 
             def self.field_remappings
@@ -271,6 +292,55 @@ module Stripe
             end
           end
 
+          class CheckSend < ::Stripe::StripeObject
+            class MailingAddress < ::Stripe::StripeObject
+              # City, district, suburb, town, or village.
+              attr_reader :city
+              # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+              attr_reader :country
+              # Address line 1 (e.g., street, PO Box, or company name).
+              attr_reader :line1
+              # Address line 2 (e.g., apartment, suite, unit, or building).
+              attr_reader :line2
+              # ZIP or postal code.
+              attr_reader :postal_code
+              # State, county, province, or region.
+              attr_reader :state
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Open Enum. Carrier of the check.
+            attr_reader :carrier
+            # Check number.
+            attr_reader :check_number
+            # Postal code of the latest tracking update.
+            attr_reader :current_postal_code
+            # The ID of a file containing a preview image of the mailed check.
+            attr_reader :mailed_check_preview_file
+            # Mailing address of the check.
+            attr_reader :mailing_address
+            # Tracking number for the check.
+            attr_reader :tracking_number
+            # Open Enum. Tracking status of the check.
+            attr_reader :tracking_status
+            # When the tracking details were last updated.
+            attr_reader :updated_at
+
+            def self.inner_class_types
+              @inner_class_types = { mailing_address: MailingAddress }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
           class CryptoWallet < ::Stripe::StripeObject
             # A unique identifier that can be used to track this OutboundPayment with the recipient crypto wallet.
             attr_reader :blockchain_transaction
@@ -334,6 +404,8 @@ module Stripe
           attr_reader :bank_account
           # Card tracking details.
           attr_reader :card
+          # Check send tracking details.
+          attr_reader :check_send
           # Crypto wallet tracking details.
           attr_reader :crypto_wallet
           # Paper check tracking details.
@@ -347,6 +419,7 @@ module Stripe
             @inner_class_types = {
               bank_account: BankAccount,
               card: Card,
+              check_send: CheckSend,
               crypto_wallet: CryptoWallet,
               paper_check: PaperCheck,
             }

data/lib/stripe/resources/v2/money_management/payout_intent.rb

@@ -324,11 +324,32 @@ module Stripe
                 @field_remappings = {}
               end
             end
+
+            class CheckSend < ::Stripe::StripeObject
+              # The ID of a file to include as an attachment with the check.
+              attr_reader :attachment_file
+              # Memo printed on the memo field of the check.
+              attr_reader :memo
+              # Open Enum. Shipping speed of the check. Defaults to standard.
+              attr_reader :shipping_speed
+              # Signature printed on the check.
+              attr_reader :signature
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
             # Options for bank account payout methods.
             attr_reader :bank_account
+            # Options for check send payout methods.
+            attr_reader :check_send
 
             def self.inner_class_types
-              @inner_class_types = { bank_account: BankAccount }
+              @inner_class_types = { bank_account: BankAccount, check_send: CheckSend }
             end
 
             def self.field_remappings

data/lib/stripe/resources/v2/money_management/payout_method.rb

@@ -106,6 +106,43 @@ module Stripe
           end
         end
 
+        class CheckSend < ::Stripe::StripeObject
+          class MailingAddress < ::Stripe::StripeObject
+            # City.
+            attr_reader :city
+            # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+            attr_reader :country
+            # Address line 1 (e.g., street, PO Box, or company name).
+            attr_reader :line1
+            # Address line 2 (e.g., apartment, suite, unit, or building).
+            attr_reader :line2
+            # ZIP or postal code.
+            attr_reader :postal_code
+            # State.
+            attr_reader :state
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The US mailing address the check is sent to.
+          attr_reader :mailing_address
+          # The name printed on the check's payee line.
+          attr_reader :payee_name
+
+          def self.inner_class_types
+            @inner_class_types = { mailing_address: MailingAddress }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
         class CryptoWallet < ::Stripe::StripeObject
           # Destination wallet address.
           attr_reader :address
@@ -185,6 +222,8 @@ module Stripe
         attr_reader :bank_account
         # The PayoutMethodCard object details.
         attr_reader :card
+        # The PayoutMethodCheckSend object details.
+        attr_reader :check_send
         # Created timestamp.
         attr_reader :created
         # The PayoutMethodCryptoWallet object details.
@@ -215,6 +254,7 @@ module Stripe
             apple_pay: ApplePay,
             bank_account: BankAccount,
             card: Card,
+            check_send: CheckSend,
             crypto_wallet: CryptoWallet,
             network_business_profile_wallet: NetworkBusinessProfileWallet,
             pix: Pix,

data/lib/stripe/resources/v2/money_management/received_debit.rb

@@ -39,6 +39,7 @@ module Stripe
             # Open Enum. The bank network the debit was originated on.
             attr_reader :network
             # The ID of the mandate associated with this debit.
+            # Deprecated: use `bank_transfer.spending_mandate` instead.
             attr_reader :received_debit_mandate
             # The sort code of the bank that originated the debit.
             attr_reader :sort_code
@@ -118,6 +119,8 @@ module Stripe
           attr_reader :origin_type
           # Open Enum. The type of the payment method used to originate the debit.
           attr_reader :payment_method_type
+          # The ID of the SpendingMandate associated with this debit.
+          attr_reader :spending_mandate
           # The statement descriptor set by the originator of the debit.
           attr_reader :statement_descriptor
           # Object containing details of the US Bank Account that originated the debit.

data/lib/stripe/resources/v2/money_management/spending_mandate.rb

@@ -0,0 +1,121 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      # A SpendingMandate authorizes a counterparty to pull money from a Financial Account.
+      class SpendingMandate < APIResource
+        OBJECT_NAME = "v2.money_management.spending_mandate"
+        def self.object_name
+          "v2.money_management.spending_mandate"
+        end
+
+        class BankTransfer < ::Stripe::StripeObject
+          # The name of the account holder that initiated the debit.
+          attr_reader :account_holder_name
+          # The financial address associated with this mandate.
+          attr_reader :financial_address
+          # The bank transfer network for this mandate.
+          attr_reader :network
+          # The bank transfer reference provided by the bank. Only present when `network` is `bacs`.
+          attr_reader :reference
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class StatusDetails < ::Stripe::StripeObject
+          class Canceled < ::Stripe::StripeObject
+            # The `canceled` status reason.
+            attr_reader :reason
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # If the mandate is canceled, this field provides more details on the cancellation reason.
+          attr_reader :canceled
+
+          def self.inner_class_types
+            @inner_class_types = { canceled: Canceled }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class StatusTransitions < ::Stripe::StripeObject
+          # Timestamp describing when the SpendingMandate changed status to `active`.
+          # Represented as a RFC 3339 date & time UTC value in millisecond precision.
+          attr_reader :activated_at
+          # Timestamp describing when the SpendingMandate changed status to `canceled`.
+          # Represented as a RFC 3339 date & time UTC value in millisecond precision.
+          attr_reader :canceled_at
+          # Timestamp describing when the SpendingMandate was created.
+          # Represented as a RFC 3339 date & time UTC value in millisecond precision.
+          attr_reader :created_at
+          # Timestamp describing when the SpendingMandate changed status to `expired`.
+          # Represented as a RFC 3339 date & time UTC value in millisecond precision.
+          attr_reader :expired_at
+          # Timestamp describing when the SpendingMandate changed status to `pending_cancellation`.
+          # Represented as a RFC 3339 date & time UTC value in millisecond precision.
+          attr_reader :pending_cancellation_at
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Bank transfer details. Present if `type` is `bank_transfer`.
+        attr_reader :bank_transfer
+        # The time at which the SpendingMandate was created.
+        # Represented as a RFC 3339 date & time UTC value in millisecond precision.
+        attr_reader :created
+        # The currency in ISO 4217 format that debits will be collected in.
+        attr_reader :currency
+        # Financial account ID associated with this mandate.
+        attr_reader :financial_account
+        # The unique identifier for the SpendingMandate.
+        attr_reader :id
+        # 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
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # The status of the SpendingMandate.
+        attr_reader :status
+        # Detailed information about the status of the SpendingMandate.
+        attr_reader :status_details
+        # Timestamps describing when the mandate changed status.
+        attr_reader :status_transitions
+        # The type of the SpendingMandate.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = {
+            bank_transfer: BankTransfer,
+            status_details: StatusDetails,
+            status_transitions: StatusTransitions,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

data/lib/stripe/resources.rb

@@ -1623,6 +1623,26 @@ module Stripe
              "stripe/events/v2_money_management_reward_program_reward_reversed_event"
     autoload :V2MoneyManagementRewardProgramRewardReversedEventNotification,
              "stripe/events/v2_money_management_reward_program_reward_reversed_event"
+    autoload :V2MoneyManagementSpendingMandateCanceledEvent,
+             "stripe/events/v2_money_management_spending_mandate_canceled_event"
+    autoload :V2MoneyManagementSpendingMandateCanceledEventNotification,
+             "stripe/events/v2_money_management_spending_mandate_canceled_event"
+    autoload :V2MoneyManagementSpendingMandateCreatedEvent,
+             "stripe/events/v2_money_management_spending_mandate_created_event"
+    autoload :V2MoneyManagementSpendingMandateCreatedEventNotification,
+             "stripe/events/v2_money_management_spending_mandate_created_event"
+    autoload :V2MoneyManagementSpendingMandateExpiredEvent,
+             "stripe/events/v2_money_management_spending_mandate_expired_event"
+    autoload :V2MoneyManagementSpendingMandateExpiredEventNotification,
+             "stripe/events/v2_money_management_spending_mandate_expired_event"
+    autoload :V2MoneyManagementSpendingMandatePendingCancellationEvent,
+             "stripe/events/v2_money_management_spending_mandate_pending_cancellation_event"
+    autoload :V2MoneyManagementSpendingMandatePendingCancellationEventNotification,
+             "stripe/events/v2_money_management_spending_mandate_pending_cancellation_event"
+    autoload :V2MoneyManagementSpendingMandateUpdatedEvent,
+             "stripe/events/v2_money_management_spending_mandate_updated_event"
+    autoload :V2MoneyManagementSpendingMandateUpdatedEventNotification,
+             "stripe/events/v2_money_management_spending_mandate_updated_event"
     autoload :V2MoneyManagementTransactionCreatedEvent, "stripe/events/v2_money_management_transaction_created_event"
     autoload :V2MoneyManagementTransactionCreatedEventNotification,
              "stripe/events/v2_money_management_transaction_created_event"
@@ -1940,6 +1960,7 @@ module Stripe
       autoload :ClaimableSandbox, "stripe/resources/v2/core/claimable_sandbox"
       autoload :ConnectionSession, "stripe/resources/v2/core/connection_session"
       autoload :Event, "stripe/resources/v2/core/event"
+      autoload :EventBase, "stripe/resources/v2/core/event_base"
       autoload :EventDestination, "stripe/resources/v2/core/event_destination"
       autoload :EventNotification, "stripe/resources/v2/core/event_notification"
       autoload :EventReason, "stripe/resources/v2/core/event_notification"
@@ -2026,6 +2047,7 @@ module Stripe
       autoload :RewardProgram, "stripe/resources/v2/money_management/reward_program"
       autoload :RewardProgramEnrollment, "stripe/resources/v2/money_management/reward_program_enrollment"
       autoload :RewardProgramRule, "stripe/resources/v2/money_management/reward_program_rule"
+      autoload :SpendingMandate, "stripe/resources/v2/money_management/spending_mandate"
       autoload :Transaction, "stripe/resources/v2/money_management/transaction"
       autoload :TransactionEntry, "stripe/resources/v2/money_management/transaction_entry"
     end
@@ -2085,6 +2107,7 @@ end
 module Stripe
   # rubocop:disable Metrics/CollectionLiteralLength
   RESOURCE_FILES = %w[
+    stripe/resources/v2/core/event_base
     stripe/resources/v2/core/event_notification
     stripe/resources/account
     stripe/resources/account_link
@@ -2397,6 +2420,7 @@ module Stripe
     stripe/resources/v2/money_management/reward_program
     stripe/resources/v2/money_management/reward_program_enrollment
     stripe/resources/v2/money_management/reward_program_rule
+    stripe/resources/v2/money_management/spending_mandate
     stripe/resources/v2/money_management/transaction
     stripe/resources/v2/money_management/transaction_entry
     stripe/resources/v2/network/business_profile
@@ -2939,6 +2963,11 @@ module Stripe
     stripe/events/v2_money_management_recipient_verification_updated_event
     stripe/events/v2_money_management_reward_program_reward_earned_event
     stripe/events/v2_money_management_reward_program_reward_reversed_event
+    stripe/events/v2_money_management_spending_mandate_canceled_event
+    stripe/events/v2_money_management_spending_mandate_created_event
+    stripe/events/v2_money_management_spending_mandate_expired_event
+    stripe/events/v2_money_management_spending_mandate_pending_cancellation_event
+    stripe/events/v2_money_management_spending_mandate_updated_event
     stripe/events/v2_money_management_transaction_created_event
     stripe/events/v2_money_management_transaction_updated_event
     stripe/events/v2_orchestrated_commerce_agreement_confirmed_event

data/lib/stripe/services/checkout/session_service.rb

@@ -23,6 +23,8 @@ module Stripe
       end
 
       # Creates a Checkout Session object.
+      #
+      # Validate requests on your server and protect your application's Session-creation endpoint with access controls and limits on repeated creation. See [Protect your Session-creation endpoint](https://docs.stripe.com/payments/accept-a-payment?payment-ui=elements&api-integration=checkout#protect-session-creation).
       def create(params = {}, opts = {})
         unless params.is_a?(Stripe::RequestParams)
           params = ::Stripe::Checkout::SessionCreateParams.coerce_params(params)

data/lib/stripe/services/reserve/hold_service.rb

@@ -4,7 +4,7 @@
 module Stripe
   module Reserve
     class HoldService < StripeService
-      # Returns a list of ReserveHolds previously created. The ReserveHolds are returned in sorted order, with the most recent ReserveHolds appearing first.
+      # Returns a list of ReserveHolds on your account or on one of your connected accounts. The ReserveHolds are returned in sorted order, with the most recent ReserveHolds appearing first.
       def list(params = {}, opts = {})
         request(
           method: :get,
@@ -15,7 +15,7 @@ module Stripe
         )
       end
 
-      # Retrieve a ReserveHold.
+      # Retrieve a ReserveHold on your account or on one of your connected accounts.
       def retrieve(id, params = {}, opts = {})
         request(
           method: :get,

data/lib/stripe/services/reserve/plan_service.rb

@@ -4,7 +4,7 @@
 module Stripe
   module Reserve
     class PlanService < StripeService
-      # Returns a list of ReservePlans previously created. The ReservePlans are returned in sorted order, with the most recent ReservePlans appearing first.
+      # Returns a list of ReservePlans on your account or on one of your connected accounts. The ReservePlans are returned in sorted order, with the most recent ReservePlans appearing first.
       def list(params = {}, opts = {})
         request(
           method: :get,
@@ -15,7 +15,7 @@ module Stripe
         )
       end
 
-      # Retrieve a ReservePlan.
+      # Retrieve a ReservePlan on your account or on one of your connected accounts.
       def retrieve(id, params = {}, opts = {})
         request(
           method: :get,

data/lib/stripe/services/reserve/release_service.rb

@@ -4,7 +4,7 @@
 module Stripe
   module Reserve
     class ReleaseService < StripeService
-      # Returns a list of ReserveReleases previously created. The ReserveReleases are returned in sorted order, with the most recent ReserveReleases appearing first.
+      # Returns a list of ReserveReleases on your account or on one of your connected accounts. The ReserveReleases are returned in sorted order, with the most recent ReserveReleases appearing first.
       def list(params = {}, opts = {})
         request(
           method: :get,
@@ -15,7 +15,7 @@ module Stripe
         )
       end
 
-      # Retrieve a ReserveRelease.
+      # Retrieve a ReserveRelease on your account or on one of your connected accounts.
       def retrieve(id, params = {}, opts = {})
         request(
           method: :get,

data/lib/stripe/services/v2/core/vault/network_token_service.rb

@@ -25,6 +25,7 @@ module Stripe
           #
           # ** raises CannotProceedError
           # ** raises BlockedByStripeError
+          # ** raises MerchantNotGatedError
           def create_from_credential(params = {}, opts = {})
             request(
               method: :post,