stripe 15.5.0.pre.beta.2 → 15.6.0.pre.alpha.1

data/lib/stripe/services/billing/alert_service.rb

@@ -7,6 +7,8 @@ module Stripe
       class ListParams < Stripe::RequestParams
         # Filter results to only include this type of alert.
         attr_accessor :alert_type
+        # Filter results to only include alerts for the given customer.
+        attr_accessor :customer
         # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
         attr_accessor :ending_before
         # Specifies which fields in the response should be expanded.
@@ -20,6 +22,7 @@ module Stripe
 
         def initialize(
           alert_type: nil,
+          customer: nil,
           ending_before: nil,
           expand: nil,
           limit: nil,
@@ -27,6 +30,7 @@ module Stripe
           starting_after: nil
         )
           @alert_type = alert_type
+          @customer = customer
           @ending_before = ending_before
           @expand = expand
           @limit = limit
@@ -36,6 +40,67 @@ module Stripe
       end
 
       class CreateParams < Stripe::RequestParams
+        class CreditBalanceThreshold < Stripe::RequestParams
+          class Filter < Stripe::RequestParams
+            # Limit the scope to this credit balance alert only to this customer.
+            attr_accessor :customer
+            # What type of filter is being applied to this credit balance alert.
+            attr_accessor :type
+
+            def initialize(customer: nil, type: nil)
+              @customer = customer
+              @type = type
+            end
+          end
+
+          class Lte < Stripe::RequestParams
+            class CustomPricingUnit < Stripe::RequestParams
+              # The ID of the custom pricing unit.
+              attr_accessor :id
+              # A positive decimal string representing the amount of the custom pricing unit threshold.
+              attr_accessor :value
+
+              def initialize(id: nil, value: nil)
+                @id = id
+                @value = value
+              end
+            end
+
+            class Monetary < Stripe::RequestParams
+              # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
+              attr_accessor :currency
+              # An integer representing the amount of the threshold.
+              attr_accessor :value
+
+              def initialize(currency: nil, value: nil)
+                @currency = currency
+                @value = value
+              end
+            end
+            # Specify the type of this balance. We currently only support `monetary` billing credits.
+            attr_accessor :balance_type
+            # The custom pricing unit amount.
+            attr_accessor :custom_pricing_unit
+            # The monetary amount.
+            attr_accessor :monetary
+
+            def initialize(balance_type: nil, custom_pricing_unit: nil, monetary: nil)
+              @balance_type = balance_type
+              @custom_pricing_unit = custom_pricing_unit
+              @monetary = monetary
+            end
+          end
+          # The filters allows limiting the scope of this credit balance alert. You must specify a customer filter at this time.
+          attr_accessor :filters
+          # Defines at which value the alert will fire.
+          attr_accessor :lte
+
+          def initialize(filters: nil, lte: nil)
+            @filters = filters
+            @lte = lte
+          end
+        end
+
         class UsageThreshold < Stripe::RequestParams
           class Filter < Stripe::RequestParams
             # Limit the scope to this usage alert only to this customer.
@@ -66,6 +131,8 @@ module Stripe
         end
         # The type of alert to create.
         attr_accessor :alert_type
+        # The configuration of the credit balance threshold.
+        attr_accessor :credit_balance_threshold
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand
         # The title of the alert.
@@ -73,8 +140,15 @@ module Stripe
         # The configuration of the usage threshold.
         attr_accessor :usage_threshold
 
-        def initialize(alert_type: nil, expand: nil, title: nil, usage_threshold: nil)
+        def initialize(
+          alert_type: nil,
+          credit_balance_threshold: nil,
+          expand: nil,
+          title: nil,
+          usage_threshold: nil
+        )
           @alert_type = alert_type
+          @credit_balance_threshold = credit_balance_threshold
           @expand = expand
           @title = title
           @usage_threshold = usage_threshold

data/lib/stripe/services/billing/credit_balance_summary_service.rb

@@ -7,6 +7,15 @@ module Stripe
       class RetrieveParams < Stripe::RequestParams
         class Filter < Stripe::RequestParams
           class ApplicabilityScope < Stripe::RequestParams
+            class BillableItem < Stripe::RequestParams
+              # The billable item ID this credit grant should apply to.
+              attr_accessor :id
+
+              def initialize(id: nil)
+                @id = id
+              end
+            end
+
             class Price < Stripe::RequestParams
               # The price ID this credit grant should apply to.
               attr_accessor :id
@@ -15,12 +24,15 @@ module Stripe
                 @id = id
               end
             end
+            # A list of billable items that the credit grant can apply to. We currently only support metered billable items. Cannot be used in combination with `price_type` or `prices`.
+            attr_accessor :billable_items
             # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
             attr_accessor :price_type
             # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
             attr_accessor :prices
 
-            def initialize(price_type: nil, prices: nil)
+            def initialize(billable_items: nil, price_type: nil, prices: nil)
+              @billable_items = billable_items
               @price_type = price_type
               @prices = prices
             end

data/lib/stripe/services/billing/credit_grant_service.rb

@@ -37,6 +37,18 @@ module Stripe
 
       class CreateParams < Stripe::RequestParams
         class Amount < Stripe::RequestParams
+          class CustomPricingUnit < Stripe::RequestParams
+            # The ID of the custom pricing unit.
+            attr_accessor :id
+            # A positive integer representing the amount of the credit grant.
+            attr_accessor :value
+
+            def initialize(id: nil, value: nil)
+              @id = id
+              @value = value
+            end
+          end
+
           class Monetary < Stripe::RequestParams
             # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
             attr_accessor :currency
@@ -48,12 +60,15 @@ module Stripe
               @value = value
             end
           end
+          # The custom pricing unit amount.
+          attr_accessor :custom_pricing_unit
           # The monetary amount.
           attr_accessor :monetary
           # The type of this amount. We currently only support `monetary` billing credits.
           attr_accessor :type
 
-          def initialize(monetary: nil, type: nil)
+          def initialize(custom_pricing_unit: nil, monetary: nil, type: nil)
+            @custom_pricing_unit = custom_pricing_unit
             @monetary = monetary
             @type = type
           end
@@ -61,6 +76,15 @@ module Stripe
 
         class ApplicabilityConfig < Stripe::RequestParams
           class Scope < Stripe::RequestParams
+            class BillableItem < Stripe::RequestParams
+              # The billable item ID this credit grant should apply to.
+              attr_accessor :id
+
+              def initialize(id: nil)
+                @id = id
+              end
+            end
+
             class Price < Stripe::RequestParams
               # The price ID this credit grant should apply to.
               attr_accessor :id
@@ -69,12 +93,15 @@ module Stripe
                 @id = id
               end
             end
+            # A list of billable items that the credit grant can apply to. We currently only support metered billable items. Cannot be used in combination with `price_type` or `prices`.
+            attr_accessor :billable_items
             # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
             attr_accessor :price_type
             # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
             attr_accessor :prices
 
-            def initialize(price_type: nil, prices: nil)
+            def initialize(billable_items: nil, price_type: nil, prices: nil)
+              @billable_items = billable_items
               @price_type = price_type
               @prices = prices
             end

data/lib/stripe/services/billing/meter_service.rb

@@ -76,7 +76,7 @@ module Stripe
         attr_accessor :display_name
         # The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
         attr_accessor :event_name
-        # The time window to pre-aggregate meter events for, if any.
+        # The time window which meter events have been pre-aggregated for, if any.
         attr_accessor :event_time_window
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand

data/lib/stripe/services/billing_portal/configuration_service.rb

@@ -233,6 +233,8 @@ module Stripe
         attr_accessor :login_page
         # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
         attr_accessor :metadata
+        # The name of the configuration.
+        attr_accessor :name
 
         def initialize(
           business_profile: nil,
@@ -240,7 +242,8 @@ module Stripe
           expand: nil,
           features: nil,
           login_page: nil,
-          metadata: nil
+          metadata: nil,
+          name: nil
         )
           @business_profile = business_profile
           @default_return_url = default_return_url
@@ -248,6 +251,7 @@ module Stripe
           @features = features
           @login_page = login_page
           @metadata = metadata
+          @name = name
         end
       end
 
@@ -462,6 +466,8 @@ module Stripe
         attr_accessor :login_page
         # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
         attr_accessor :metadata
+        # The name of the configuration.
+        attr_accessor :name
 
         def initialize(
           active: nil,
@@ -470,7 +476,8 @@ module Stripe
           expand: nil,
           features: nil,
           login_page: nil,
-          metadata: nil
+          metadata: nil,
+          name: nil
         )
           @active = active
           @business_profile = business_profile
@@ -479,6 +486,7 @@ module Stripe
           @features = features
           @login_page = login_page
           @metadata = metadata
+          @name = name
         end
       end
 

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

@@ -94,7 +94,7 @@ module Stripe
 
       class CreateParams < Stripe::RequestParams
         class AdaptivePricing < Stripe::RequestParams
-          # Set to `true` to enable [Adaptive Pricing](https://docs.stripe.com/payments/checkout/adaptive-pricing). Defaults to your [dashboard setting](https://dashboard.stripe.com/settings/adaptive-pricing).
+          # If set to `true`, Adaptive Pricing is available on [eligible sessions](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=stripe-hosted#restrictions). Defaults to your [dashboard setting](https://dashboard.stripe.com/settings/adaptive-pricing).
           attr_accessor :enabled
 
           def initialize(enabled: nil)
@@ -149,6 +149,81 @@ module Stripe
           end
         end
 
+        class CheckoutItem < Stripe::RequestParams
+          class PricingPlanSubscriptionItem < Stripe::RequestParams
+            class ComponentConfigurations < Stripe::RequestParams
+              class LicenseFeeComponent < Stripe::RequestParams
+                # Attribute for param field quantity
+                attr_accessor :quantity
+
+                def initialize(quantity: nil)
+                  @quantity = quantity
+                end
+              end
+              # Attribute for param field type
+              attr_accessor :type
+              # Attribute for param field license_fee_component
+              attr_accessor :license_fee_component
+
+              def initialize(type: nil, license_fee_component: nil)
+                @type = type
+                @license_fee_component = license_fee_component
+              end
+            end
+            # Attribute for param field pricing_plan
+            attr_accessor :pricing_plan
+            # Attribute for param field pricing_plan_version
+            attr_accessor :pricing_plan_version
+            # Attribute for param field metadata
+            attr_accessor :metadata
+            # Attribute for param field component_configurations
+            attr_accessor :component_configurations
+
+            def initialize(
+              pricing_plan: nil,
+              pricing_plan_version: nil,
+              metadata: nil,
+              component_configurations: nil
+            )
+              @pricing_plan = pricing_plan
+              @pricing_plan_version = pricing_plan_version
+              @metadata = metadata
+              @component_configurations = component_configurations
+            end
+          end
+
+          class RateCardSubscriptionItem < Stripe::RequestParams
+            # Attribute for param field rate_card
+            attr_accessor :rate_card
+            # Attribute for param field metadata
+            attr_accessor :metadata
+            # Attribute for param field rate_card_version
+            attr_accessor :rate_card_version
+
+            def initialize(rate_card: nil, metadata: nil, rate_card_version: nil)
+              @rate_card = rate_card
+              @metadata = metadata
+              @rate_card_version = rate_card_version
+            end
+          end
+          # Attribute for param field type
+          attr_accessor :type
+          # Attribute for param field rate_card_subscription_item
+          attr_accessor :rate_card_subscription_item
+          # Attribute for param field pricing_plan_subscription_item
+          attr_accessor :pricing_plan_subscription_item
+
+          def initialize(
+            type: nil,
+            rate_card_subscription_item: nil,
+            pricing_plan_subscription_item: nil
+          )
+            @type = type
+            @rate_card_subscription_item = rate_card_subscription_item
+            @pricing_plan_subscription_item = pricing_plan_subscription_item
+          end
+        end
+
         class ConsentCollection < Stripe::RequestParams
           class PaymentMethodReuseAgreement < Stripe::RequestParams
             # Determines the position and visibility of the payment method reuse agreement in the UI. When set to `auto`, Stripe's
@@ -355,13 +430,46 @@ module Stripe
         end
 
         class Discount < Stripe::RequestParams
+          class CouponData < Stripe::RequestParams
+            # A positive integer representing the amount to subtract from an invoice total (required if `percent_off` is not passed).
+            attr_accessor :amount_off
+            # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `amount_off` parameter (required if `amount_off` is passed).
+            attr_accessor :currency
+            # Specifies how long the discount will be in effect if used on a subscription. Defaults to `once`.
+            attr_accessor :duration
+            # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+            attr_accessor :metadata
+            # Name of the coupon displayed to customers on, for instance invoices, or receipts. By default the `id` is shown if `name` is not set.
+            attr_accessor :name
+            # A positive float larger than 0, and smaller or equal to 100, that represents the discount the coupon will apply (required if `amount_off` is not passed).
+            attr_accessor :percent_off
+
+            def initialize(
+              amount_off: nil,
+              currency: nil,
+              duration: nil,
+              metadata: nil,
+              name: nil,
+              percent_off: nil
+            )
+              @amount_off = amount_off
+              @currency = currency
+              @duration = duration
+              @metadata = metadata
+              @name = name
+              @percent_off = percent_off
+            end
+          end
           # The ID of the coupon to apply to this Session.
           attr_accessor :coupon
+          # Data used to generate a new [Coupon](https://stripe.com/docs/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts.
+          attr_accessor :coupon_data
           # The ID of a promotion code to apply to this Session.
           attr_accessor :promotion_code
 
-          def initialize(coupon: nil, promotion_code: nil)
+          def initialize(coupon: nil, coupon_data: nil, promotion_code: nil)
             @coupon = coupon
+            @coupon_data = coupon_data
             @promotion_code = promotion_code
           end
         end
@@ -1487,8 +1595,50 @@ module Stripe
           end
 
           class Pix < Stripe::RequestParams
+            class MandateOptions < Stripe::RequestParams
+              # Amount to be charged for future payments. Required when `amount_type=fixed`. If not provided for `amount_type=maximum`, defaults to 40000.
+              attr_accessor :amount
+              # Determines if the amount includes the IOF tax. Defaults to `never`.
+              attr_accessor :amount_includes_iof
+              # Type of amount. Defaults to `maximum`.
+              attr_accessor :amount_type
+              # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Only `brl` is supported currently.
+              attr_accessor :currency
+              # Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
+              attr_accessor :end_date
+              # Schedule at which the future payments will be charged. Defaults to `weekly`.
+              attr_accessor :payment_schedule
+              # Subscription name displayed to buyers in their bank app. Defaults to the displayable business name.
+              attr_accessor :reference
+              # Start date of the mandate, in `YYYY-MM-DD`. Start date should be at least 3 days in the future. Defaults to 3 days after the current date.
+              attr_accessor :start_date
+
+              def initialize(
+                amount: nil,
+                amount_includes_iof: nil,
+                amount_type: nil,
+                currency: nil,
+                end_date: nil,
+                payment_schedule: nil,
+                reference: nil,
+                start_date: nil
+              )
+                @amount = amount
+                @amount_includes_iof = amount_includes_iof
+                @amount_type = amount_type
+                @currency = currency
+                @end_date = end_date
+                @payment_schedule = payment_schedule
+                @reference = reference
+                @start_date = start_date
+              end
+            end
+            # Determines if the amount includes the IOF tax. Defaults to `never`.
+            attr_accessor :amount_includes_iof
             # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
             attr_accessor :expires_after_seconds
+            # Additional fields for mandate creation.
+            attr_accessor :mandate_options
             # Indicates that you intend to make future payments with this PaymentIntent's payment method.
             #
             # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
@@ -1498,8 +1648,15 @@ module Stripe
             # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
             attr_accessor :setup_future_usage
 
-            def initialize(expires_after_seconds: nil, setup_future_usage: nil)
+            def initialize(
+              amount_includes_iof: nil,
+              expires_after_seconds: nil,
+              mandate_options: nil,
+              setup_future_usage: nil
+            )
+              @amount_includes_iof = amount_includes_iof
               @expires_after_seconds = expires_after_seconds
+              @mandate_options = mandate_options
               @setup_future_usage = setup_future_usage
             end
           end
@@ -2252,7 +2409,7 @@ module Stripe
         #
         # For `subscription` mode, there is a maximum of 20 line items and optional items with recurring Prices and 20 line items and optional items with one-time Prices.
         attr_accessor :optional_items
-        # Where the user is coming from. This informs the optimizations that are applied to the session. For example, a session originating from a mobile app may behave more like a native app, depending on the platform. This parameter is currently not allowed if `ui_mode` is `custom`.
+        # Where the user is coming from. This informs the optimizations that are applied to the session.
         attr_accessor :origin_context
         # A subset of parameters to be passed to PaymentIntent creation for Checkout Sessions in `payment` mode.
         attr_accessor :payment_intent_data
@@ -2323,6 +2480,8 @@ module Stripe
         attr_accessor :ui_mode
         # Wallet-specific configuration.
         attr_accessor :wallet_options
+        # Attribute for param field checkout_items
+        attr_accessor :checkout_items
 
         def initialize(
           adaptive_pricing: nil,
@@ -2370,7 +2529,8 @@ module Stripe
           success_url: nil,
           tax_id_collection: nil,
           ui_mode: nil,
-          wallet_options: nil
+          wallet_options: nil,
+          checkout_items: nil
         )
           @adaptive_pricing = adaptive_pricing
           @after_expiration = after_expiration
@@ -2418,6 +2578,7 @@ module Stripe
           @tax_id_collection = tax_id_collection
           @ui_mode = ui_mode
           @wallet_options = wallet_options
+          @checkout_items = checkout_items
         end
       end
 

data/lib/stripe/services/credit_note_preview_lines_service.rb

@@ -64,7 +64,7 @@ module Stripe
       class Refund < Stripe::RequestParams
         # Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
         attr_accessor :amount_refunded
-        # ID of an existing refund to link this credit note to.
+        # ID of an existing refund to link this credit note to. Required when `type` is `refund`.
         attr_accessor :refund
 
         def initialize(amount_refunded: nil, refund: nil)

data/lib/stripe/services/credit_note_service.rb

@@ -128,7 +128,7 @@ module Stripe
       class Refund < Stripe::RequestParams
         # Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
         attr_accessor :amount_refunded
-        # ID of an existing refund to link this credit note to.
+        # ID of an existing refund to link this credit note to. Required when `type` is `refund`.
         attr_accessor :refund
 
         def initialize(amount_refunded: nil, refund: nil)
@@ -292,7 +292,7 @@ module Stripe
       class Refund < Stripe::RequestParams
         # Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
         attr_accessor :amount_refunded
-        # ID of an existing refund to link this credit note to.
+        # ID of an existing refund to link this credit note to. Required when `type` is `refund`.
         attr_accessor :refund
 
         def initialize(amount_refunded: nil, refund: nil)

data/lib/stripe/services/customer_service.rb

@@ -3,17 +3,17 @@
 
 module Stripe
   class CustomerService < StripeService
-    attr_reader :cash_balance, :balance_transactions, :cash_balance_transactions, :payment_sources, :tax_ids, :payment_methods, :funding_instructions
+    attr_reader :balance_transactions, :cash_balance, :cash_balance_transactions, :funding_instructions, :payment_methods, :payment_sources, :tax_ids
 
     def initialize(requestor)
       super
-      @cash_balance = Stripe::CustomerCashBalanceService.new(@requestor)
       @balance_transactions = Stripe::CustomerBalanceTransactionService.new(@requestor)
+      @cash_balance = Stripe::CustomerCashBalanceService.new(@requestor)
       @cash_balance_transactions = Stripe::CustomerCashBalanceTransactionService.new(@requestor)
+      @funding_instructions = Stripe::CustomerFundingInstructionsService.new(@requestor)
+      @payment_methods = Stripe::CustomerPaymentMethodService.new(@requestor)
       @payment_sources = Stripe::CustomerPaymentSourceService.new(@requestor)
       @tax_ids = Stripe::CustomerTaxIdService.new(@requestor)
-      @payment_methods = Stripe::CustomerPaymentMethodService.new(@requestor)
-      @funding_instructions = Stripe::CustomerFundingInstructionsService.new(@requestor)
     end
 
     class DeleteParams < Stripe::RequestParams; end

data/lib/stripe/services/file_link_service.rb

@@ -60,7 +60,7 @@ module Stripe
       attr_accessor :expand
       # The link isn't usable after this future timestamp.
       attr_accessor :expires_at
-      # The ID of the file. The file's `purpose` must be one of the following: `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `finance_report_run`, `financial_account_statement`, `identity_document_downloadable`, `issuing_regulatory_reporting`, `pci_document`, `selfie`, `sigma_scheduled_query`, `tax_document_user_upload`, or `terminal_reader_splashscreen`.
+      # The ID of the file. The file's `purpose` must be one of the following: `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `finance_report_run`, `financial_account_statement`, `identity_document_downloadable`, `issuing_regulatory_reporting`, `pci_document`, `selfie`, `sigma_scheduled_query`, `tax_document_user_upload`, `terminal_android_apk`, or `terminal_reader_splashscreen`.
       attr_accessor :file
       # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
       attr_accessor :metadata

data/lib/stripe/services/file_service.rb

@@ -53,7 +53,7 @@ module Stripe
 
     class CreateParams < Stripe::RequestParams
       class FileLinkData < Stripe::RequestParams
-        # Set this to `true` to create a file link for the newly created file. Creating a link is only possible when the file's `purpose` is one of the following: `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `issuing_regulatory_reporting`, `pci_document`, `tax_document_user_upload`, or `terminal_reader_splashscreen`.
+        # Set this to `true` to create a file link for the newly created file. Creating a link is only possible when the file's `purpose` is one of the following: `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `issuing_regulatory_reporting`, `pci_document`, `tax_document_user_upload`, `terminal_android_apk`, or `terminal_reader_splashscreen`.
         attr_accessor :create
         # The link isn't available after this future timestamp.
         attr_accessor :expires_at

data/lib/stripe/services/invoice_payment_service.rb

@@ -7,7 +7,7 @@ module Stripe
       class Payment < Stripe::RequestParams
         # Only return invoice payments associated by this payment intent ID.
         attr_accessor :payment_intent
-        # Attribute for param field payment_record
+        # Only return invoice payments associated by this payment record ID.
         attr_accessor :payment_record
         # Only return invoice payments associated by this payment type.
         attr_accessor :type