square.rb 44.2.0.20251016 → 45.0.1.20260122

data/lib/square/checkout/payment_links/client.rb

@@ -4,86 +4,128 @@ module Square
   module Checkout
     module PaymentLinks
       class Client
-        # @return [Square::Checkout::PaymentLinks::Client]
+        # @param client [Square::Internal::Http::RawClient]
+        #
+        # @return [void]
         def initialize(client:)
           @client = client
         end
 
         # Lists all payment links.
         #
+        # @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, nil] :cursor
+        # @option params [Integer, nil] :limit
+        #
         # @return [Square::Types::ListPaymentLinksResponse]
         def list(request_options: {}, **params)
-          _query_param_names = [
-            %w[cursor limit],
-            %i[cursor limit]
-          ].flatten
-          _query = params.slice(*_query_param_names)
-          params.except(*_query_param_names)
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          query_param_names = %i[cursor limit]
+          query_params = {}
+          query_params["cursor"] = params[:cursor] if params.key?(:cursor)
+          query_params["limit"] = params[:limit] if params.key?(:limit)
+          params.except(*query_param_names)
 
-          _request = Square::Internal::JSON::Request.new(
-            base_url: request_options[:base_url] || Square::Environment::PRODUCTION,
-            method: "GET",
-            path: "v2/online-checkout/payment-links",
-            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::ListPaymentLinksResponse.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: :payment_links,
+            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/online-checkout/payment-links",
+              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::ListPaymentLinksResponse.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 Square-hosted checkout page. Applications can share the resulting payment link with their buyer to pay for goods and services.
+        # Creates a Square-hosted checkout page. Applications can share the resulting payment link with their buyer to
+        # pay for goods and services.
+        #
+        # @param request_options [Hash]
+        # @param params [Square::Checkout::PaymentLinks::Types::CreatePaymentLinkRequest]
+        # @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::CreatePaymentLinkResponse]
         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/online-checkout/payment-links",
-            body: params
+            body: Square::Checkout::PaymentLinks::Types::CreatePaymentLinkRequest.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::CreatePaymentLinkResponse.load(_response.body)
+            Square::Types::CreatePaymentLinkResponse.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 payment link.
         #
+        # @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] :id
+        #
         # @return [Square::Types::GetPaymentLinkResponse]
         def get(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: "GET",
-            path: "v2/online-checkout/payment-links/#{params[:id]}"
+            path: "v2/online-checkout/payment-links/#{params[:id]}",
+            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::GetPaymentLinkResponse.load(_response.body)
+            Square::Types::GetPaymentLinkResponse.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
 
@@ -91,50 +133,74 @@ module Square
         # `description`, `checkout_options`, and  `pre_populated_data`.
         # You cannot update other fields such as the `order_id`, `version`, `URL`, or `timestamp` field.
         #
+        # @param request_options [Hash]
+        # @param params [Square::Checkout::PaymentLinks::Types::UpdatePaymentLinkRequest]
+        # @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] :id
+        #
         # @return [Square::Types::UpdatePaymentLinkResponse]
         def update(request_options: {}, **params)
-          _path_param_names = ["id"]
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request_data = Square::Checkout::PaymentLinks::Types::UpdatePaymentLinkRequest.new(params).to_h
+          non_body_param_names = ["id"]
+          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/online-checkout/payment-links/#{params[:id]}",
-            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::UpdatePaymentLinkResponse.load(_response.body)
+            Square::Types::UpdatePaymentLinkResponse.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 payment link.
         #
+        # @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] :id
+        #
         # @return [Square::Types::DeletePaymentLinkResponse]
         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/online-checkout/payment-links/#{params[:id]}"
+            path: "v2/online-checkout/payment-links/#{params[:id]}",
+            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::DeletePaymentLinkResponse.load(_response.body)
+            Square::Types::DeletePaymentLinkResponse.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/client.rb

@@ -2,23 +2,21 @@
 
 module Square
   class Client
-    # @return [Square::Client]
-    def initialize(base_url:, token: ENV.fetch("SQUARE_TOKEN", nil))
+    # @param base_url [String, nil]
+    # @param token [String]
+    #
+    # @return [void]
+    def initialize(base_url: nil, token: ENV.fetch("SQUARE_TOKEN", nil))
       @raw_client = Square::Internal::Http::RawClient.new(
-        base_url: base_url,
+        base_url: base_url || Square::Environment::PRODUCTION,
         headers: {
-          "User-Agent": "square.rb/44.2.0.20251016",
-          "X-Fern-Language": "Ruby",
+          "User-Agent" => "square.rb/45.0.1.20260122",
+          "X-Fern-Language" => "Ruby",
           Authorization: "Bearer #{token}"
         }
       )
     end
 
-    # @return [Square::Mobile::Client]
-    def mobile
-      @mobile ||= Square::Mobile::Client.new(client: @raw_client)
-    end
-
     # @return [Square::OAuth::Client]
     def o_auth
       @o_auth ||= Square::OAuth::Client.new(client: @raw_client)

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

@@ -4,7 +4,9 @@ module Square
   module Customers
     module Cards
       class Client
-        # @return [Square::Customers::Cards::Client]
+        # @param client [Square::Internal::Http::RawClient]
+        #
+        # @return [void]
         def initialize(client:)
           @client = client
         end
@@ -15,50 +17,75 @@ module Square
         # calls with the same card nonce return the same card record that was created
         # with the provided nonce during the _first_ call.
         #
+        # @param request_options [Hash]
+        # @param params [Square::Customers::Cards::Types::CreateCustomerCardRequest]
+        # @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
+        #
         # @return [Square::Types::CreateCustomerCardResponse]
         def create(request_options: {}, **params)
-          _path_param_names = ["customer_id"]
+          params = Square::Internal::Types::Utils.normalize_keys(params)
+          request_data = Square::Customers::Cards::Types::CreateCustomerCardRequest.new(params).to_h
+          non_body_param_names = ["customer_id"]
+          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]}/cards",
-            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::CreateCustomerCardResponse.load(_response.body)
+            Square::Types::CreateCustomerCardResponse.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
 
         # Removes a card on file from a customer.
         #
+        # @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] :card_id
+        #
         # @return [Square::Types::DeleteCustomerCardResponse]
         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]}/cards/#{params[:card_id]}"
+            path: "v2/customers/#{params[:customer_id]}/cards/#{params[:card_id]}",
+            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::DeleteCustomerCardResponse.load(_response.body)
+            Square::Types::DeleteCustomerCardResponse.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