square.rb 44.1.0.20250924 → 45.0.1.20260122

data/lib/square/customers/custom_attribute_definitions/client.rb

@@ -4,48 +4,71 @@ module Square
   module Customers
     module CustomAttributeDefinitions
       class Client
-        # @return [Square::Customers::CustomAttributeDefinitions::Client]
+        # @param client [Square::Internal::Http::RawClient]
+        #
+        # @return [void]
         def initialize(client:)
           @client = client
         end
 
-        # Lists the customer-related [custom attribute definitions](entity:CustomAttributeDefinition) that belong to a Square seller account.
+        # Lists the customer-related [custom attribute definitions](entity:CustomAttributeDefinition) that belong to a
+        # Square seller account.
         #
         # When all response pages are retrieved, the results include all custom attribute definitions
         # that are visible to the requesting application, including those that are created by other
         # applications and set to `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`. Note that
-        # seller-defined custom attributes (also known as custom fields) are always set to `VISIBILITY_READ_WRITE_VALUES`.
+        # seller-defined custom attributes (also known as custom fields) are always set to
+        # `VISIBILITY_READ_WRITE_VALUES`.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [Integer, nil] :limit
+        # @option params [String, nil] :cursor
         #
         # @return [Square::Types::ListCustomerCustomAttributeDefinitionsResponse]
         def list(request_options: {}, **params)
-          _query_param_names = [
-            %w[limit cursor],
-            %i[limit cursor]
-          ].flatten
-          _query = params.slice(*_query_param_names)
-          params.except(*_query_param_names)
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          query_param_names = %i[limit cursor]
+          query_params = {}
+          query_params["limit"] = params[:limit] if params.key?(:limit)
+          query_params["cursor"] = params[:cursor] if params.key?(:cursor)
+          params.except(*query_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
-            method: "GET",
-            path: "v2/customers/custom-attribute-definitions",
-            query: _query
-          )
-          begin
-            _response = @client.send(_request)
-          rescue Net::HTTPRequestTimeout
-            raise Square::Errors::TimeoutError
-          end
-          code = _response.code.to_i
-          if code.between?(200, 299)
-            Square::Types::ListCustomerCustomAttributeDefinitionsResponse.load(_response.body)
-          else
-            error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+          Square::Internal::CursorItemIterator.new(
+            cursor_field: :cursor,
+            item_field: :custom_attribute_definitions,
+            initial_cursor: query_params[:cursor]
+          ) do |next_cursor|
+            query_params[:cursor] = next_cursor
+            request = Square::Internal::JSON::Request.new(
+              base_url: request_options[:base_url],
+              method: "GET",
+              path: "v2/customers/custom-attribute-definitions",
+              query: query_params,
+              request_options: request_options
+            )
+            begin
+              response = @client.send(request)
+            rescue Net::HTTPRequestTimeout
+              raise Square::Errors::TimeoutError
+            end
+            code = response.code.to_i
+            if code.between?(200, 299)
+              Square::Types::ListCustomerCustomAttributeDefinitionsResponse.load(response.body)
+            else
+              error_class = Square::Errors::ResponseError.subclass_for_code(code)
+              raise error_class.new(response.body, code: code)
+            end
           end
         end
 
-        # Creates a customer-related [custom attribute definition](entity:CustomAttributeDefinition) for a Square seller account.
+        # Creates a customer-related [custom attribute definition](entity:CustomAttributeDefinition) for a Square seller
+        # account.
         # Use this endpoint to define a custom attribute that can be associated with customer profiles.
         #
         # A custom attribute definition specifies the `key`, `visibility`, `schema`, and other properties
@@ -57,64 +80,87 @@ module Square
         # Sellers can view all custom attributes in exported customer data, including those set to
         # `VISIBILITY_HIDDEN`.
         #
+        # @param request_options [Hash]
+        # @param params [Square::Customers::CustomAttributeDefinitions::Types::CreateCustomerCustomAttributeDefinitionRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        #
         # @return [Square::Types::CreateCustomerCustomAttributeDefinitionResponse]
         def create(request_options: {}, **params)
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "POST",
             path: "v2/customers/custom-attribute-definitions",
-            body: params
+            body: Square::Customers::CustomAttributeDefinitions::Types::CreateCustomerCustomAttributeDefinitionRequest.new(params).to_h,
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::CreateCustomerCustomAttributeDefinitionResponse.load(_response.body)
+            Square::Types::CreateCustomerCustomAttributeDefinitionResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
 
-        # Retrieves a customer-related [custom attribute definition](entity:CustomAttributeDefinition) from a Square seller account.
+        # Retrieves a customer-related [custom attribute definition](entity:CustomAttributeDefinition) from a Square
+        # seller account.
         #
         # To retrieve a custom attribute definition created by another application, the `visibility`
-        # setting must be `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`. Note that seller-defined custom attributes
+        # setting must be `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`. Note that seller-defined custom
+        # attributes
         # (also known as custom fields) are always set to `VISIBILITY_READ_WRITE_VALUES`.
         #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :key
+        # @option params [Integer, nil] :version
+        #
         # @return [Square::Types::GetCustomerCustomAttributeDefinitionResponse]
         def get(request_options: {}, **params)
-          _query_param_names = [
-            ["version"],
-            %i[version]
-          ].flatten
-          _query = params.slice(*_query_param_names)
-          params = params.except(*_query_param_names)
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          query_param_names = %i[version]
+          query_params = {}
+          query_params["version"] = params[:version] if params.key?(:version)
+          params = params.except(*query_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "GET",
             path: "v2/customers/custom-attribute-definitions/#{params[:key]}",
-            query: _query
+            query: query_params,
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::GetCustomerCustomAttributeDefinitionResponse.load(_response.body)
+            Square::Types::GetCustomerCustomAttributeDefinitionResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
 
-        # Updates a customer-related [custom attribute definition](entity:CustomAttributeDefinition) for a Square seller account.
+        # Updates a customer-related [custom attribute definition](entity:CustomAttributeDefinition) for a Square seller
+        # account.
         #
         # Use this endpoint to update the following fields: `name`, `description`, `visibility`, or the
         # `schema` for a `Selection` data type.
@@ -122,55 +168,80 @@ module Square
         # Only the definition owner can update a custom attribute definition. Note that sellers can view
         # all custom attributes in exported customer data, including those set to `VISIBILITY_HIDDEN`.
         #
+        # @param request_options [Hash]
+        # @param params [Square::Customers::CustomAttributeDefinitions::Types::UpdateCustomerCustomAttributeDefinitionRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :key
+        #
         # @return [Square::Types::UpdateCustomerCustomAttributeDefinitionResponse]
         def update(request_options: {}, **params)
-          _path_param_names = ["key"]
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request_data = Square::Customers::CustomAttributeDefinitions::Types::UpdateCustomerCustomAttributeDefinitionRequest.new(params).to_h
+          non_body_param_names = ["key"]
+          body = request_data.except(*non_body_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "PUT",
             path: "v2/customers/custom-attribute-definitions/#{params[:key]}",
-            body: params.except(*_path_param_names)
+            body: body,
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::UpdateCustomerCustomAttributeDefinitionResponse.load(_response.body)
+            Square::Types::UpdateCustomerCustomAttributeDefinitionResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
 
-        # Deletes a customer-related [custom attribute definition](entity:CustomAttributeDefinition) from a Square seller account.
+        # Deletes a customer-related [custom attribute definition](entity:CustomAttributeDefinition) from a Square
+        # seller account.
         #
         # Deleting a custom attribute definition also deletes the corresponding custom attribute from
         # all customer profiles in the seller's Customer Directory.
         #
         # Only the definition owner can delete a custom attribute definition.
         #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :key
+        #
         # @return [Square::Types::DeleteCustomerCustomAttributeDefinitionResponse]
         def delete(request_options: {}, **params)
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "DELETE",
-            path: "v2/customers/custom-attribute-definitions/#{params[:key]}"
+            path: "v2/customers/custom-attribute-definitions/#{params[:key]}",
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::DeleteCustomerCustomAttributeDefinitionResponse.load(_response.body)
+            Square::Types::DeleteCustomerCustomAttributeDefinitionResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
 
@@ -178,7 +249,9 @@ module Square
         #
         # Use this endpoint to set the value of one or more custom attributes for one or more customer profiles.
         # A custom attribute is based on a custom attribute definition in a Square seller account, which is
-        # created using the [CreateCustomerCustomAttributeDefinition](api-endpoint:CustomerCustomAttributes-CreateCustomerCustomAttributeDefinition) endpoint.
+        # created using the
+        # [CreateCustomerCustomAttributeDefinition](api-endpoint:CustomerCustomAttributes-CreateCustomerCustomAttributeDefinition)
+        # endpoint.
         #
         # This `BulkUpsertCustomerCustomAttributes` endpoint accepts a map of 1 to 25 individual upsert
         # requests and returns a map of individual upsert responses. Each upsert request has a unique ID
@@ -189,25 +262,35 @@ module Square
         # must be `VISIBILITY_READ_WRITE_VALUES`. Note that seller-defined custom attributes
         # (also known as custom fields) are always set to `VISIBILITY_READ_WRITE_VALUES`.
         #
+        # @param request_options [Hash]
+        # @param params [Square::Customers::CustomAttributeDefinitions::Types::BatchUpsertCustomerCustomAttributesRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        #
         # @return [Square::Types::BatchUpsertCustomerCustomAttributesResponse]
         def batch_upsert(request_options: {}, **params)
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "POST",
             path: "v2/customers/custom-attributes/bulk-upsert",
-            body: params
+            body: Square::Customers::CustomAttributeDefinitions::Types::BatchUpsertCustomerCustomAttributesRequest.new(params).to_h,
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::BatchUpsertCustomerCustomAttributesResponse.load(_response.body)
+            Square::Types::BatchUpsertCustomerCustomAttributesResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
       end

data/lib/square/customers/custom_attribute_definitions/types/batch_upsert_customer_custom_attributes_request.rb

@@ -5,9 +5,7 @@ module Square
     module CustomAttributeDefinitions
       module Types
         class BatchUpsertCustomerCustomAttributesRequest < Internal::Types::Model
-          field :values, lambda {
-            Internal::Types::Hash[String, Square::Types::BatchUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest]
-          }, optional: false, nullable: false
+          field :values, -> { Internal::Types::Hash[String, Square::Types::BatchUpsertCustomerCustomAttributesRequestCustomerCustomAttributeUpsertRequest] }, optional: false, nullable: false
         end
       end
     end

data/lib/square/customers/custom_attribute_definitions/types/create_customer_custom_attribute_definition_request.rb

@@ -5,9 +5,7 @@ module Square
     module CustomAttributeDefinitions
       module Types
         class CreateCustomerCustomAttributeDefinitionRequest < Internal::Types::Model
-          field :custom_attribute_definition, lambda {
-            Square::Types::CustomAttributeDefinition
-          }, optional: false, nullable: false
+          field :custom_attribute_definition, -> { Square::Types::CustomAttributeDefinition }, optional: false, nullable: false
           field :idempotency_key, -> { String }, optional: true, nullable: false
         end
       end

data/lib/square/customers/custom_attribute_definitions/types/update_customer_custom_attribute_definition_request.rb

@@ -6,9 +6,7 @@ module Square
       module Types
         class UpdateCustomerCustomAttributeDefinitionRequest < Internal::Types::Model
           field :key, -> { String }, optional: false, nullable: false
-          field :custom_attribute_definition, lambda {
-            Square::Types::CustomAttributeDefinition
-          }, optional: false, nullable: false
+          field :custom_attribute_definition, -> { Square::Types::CustomAttributeDefinition }, optional: false, nullable: false
           field :idempotency_key, -> { String }, optional: true, nullable: false
         end
       end

data/lib/square/customers/custom_attributes/client.rb

@@ -4,7 +4,9 @@ module Square
   module Customers
     module CustomAttributes
       class Client
-        # @return [Square::Customers::CustomAttributes::Client]
+        # @param client [Square::Internal::Http::RawClient]
+        #
+        # @return [void]
         def initialize(client:)
           @client = client
         end
@@ -18,32 +20,53 @@ module Square
         # visible to the requesting application, including those that are owned by other applications
         # and set to `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.
         #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :customer_id
+        # @option params [Integer, nil] :limit
+        # @option params [String, nil] :cursor
+        # @option params [Boolean, nil] :with_definitions
+        #
         # @return [Square::Types::ListCustomerCustomAttributesResponse]
         def list(request_options: {}, **params)
-          _query_param_names = [
-            %w[limit cursor with_definitions],
-            %i[limit cursor with_definitions]
-          ].flatten
-          _query = params.slice(*_query_param_names)
-          params = params.except(*_query_param_names)
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          query_param_names = %i[limit cursor with_definitions]
+          query_params = {}
+          query_params["limit"] = params[:limit] if params.key?(:limit)
+          query_params["cursor"] = params[:cursor] if params.key?(:cursor)
+          query_params["with_definitions"] = params[:with_definitions] if params.key?(:with_definitions)
+          params = params.except(*query_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
-            method: "GET",
-            path: "v2/customers/#{params[:customer_id]}/custom-attributes",
-            query: _query
-          )
-          begin
-            _response = @client.send(_request)
-          rescue Net::HTTPRequestTimeout
-            raise Square::Errors::TimeoutError
-          end
-          code = _response.code.to_i
-          if code.between?(200, 299)
-            Square::Types::ListCustomerCustomAttributesResponse.load(_response.body)
-          else
-            error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+          Square::Internal::CursorItemIterator.new(
+            cursor_field: :cursor,
+            item_field: :custom_attributes,
+            initial_cursor: query_params[:cursor]
+          ) do |next_cursor|
+            query_params[:cursor] = next_cursor
+            request = Square::Internal::JSON::Request.new(
+              base_url: request_options[:base_url],
+              method: "GET",
+              path: "v2/customers/#{params[:customer_id]}/custom-attributes",
+              query: query_params,
+              request_options: request_options
+            )
+            begin
+              response = @client.send(request)
+            rescue Net::HTTPRequestTimeout
+              raise Square::Errors::TimeoutError
+            end
+            code = response.code.to_i
+            if code.between?(200, 299)
+              Square::Types::ListCustomerCustomAttributesResponse.load(response.body)
+            else
+              error_class = Square::Errors::ResponseError.subclass_for_code(code)
+              raise error_class.new(response.body, code: code)
+            end
           end
         end
 
@@ -56,32 +79,45 @@ module Square
         # `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`. Note that seller-defined custom attributes
         # (also known as custom fields) are always set to `VISIBILITY_READ_WRITE_VALUES`.
         #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :customer_id
+        # @option params [String] :key
+        # @option params [Boolean, nil] :with_definition
+        # @option params [Integer, nil] :version
+        #
         # @return [Square::Types::GetCustomerCustomAttributeResponse]
         def get(request_options: {}, **params)
-          _query_param_names = [
-            %w[with_definition version],
-            %i[with_definition version]
-          ].flatten
-          _query = params.slice(*_query_param_names)
-          params = params.except(*_query_param_names)
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          query_param_names = %i[with_definition version]
+          query_params = {}
+          query_params["with_definition"] = params[:with_definition] if params.key?(:with_definition)
+          query_params["version"] = params[:version] if params.key?(:version)
+          params = params.except(*query_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "GET",
             path: "v2/customers/#{params[:customer_id]}/custom-attributes/#{params[:key]}",
-            query: _query
+            query: query_params,
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::GetCustomerCustomAttributeResponse.load(_response.body)
+            Square::Types::GetCustomerCustomAttributeResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
 
@@ -89,33 +125,49 @@ module Square
         #
         # Use this endpoint to set the value of a custom attribute for a specified customer profile.
         # A custom attribute is based on a custom attribute definition in a Square seller account, which
-        # is created using the [CreateCustomerCustomAttributeDefinition](api-endpoint:CustomerCustomAttributes-CreateCustomerCustomAttributeDefinition) endpoint.
+        # is created using the
+        # [CreateCustomerCustomAttributeDefinition](api-endpoint:CustomerCustomAttributes-CreateCustomerCustomAttributeDefinition)
+        # endpoint.
         #
         # To create or update a custom attribute owned by another application, the `visibility` setting
         # must be `VISIBILITY_READ_WRITE_VALUES`. Note that seller-defined custom attributes
         # (also known as custom fields) are always set to `VISIBILITY_READ_WRITE_VALUES`.
         #
+        # @param request_options [Hash]
+        # @param params [Square::Customers::CustomAttributes::Types::UpsertCustomerCustomAttributeRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :customer_id
+        # @option params [String] :key
+        #
         # @return [Square::Types::UpsertCustomerCustomAttributeResponse]
         def upsert(request_options: {}, **params)
-          _path_param_names = %w[customer_id key]
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request_data = Square::Customers::CustomAttributes::Types::UpsertCustomerCustomAttributeRequest.new(params).to_h
+          non_body_param_names = %w[customer_id key]
+          body = request_data.except(*non_body_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "POST",
             path: "v2/customers/#{params[:customer_id]}/custom-attributes/#{params[:key]}",
-            body: params.except(*_path_param_names)
+            body: body,
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::UpsertCustomerCustomAttributeResponse.load(_response.body)
+            Square::Types::UpsertCustomerCustomAttributeResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
 
@@ -125,24 +177,36 @@ module Square
         # `VISIBILITY_READ_WRITE_VALUES`. Note that seller-defined custom attributes
         # (also known as custom fields) are always set to `VISIBILITY_READ_WRITE_VALUES`.
         #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :customer_id
+        # @option params [String] :key
+        #
         # @return [Square::Types::DeleteCustomerCustomAttributeResponse]
         def delete(request_options: {}, **params)
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request = Square::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
             method: "DELETE",
-            path: "v2/customers/#{params[:customer_id]}/custom-attributes/#{params[:key]}"
+            path: "v2/customers/#{params[:customer_id]}/custom-attributes/#{params[:key]}",
+            request_options: request_options
           )
           begin
-            _response = @client.send(_request)
+            response = @client.send(request)
           rescue Net::HTTPRequestTimeout
             raise Square::Errors::TimeoutError
           end
-          code = _response.code.to_i
+          code = response.code.to_i
           if code.between?(200, 299)
-            Square::Types::DeleteCustomerCustomAttributeResponse.load(_response.body)
+            Square::Types::DeleteCustomerCustomAttributeResponse.load(response.body)
           else
             error_class = Square::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(_response.body, code: code)
+            raise error_class.new(response.body, code: code)
           end
         end
       end