square.rb 34.0.0.20231115 → 34.1.0.20231213

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 782b164931df9b858596a44072900426a8602cdf90bb151d91e456c3ce0bf000
-  data.tar.gz: 3f42b29aff8f32c74bb59d48d358a8ffab6fa668e1ce79d1e737850c3f9f1eb1
+  metadata.gz: b29bc50c5ee5bebc08ff29a066e77f35975336e71bbdad94416f59c58f4863f0
+  data.tar.gz: 4257fabf7ea4d1b49198744a53206ff4a6d21724267701c199a9ea7a7b58b734
 SHA512:
-  metadata.gz: 931a8f0def1a0eda533df2cbeca7407c76e9e4d16c8086e12fcde25b0ad3f4cc547dad95b14b4c243cbf9ccee7bd99e11f45733286a9856fe723a509b21dd2d8
-  data.tar.gz: 1a3e3acb369443df965fb5447d650368a93cba33a9a5439cfb48ae0ba425b86915366eb64027656fcb406081462e20b1e48b3d8b6428d7fb1c553eab04654cdd
+  metadata.gz: aa095d1d8cc6d0e8e7a84321bb9158dccb291105237a8b080c9033b946c314183c7c74e01467ba6f2c2e12684b45baaad28e33a55ebdf3395f2a2268b81410e8
+  data.tar.gz: f75abe542aef5e60c7166d9fd22db64db1d0f67e53fc2015e07a399624ba7575a161045a1858c1df46e61194bcbca75c21db8e647a26b46143fecbf0d9b4b9aa

data/lib/square/api/base_api.rb

@@ -4,7 +4,7 @@ module Square
     attr_accessor :config, :http_call_back
 
     def self.user_agent
-      'Square-Ruby-SDK/34.0.0.20231115 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
+      'Square-Ruby-SDK/34.1.0.20231213 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
     end
 
     def self.user_agent_parameters

data/lib/square/api/catalog_api.rb

@@ -328,10 +328,19 @@ module Square
     # of an object can be found in the version field of
     # [CatalogObject]($m/CatalogObject)s. If not included, results will be from
     # the current version of the catalog.
+    # @param [TrueClass | FalseClass] include_category_path_to_root Optional
+    # parameter: Specifies whether or not to include the `path_to_root` list for
+    # each returned category instance. The `path_to_root` list consists of
+    # `CategoryPathToRootNode` objects and specifies the path that starts with
+    # the immediate parent category of the returned category and ends with its
+    # root category. If the returned category is a top-level category, the
+    # `path_to_root` list is empty and is not returned in the response
+    # payload.
     # @return [RetrieveCatalogObjectResponse Hash] response from the API call
     def retrieve_catalog_object(object_id:,
                                 include_related_objects: false,
-                                catalog_version: nil)
+                                catalog_version: nil,
+                                include_category_path_to_root: false)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/catalog/object/{object_id}',
@@ -340,6 +349,7 @@ module Square
                                     .should_encode(true))
                    .query_param(new_parameter(include_related_objects, key: 'include_related_objects'))
                    .query_param(new_parameter(catalog_version, key: 'catalog_version'))
+                   .query_param(new_parameter(include_category_path_to_root, key: 'include_category_path_to_root'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('global')))
         .response(new_response_handler

data/lib/square/api/checkout_api.rb

@@ -35,6 +35,91 @@ module Square
         .execute
     end
 
+    # Retrieves the location-level settings for a Square-hosted checkout page.
+    # @param [String] location_id Required parameter: The ID of the location for
+    # which to retrieve settings.
+    # @return [RetrieveLocationSettingsResponse Hash] response from the API call
+    def retrieve_location_settings(location_id:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v2/online-checkout/location-settings/{location_id}',
+                                     'default')
+                   .template_param(new_parameter(location_id, key: 'location_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
+    # Updates the location-level settings for a Square-hosted checkout page.
+    # @param [String] location_id Required parameter: The ID of the location for
+    # which to retrieve settings.
+    # @param [UpdateLocationSettingsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [UpdateLocationSettingsResponse Hash] response from the API call
+    def update_location_settings(location_id:,
+                                 body:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/v2/online-checkout/location-settings/{location_id}',
+                                     'default')
+                   .template_param(new_parameter(location_id, key: 'location_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
+    # Retrieves the merchant-level settings for a Square-hosted checkout page.
+    # @return [RetrieveMerchantSettingsResponse Hash] response from the API call
+    def retrieve_merchant_settings
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v2/online-checkout/merchant-settings',
+                                     'default')
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
+    # Updates the merchant-level settings for a Square-hosted checkout page.
+    # @param [UpdateMerchantSettingsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [UpdateMerchantSettingsResponse Hash] response from the API call
+    def update_merchant_settings(body:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/v2/online-checkout/merchant-settings',
+                                     'default')
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
     # Lists all payment links.
     # @param [String] cursor Optional parameter: A pagination cursor returned by
     # a previous call to this endpoint. Provide this cursor to retrieve the next

data/lib/square/api/terminal_api.rb

@@ -94,7 +94,7 @@ module Square
     # Actions](https://developer.squareup.com/docs/terminal-api/advanced-feature
     # s/custom-workflows/link-and-dismiss-actions) for more details.
     # @param [String] action_id Required parameter: Unique ID for the
-    # `TerminalAction` associated with the waiting dialog to be dismissed.
+    # `TerminalAction` associated with the action to be dismissed.
     # @return [DismissTerminalActionResponse Hash] response from the API call
     def dismiss_terminal_action(action_id:)
       new_api_call_builder
@@ -203,6 +203,27 @@ module Square
         .execute
     end
 
+    # Dismisses a Terminal checkout request if the status and type of the
+    # request permits it.
+    # @param [String] checkout_id Required parameter: Unique ID for the
+    # `TerminalCheckout` associated with the checkout to be dismissed.
+    # @return [DismissTerminalCheckoutResponse Hash] response from the API call
+    def dismiss_terminal_checkout(checkout_id:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v2/terminals/checkouts/{checkout_id}/dismiss',
+                                     'default')
+                   .template_param(new_parameter(checkout_id, key: 'checkout_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
     # Creates a request to refund an Interac payment completed on a Square
     # Terminal. Refunds for Interac payments on a Square Terminal are supported
     # only for Interac debit cards in Canada. Other refunds for Terminal
@@ -294,5 +315,26 @@ module Square
                    .convertor(ApiResponse.method(:create)))
         .execute
     end
+
+    # Dismisses a Terminal refund request if the status and type of the request
+    # permits it.
+    # @param [String] terminal_refund_id Required parameter: Unique ID for the
+    # `TerminalRefund` associated with the refund to be dismissed.
+    # @return [DismissTerminalRefundResponse Hash] response from the API call
+    def dismiss_terminal_refund(terminal_refund_id:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v2/terminals/refunds/{terminal_refund_id}/dismiss',
+                                     'default')
+                   .template_param(new_parameter(terminal_refund_id, key: 'terminal_refund_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
   end
 end

data/lib/square/client.rb

@@ -4,7 +4,7 @@ module Square
     attr_reader :config, :auth_managers
 
     def sdk_version
-      '34.0.0.20231115'
+      '34.1.0.20231213'
     end
 
     def square_version
@@ -267,7 +267,7 @@ module Square
                    retry_methods: %i[get put], http_callback: nil,
                    environment: 'production',
                    custom_url: 'https://connect.squareup.com', access_token: '',
-                   square_version: '2023-11-15', user_agent_detail: '',
+                   square_version: '2023-12-13', user_agent_detail: '',
                    additional_headers: {}, config: nil)
       @config = if config.nil?
                   Configuration.new(connection: connection, adapter: adapter,

data/lib/square/configuration.rb

@@ -19,7 +19,7 @@ module Square
                    retry_methods: %i[get put], http_callback: nil,
                    environment: 'production',
                    custom_url: 'https://connect.squareup.com', access_token: '',
-                   square_version: '2023-11-15', user_agent_detail: '',
+                   square_version: '2023-12-13', user_agent_detail: '',
                    additional_headers: {})
 
       super connection: connection, adapter: adapter, timeout: timeout,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 34.0.0.20231115
+  version: 34.1.0.20231213
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-15 00:00:00.000000000 Z
+date: 2023-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: apimatic_core_interfaces