square.rb 5.0.0.20200226 → 5.3.0.20200528

data/lib/square/api/orders_api.rb

@@ -157,6 +157,38 @@ module Square
       ApiResponse.new(_response, data: decoded, errors: _errors)
     end
 
+    # Calculates an [Order](#type-order).
+    # @param [CalculateOrderRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CalculateOrderResponse Hash] response from the API call
+    def calculate_order(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/orders/calculate'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
     # Search all orders for one or more locations. Orders include all sales,
     # returns, and exchanges regardless of how or when they entered the Square
     # Ecosystem (e.g. Point of Sale, Invoices, Connect APIs, etc).

data/lib/square/api/payments_api.rb

@@ -127,7 +127,7 @@ module Square
     # In this case, you can
     # direct Square to cancel the payment using this endpoint. In the request,
     # you provide the same
-    # idempotency key that you provided in your CreatePayment request you want
+    # idempotency key that you provided in your CreatePayment request you want 
     # to cancel. After
     # cancelling the payment, you can submit your CreatePayment request again.
     # Note that if no payment with the specified idempotency key is found, no
@@ -246,8 +246,12 @@ module Square
     # elayed-payments).
     # @param [String] payment_id Required parameter: Unique ID identifying the
     # payment to be completed.
+    # @param [Object] body Required parameter: An object containing the fields
+    # to POST for the request.  See the corresponding object definition for
+    # field details.
     # @return [CompletePaymentResponse Hash] response from the API call
-    def complete_payment(payment_id:)
+    def complete_payment(payment_id:,
+                         body:)
       # Prepare query url.
       _query_builder = config.get_base_uri
       _query_builder << '/v2/payments/{payment_id}/complete'
@@ -259,13 +263,15 @@ module Square
 
       # Prepare headers.
       _headers = {
-        'accept' => 'application/json'
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
       }
 
       # Prepare and execute HttpRequest.
       _request = config.http_client.post(
         _query_url,
-        headers: _headers
+        headers: _headers,
+        parameters: body.to_json
       )
       OAuth2.apply(config, _request)
       _response = execute_request(_request)

data/lib/square/api/terminal_api.rb

@@ -0,0 +1,141 @@
+module Square
+  # TerminalApi
+  class TerminalApi < BaseApi
+    def initialize(config, http_call_back: nil)
+      super(config, http_call_back: http_call_back)
+    end
+
+    # Creates a new Terminal checkout request and sends it to the specified
+    # device to take a payment for the requested amount.
+    # @param [CreateTerminalCheckoutRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CreateTerminalCheckoutResponse Hash] response from the API call
+    def create_terminal_checkout(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/terminals/checkouts'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Retrieves a filtered list of Terminal checkout requests created by the
+    # account making the request.
+    # @param [SearchTerminalCheckoutsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [SearchTerminalCheckoutsResponse Hash] response from the API call
+    def search_terminal_checkouts(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/terminals/checkouts/search'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Retrieves a Terminal checkout request by checkout_id.
+    # @param [String] checkout_id Required parameter: Unique ID for the desired
+    # `TerminalCheckout`
+    # @return [GetTerminalCheckoutResponse Hash] response from the API call
+    def get_terminal_checkout(checkout_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/terminals/checkouts/{checkout_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'checkout_id' => checkout_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url,
+        headers: _headers
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Cancels a Terminal checkout request, if the status of the request permits
+    # it.
+    # @param [String] checkout_id Required parameter: Unique ID for the desired
+    # `TerminalCheckout`
+    # @return [CancelTerminalCheckoutResponse Hash] response from the API call
+    def cancel_terminal_checkout(checkout_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/terminals/checkouts/{checkout_id}/cancel'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'checkout_id' => checkout_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+  end
+end

data/lib/square/client.rb

@@ -4,11 +4,11 @@ module Square
     attr_reader :config
 
     def sdk_version
-      '5.0.0.20200226'
+      '5.3.0.20200528'
     end
 
     def square_version
-      '2020-02-26'
+      '2020-05-28'
     end
 
     # Access to mobile_authorization controller.
@@ -77,6 +77,24 @@ module Square
       @customers ||= CustomersApi.new config
     end
 
+    # Access to customer_groups controller.
+    # @return [CustomerGroupsApi] Returns the controller instance.
+    def customer_groups
+      @customer_groups ||= CustomerGroupsApi.new config
+    end
+
+    # Access to customer_segments controller.
+    # @return [CustomerSegmentsApi] Returns the controller instance.
+    def customer_segments
+      @customer_segments ||= CustomerSegmentsApi.new config
+    end
+
+    # Access to devices controller.
+    # @return [DevicesApi] Returns the controller instance.
+    def devices
+      @devices ||= DevicesApi.new config
+    end
+
     # Access to disputes controller.
     # @return [DisputesApi] Returns the controller instance.
     def disputes
@@ -131,6 +149,12 @@ module Square
       @transactions ||= TransactionsApi.new config
     end
 
+    # Access to loyalty controller.
+    # @return [LoyaltyApi] Returns the controller instance.
+    def loyalty
+      @loyalty ||= LoyaltyApi.new config
+    end
+
     # Access to merchants controller.
     # @return [MerchantsApi] Returns the controller instance.
     def merchants
@@ -149,6 +173,12 @@ module Square
       @refunds ||= RefundsApi.new config
     end
 
+    # Access to terminal controller.
+    # @return [TerminalApi] Returns the controller instance.
+    def terminal
+      @terminal ||= TerminalApi.new config
+    end
+
     def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
                    backoff_factor: 1, environment: 'production',
                    access_token: 'TODO: Replace', additional_headers: {},

data/lib/square/configuration.rb

@@ -36,7 +36,7 @@ module Square
       @backoff_factor = backoff_factor
 
       # Current API environment
-      @environment = environment
+      @environment = String(environment)
 
       # OAuth 2.0 Access Token
       @access_token = access_token
@@ -73,21 +73,21 @@ module Square
     end
 
     # All the environments the SDK can run in.
-    @environments = {
+    ENVIRONMENTS = {
       'production' => {
         'default' => 'https://connect.squareup.com'
       },
       'sandbox' => {
         'default' => 'https://connect.squareupsandbox.com'
       }
-    }
+    }.freeze
 
     # Generates the appropriate base URI for the environment and the server.
     # @param [Configuration::Server] The server enum for which the base URI is
     # required.
     # @return [String] The base URI.
     def get_base_uri(server = 'default')
-      self.class.environments[environment][server].clone
+      ENVIRONMENTS[environment][server].clone
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 5.0.0.20200226
+  version: 5.3.0.20200528
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-26 00:00:00.000000000 Z
+date: 2020-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logging
@@ -124,12 +124,16 @@ files:
 - lib/square/api/cash_drawers_api.rb
 - lib/square/api/catalog_api.rb
 - lib/square/api/checkout_api.rb
+- lib/square/api/customer_groups_api.rb
+- lib/square/api/customer_segments_api.rb
 - lib/square/api/customers_api.rb
+- lib/square/api/devices_api.rb
 - lib/square/api/disputes_api.rb
 - lib/square/api/employees_api.rb
 - lib/square/api/inventory_api.rb
 - lib/square/api/labor_api.rb
 - lib/square/api/locations_api.rb
+- lib/square/api/loyalty_api.rb
 - lib/square/api/merchants_api.rb
 - lib/square/api/mobile_authorization_api.rb
 - lib/square/api/o_auth_api.rb
@@ -137,6 +141,7 @@ files:
 - lib/square/api/payments_api.rb
 - lib/square/api/refunds_api.rb
 - lib/square/api/reporting_api.rb
+- lib/square/api/terminal_api.rb
 - lib/square/api/transactions_api.rb
 - lib/square/api/v1_employees_api.rb
 - lib/square/api/v1_items_api.rb
@@ -186,7 +191,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: square