stripe 17.0.1 → 19.0.0

data/lib/stripe/params/test_helpers/customer_fund_cash_balance_params.rb

@@ -3,14 +3,14 @@
 
 module Stripe
   module TestHelpers
-    class CustomerFundCashBalanceParams < Stripe::RequestParams
-      # Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency).
+    class CustomerFundCashBalanceParams < ::Stripe::RequestParams
+      # Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency).
       attr_accessor :amount
       # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
       attr_accessor :currency
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
-      # A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://stripe.com/docs/payments/customer-balance/reconciliation) applies to different user inputs.
+      # A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://docs.stripe.com/payments/customer-balance/reconciliation) applies to different user inputs.
       attr_accessor :reference
 
       def initialize(amount: nil, currency: nil, expand: nil, reference: nil)

data/lib/stripe/params/test_helpers/issuing/authorization_capture_params.rb

@@ -4,10 +4,10 @@
 module Stripe
   module TestHelpers
     module Issuing
-      class AuthorizationCaptureParams < Stripe::RequestParams
-        class PurchaseDetails < Stripe::RequestParams
-          class Fleet < Stripe::RequestParams
-            class CardholderPromptData < Stripe::RequestParams
+      class AuthorizationCaptureParams < ::Stripe::RequestParams
+        class PurchaseDetails < ::Stripe::RequestParams
+          class Fleet < ::Stripe::RequestParams
+            class CardholderPromptData < ::Stripe::RequestParams
               # Driver ID.
               attr_accessor :driver_id
               # Odometer reading.
@@ -34,26 +34,34 @@ module Stripe
               end
             end
 
-            class ReportedBreakdown < Stripe::RequestParams
-              class Fuel < Stripe::RequestParams
+            class ReportedBreakdown < ::Stripe::RequestParams
+              class Fuel < ::Stripe::RequestParams
                 # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
                 attr_accessor :gross_amount_decimal
 
                 def initialize(gross_amount_decimal: nil)
                   @gross_amount_decimal = gross_amount_decimal
                 end
+
+                def self.field_encodings
+                  @field_encodings = { gross_amount_decimal: :decimal_string }
+                end
               end
 
-              class NonFuel < Stripe::RequestParams
+              class NonFuel < ::Stripe::RequestParams
                 # Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
                 attr_accessor :gross_amount_decimal
 
                 def initialize(gross_amount_decimal: nil)
                   @gross_amount_decimal = gross_amount_decimal
                 end
+
+                def self.field_encodings
+                  @field_encodings = { gross_amount_decimal: :decimal_string }
+                end
               end
 
-              class Tax < Stripe::RequestParams
+              class Tax < ::Stripe::RequestParams
                 # Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
                 attr_accessor :local_amount_decimal
                 # Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
@@ -63,6 +71,13 @@ module Stripe
                   @local_amount_decimal = local_amount_decimal
                   @national_amount_decimal = national_amount_decimal
                 end
+
+                def self.field_encodings
+                  @field_encodings = {
+                    local_amount_decimal: :decimal_string,
+                    national_amount_decimal: :decimal_string,
+                  }
+                end
               end
               # Breakdown of fuel portion of the purchase.
               attr_accessor :fuel
@@ -76,6 +91,20 @@ module Stripe
                 @non_fuel = non_fuel
                 @tax = tax
               end
+
+              def self.field_encodings
+                @field_encodings = {
+                  fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                  non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                  tax: {
+                    kind: :object,
+                    fields: {
+                      local_amount_decimal: :decimal_string,
+                      national_amount_decimal: :decimal_string,
+                    },
+                  },
+                }
+              end
             end
             # Answers to prompts presented to the cardholder at the point of sale. Prompted fields vary depending on the configuration of your physical fleet cards. Typical points of sale support only numeric entry.
             attr_accessor :cardholder_prompt_data
@@ -97,10 +126,29 @@ module Stripe
               @reported_breakdown = reported_breakdown
               @service_type = service_type
             end
+
+            def self.field_encodings
+              @field_encodings = {
+                reported_breakdown: {
+                  kind: :object,
+                  fields: {
+                    fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                    non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                    tax: {
+                      kind: :object,
+                      fields: {
+                        local_amount_decimal: :decimal_string,
+                        national_amount_decimal: :decimal_string,
+                      },
+                    },
+                  },
+                },
+              }
+            end
           end
 
-          class Flight < Stripe::RequestParams
-            class Segment < Stripe::RequestParams
+          class Flight < ::Stripe::RequestParams
+            class Segment < ::Stripe::RequestParams
               # The three-letter IATA airport code of the flight's destination.
               attr_accessor :arrival_airport_code
               # The airline carrier code.
@@ -156,7 +204,7 @@ module Stripe
             end
           end
 
-          class Fuel < Stripe::RequestParams
+          class Fuel < ::Stripe::RequestParams
             # [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
             attr_accessor :industry_product_code
             # The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
@@ -181,9 +229,16 @@ module Stripe
               @unit = unit
               @unit_cost_decimal = unit_cost_decimal
             end
+
+            def self.field_encodings
+              @field_encodings = {
+                quantity_decimal: :decimal_string,
+                unit_cost_decimal: :decimal_string,
+              }
+            end
           end
 
-          class Lodging < Stripe::RequestParams
+          class Lodging < ::Stripe::RequestParams
             # The time of checking into the lodging.
             attr_accessor :check_in_at
             # The number of nights stayed at the lodging.
@@ -195,7 +250,7 @@ module Stripe
             end
           end
 
-          class Receipt < Stripe::RequestParams
+          class Receipt < ::Stripe::RequestParams
             # Attribute for param field description
             attr_accessor :description
             # Attribute for param field quantity
@@ -211,6 +266,10 @@ module Stripe
               @total = total
               @unit_cost = unit_cost
             end
+
+            def self.field_encodings
+              @field_encodings = { quantity: :decimal_string }
+            end
           end
           # Fleet-specific information for transactions using Fleet cards.
           attr_accessor :fleet
@@ -240,8 +299,40 @@ module Stripe
             @receipt = receipt
             @reference = reference
           end
+
+          def self.field_encodings
+            @field_encodings = {
+              fleet: {
+                kind: :object,
+                fields: {
+                  reported_breakdown: {
+                    kind: :object,
+                    fields: {
+                      fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                      non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                      tax: {
+                        kind: :object,
+                        fields: {
+                          local_amount_decimal: :decimal_string,
+                          national_amount_decimal: :decimal_string,
+                        },
+                      },
+                    },
+                  },
+                },
+              },
+              fuel: {
+                kind: :object,
+                fields: { quantity_decimal: :decimal_string, unit_cost_decimal: :decimal_string },
+              },
+              receipt: {
+                kind: :array,
+                element: { kind: :object, fields: { quantity: :decimal_string } },
+              },
+            }
+          end
         end
-        # The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_accessor :capture_amount
         # Whether to close the authorization after capture. Defaults to true. Set to false to enable multi-capture flows.
         attr_accessor :close_authorization
@@ -261,6 +352,43 @@ module Stripe
           @expand = expand
           @purchase_details = purchase_details
         end
+
+        def self.field_encodings
+          @field_encodings = {
+            purchase_details: {
+              kind: :object,
+              fields: {
+                fleet: {
+                  kind: :object,
+                  fields: {
+                    reported_breakdown: {
+                      kind: :object,
+                      fields: {
+                        fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                        non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                        tax: {
+                          kind: :object,
+                          fields: {
+                            local_amount_decimal: :decimal_string,
+                            national_amount_decimal: :decimal_string,
+                          },
+                        },
+                      },
+                    },
+                  },
+                },
+                fuel: {
+                  kind: :object,
+                  fields: { quantity_decimal: :decimal_string, unit_cost_decimal: :decimal_string },
+                },
+                receipt: {
+                  kind: :array,
+                  element: { kind: :object, fields: { quantity: :decimal_string } },
+                },
+              },
+            },
+          }
+        end
       end
     end
   end

data/lib/stripe/params/test_helpers/issuing/authorization_create_params.rb

@@ -4,8 +4,8 @@
 module Stripe
   module TestHelpers
     module Issuing
-      class AuthorizationCreateParams < Stripe::RequestParams
-        class AmountDetails < Stripe::RequestParams
+      class AuthorizationCreateParams < ::Stripe::RequestParams
+        class AmountDetails < ::Stripe::RequestParams
           # The ATM withdrawal fee.
           attr_accessor :atm_fee
           # The amount of cash requested by the cardholder.
@@ -17,8 +17,8 @@ module Stripe
           end
         end
 
-        class Fleet < Stripe::RequestParams
-          class CardholderPromptData < Stripe::RequestParams
+        class Fleet < ::Stripe::RequestParams
+          class CardholderPromptData < ::Stripe::RequestParams
             # Driver ID.
             attr_accessor :driver_id
             # Odometer reading.
@@ -45,26 +45,34 @@ module Stripe
             end
           end
 
-          class ReportedBreakdown < Stripe::RequestParams
-            class Fuel < Stripe::RequestParams
+          class ReportedBreakdown < ::Stripe::RequestParams
+            class Fuel < ::Stripe::RequestParams
               # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
               attr_accessor :gross_amount_decimal
 
               def initialize(gross_amount_decimal: nil)
                 @gross_amount_decimal = gross_amount_decimal
               end
+
+              def self.field_encodings
+                @field_encodings = { gross_amount_decimal: :decimal_string }
+              end
             end
 
-            class NonFuel < Stripe::RequestParams
+            class NonFuel < ::Stripe::RequestParams
               # Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
               attr_accessor :gross_amount_decimal
 
               def initialize(gross_amount_decimal: nil)
                 @gross_amount_decimal = gross_amount_decimal
               end
+
+              def self.field_encodings
+                @field_encodings = { gross_amount_decimal: :decimal_string }
+              end
             end
 
-            class Tax < Stripe::RequestParams
+            class Tax < ::Stripe::RequestParams
               # Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
               attr_accessor :local_amount_decimal
               # Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
@@ -74,6 +82,13 @@ module Stripe
                 @local_amount_decimal = local_amount_decimal
                 @national_amount_decimal = national_amount_decimal
               end
+
+              def self.field_encodings
+                @field_encodings = {
+                  local_amount_decimal: :decimal_string,
+                  national_amount_decimal: :decimal_string,
+                }
+              end
             end
             # Breakdown of fuel portion of the purchase.
             attr_accessor :fuel
@@ -87,6 +102,20 @@ module Stripe
               @non_fuel = non_fuel
               @tax = tax
             end
+
+            def self.field_encodings
+              @field_encodings = {
+                fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                tax: {
+                  kind: :object,
+                  fields: {
+                    local_amount_decimal: :decimal_string,
+                    national_amount_decimal: :decimal_string,
+                  },
+                },
+              }
+            end
           end
           # Answers to prompts presented to the cardholder at the point of sale. Prompted fields vary depending on the configuration of your physical fleet cards. Typical points of sale support only numeric entry.
           attr_accessor :cardholder_prompt_data
@@ -108,9 +137,28 @@ module Stripe
             @reported_breakdown = reported_breakdown
             @service_type = service_type
           end
+
+          def self.field_encodings
+            @field_encodings = {
+              reported_breakdown: {
+                kind: :object,
+                fields: {
+                  fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                  non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                  tax: {
+                    kind: :object,
+                    fields: {
+                      local_amount_decimal: :decimal_string,
+                      national_amount_decimal: :decimal_string,
+                    },
+                  },
+                },
+              },
+            }
+          end
         end
 
-        class Fuel < Stripe::RequestParams
+        class Fuel < ::Stripe::RequestParams
           # [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
           attr_accessor :industry_product_code
           # The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
@@ -135,10 +183,17 @@ module Stripe
             @unit = unit
             @unit_cost_decimal = unit_cost_decimal
           end
+
+          def self.field_encodings
+            @field_encodings = {
+              quantity_decimal: :decimal_string,
+              unit_cost_decimal: :decimal_string,
+            }
+          end
         end
 
-        class MerchantData < Stripe::RequestParams
-          # A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values.
+        class MerchantData < ::Stripe::RequestParams
+          # A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values.
           attr_accessor :category
           # City where the seller is located
           attr_accessor :city
@@ -180,7 +235,7 @@ module Stripe
           end
         end
 
-        class NetworkData < Stripe::RequestParams
+        class NetworkData < ::Stripe::RequestParams
           # Identifier assigned to the acquirer by the card network.
           attr_accessor :acquiring_institution_id
 
@@ -189,50 +244,65 @@ module Stripe
           end
         end
 
-        class RiskAssessment < Stripe::RequestParams
-          class CardTestingRisk < Stripe::RequestParams
+        class RiskAssessment < ::Stripe::RequestParams
+          class CardTestingRisk < ::Stripe::RequestParams
             # The % of declines due to a card number not existing in the past hour, taking place at the same merchant. Higher rates correspond to a greater probability of card testing activity, meaning bad actors may be attempting different card number combinations to guess a correct one. Takes on values between 0 and 100.
             attr_accessor :invalid_account_number_decline_rate_past_hour
             # The % of declines due to incorrect verification data (like CVV or expiry) in the past hour, taking place at the same merchant. Higher rates correspond to a greater probability of bad actors attempting to utilize valid card credentials at merchants with verification requirements. Takes on values between 0 and 100.
             attr_accessor :invalid_credentials_decline_rate_past_hour
             # The likelihood that this authorization is associated with card testing activity. This is assessed by evaluating decline activity over the last hour.
-            attr_accessor :risk_level
+            attr_accessor :level
 
             def initialize(
               invalid_account_number_decline_rate_past_hour: nil,
               invalid_credentials_decline_rate_past_hour: nil,
-              risk_level: nil
+              level: nil
             )
               @invalid_account_number_decline_rate_past_hour = invalid_account_number_decline_rate_past_hour
               @invalid_credentials_decline_rate_past_hour = invalid_credentials_decline_rate_past_hour
-              @risk_level = risk_level
+              @level = level
             end
           end
 
-          class MerchantDisputeRisk < Stripe::RequestParams
+          class FraudRisk < ::Stripe::RequestParams
+            # Stripe’s assessment of the likelihood of fraud on an authorization.
+            attr_accessor :level
+            # Stripe’s numerical model score assessing the likelihood of fraudulent activity. A higher score means a higher likelihood of fraudulent activity, and anything above 25 is considered high risk.
+            attr_accessor :score
+
+            def initialize(level: nil, score: nil)
+              @level = level
+              @score = score
+            end
+          end
+
+          class MerchantDisputeRisk < ::Stripe::RequestParams
             # The dispute rate observed across all Stripe Issuing authorizations for this merchant. For example, a value of 50 means 50% of authorizations from this merchant on Stripe Issuing have resulted in a dispute. Higher values mean a higher likelihood the authorization is disputed. Takes on values between 0 and 100.
             attr_accessor :dispute_rate
             # The likelihood that authorizations from this merchant will result in a dispute based on their history on Stripe Issuing.
-            attr_accessor :risk_level
+            attr_accessor :level
 
-            def initialize(dispute_rate: nil, risk_level: nil)
+            def initialize(dispute_rate: nil, level: nil)
               @dispute_rate = dispute_rate
-              @risk_level = risk_level
+              @level = level
             end
           end
           # Stripe's assessment of this authorization's likelihood of being card testing activity.
           attr_accessor :card_testing_risk
+          # Stripe’s assessment of this authorization’s likelihood to be fraudulent.
+          attr_accessor :fraud_risk
           # The dispute risk of the merchant (the seller on a purchase) on an authorization based on all Stripe Issuing activity.
           attr_accessor :merchant_dispute_risk
 
-          def initialize(card_testing_risk: nil, merchant_dispute_risk: nil)
+          def initialize(card_testing_risk: nil, fraud_risk: nil, merchant_dispute_risk: nil)
             @card_testing_risk = card_testing_risk
+            @fraud_risk = fraud_risk
             @merchant_dispute_risk = merchant_dispute_risk
           end
         end
 
-        class VerificationData < Stripe::RequestParams
-          class AuthenticationExemption < Stripe::RequestParams
+        class VerificationData < ::Stripe::RequestParams
+          class AuthenticationExemption < ::Stripe::RequestParams
             # The entity that requested the exemption, either the acquiring merchant or the Issuing user.
             attr_accessor :claimed_by
             # The specific exemption claimed for this authorization.
@@ -244,7 +314,7 @@ module Stripe
             end
           end
 
-          class ThreeDSecure < Stripe::RequestParams
+          class ThreeDSecure < ::Stripe::RequestParams
             # The outcome of the 3D Secure authentication request.
             attr_accessor :result
 
@@ -281,9 +351,9 @@ module Stripe
             @three_d_secure = three_d_secure
           end
         end
-        # The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_accessor :amount
-        # Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_accessor :amount_details
         # How the card details were provided. Defaults to online.
         attr_accessor :authorization_method
@@ -299,9 +369,9 @@ module Stripe
         attr_accessor :fraud_disputability_likelihood
         # Information about fuel that was purchased with this transaction.
         attr_accessor :fuel
-        # If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
+        # If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
         attr_accessor :is_amount_controllable
-        # The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
         attr_accessor :merchant_amount
         # The currency of the authorization. If not provided, defaults to the currency of the card. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
         attr_accessor :merchant_currency
@@ -353,6 +423,34 @@ module Stripe
           @verification_data = verification_data
           @wallet = wallet
         end
+
+        def self.field_encodings
+          @field_encodings = {
+            fleet: {
+              kind: :object,
+              fields: {
+                reported_breakdown: {
+                  kind: :object,
+                  fields: {
+                    fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                    non_fuel: { kind: :object, fields: { gross_amount_decimal: :decimal_string } },
+                    tax: {
+                      kind: :object,
+                      fields: {
+                        local_amount_decimal: :decimal_string,
+                        national_amount_decimal: :decimal_string,
+                      },
+                    },
+                  },
+                },
+              },
+            },
+            fuel: {
+              kind: :object,
+              fields: { quantity_decimal: :decimal_string, unit_cost_decimal: :decimal_string },
+            },
+          }
+        end
       end
     end
   end

data/lib/stripe/params/test_helpers/issuing/authorization_expire_params.rb

@@ -4,7 +4,7 @@
 module Stripe
   module TestHelpers
     module Issuing
-      class AuthorizationExpireParams < Stripe::RequestParams
+      class AuthorizationExpireParams < ::Stripe::RequestParams
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand