square.rb 5.2.2.20200422 → 5.3.0.20200528

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cb76727d70686f42bfdb4822a48a4e94f9266c706eace4beee4ae31665f651a
-  data.tar.gz: cf8261b678b0f8c9c0f5016f8f679d56969f7c4b23598580d3fbb055c4211ce1
+  metadata.gz: 4df584cf8656280c84a929e33d017ae45261bb30afdfed941a8e7c775995ea45
+  data.tar.gz: c87a6cbd1d57921bc3b3251135ebdc40d02dd007d16a59bab366e6f10123b8eb
 SHA512:
-  metadata.gz: 8848dab1cc5f701fe8f3cf49ae510c7f016b9422af39bb63e7b24aa16bc9559a8fd4c135eb57d94d6d9d9ec520311df3376f929bae4677e99dfb3f54560a9de0
-  data.tar.gz: 0e33550b5db4f37e88d7341abdad8c515be1f2f1963e4b479d99bd115091f6f21f75684afbc66d1b70ad6e0e63aefd33f40557ea21bf4a05a1976a67e58bae3c
+  metadata.gz: c5acce30bed99da12a50425ee308932eeab669e3791a5f849224f49a2ffa3dc91bcdbff296a011f21d2c03d31104a6bfbf5d5f11da93658c44d270db9e21b85a
+  data.tar.gz: 063afe2bce7b09d25bfe6941c63de99d03ededbea209f67cba6e89096f573650c099e76486d69a39466c639a58b20afccbc330a3ef5231eeeeafa9892bcdcb03

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2019 Square, Inc.
+Copyright 2020 Square, Inc.
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

data/lib/square.rb

@@ -52,6 +52,7 @@ require_relative 'square/api/reporting_api.rb'
 require_relative 'square/api/checkout_api.rb'
 require_relative 'square/api/orders_api.rb'
 require_relative 'square/api/transactions_api.rb'
+require_relative 'square/api/loyalty_api.rb'
 require_relative 'square/api/merchants_api.rb'
 require_relative 'square/api/payments_api.rb'
 require_relative 'square/api/refunds_api.rb'

data/lib/square/api/base_api.rb

@@ -8,8 +8,8 @@ module Square
       @http_call_back = http_call_back
 
       @global_headers = {
-        'user-agent' => 'Square-Ruby-SDK/5.2.2.20200422',
-        'Square-Version' => '2020-04-22'
+        'user-agent' => 'Square-Ruby-SDK/5.3.0.20200528',
+        'Square-Version' => '2020-05-28'
       }
     end
 

data/lib/square/api/customers_api.rb

@@ -5,7 +5,13 @@ module Square
       super(config, http_call_back: http_call_back)
     end
 
-    # Lists a business's customers.
+    # Lists customer profiles associated with a Square account.
+    # Under normal operating conditions, newly created or updated customer
+    # profiles become available
+    # for the listing operation in well under 30 seconds. Occasionally,
+    # propagation of the new or updated
+    # profiles can take closer to one minute or longer, espeically during
+    # network incidents and outages.
     # @param [String] cursor Optional parameter: A pagination cursor returned by
     # a previous call to this endpoint. Provide this to retrieve the next set of
     # results for your original query.  See the [Pagination
@@ -91,10 +97,17 @@ module Square
       ApiResponse.new(_response, data: decoded, errors: _errors)
     end
 
-    # Searches the customer profiles associated with a Square account.
-    # Calling SearchCustomers without an explicit query parameter returns all
+    # Searches the customer profiles associated with a Square account using
+    # one or more supported query filters.
+    # Calling `SearchCustomers` without any explicit query filter returns all
     # customer profiles ordered alphabetically based on `given_name` and
     # `family_name`.
+    # Under normal operating conditions, newly created or updated customer
+    # profiles become available
+    # for the search operation in well under 30 seconds. Occasionally,
+    # propagation of the new or updated
+    # profiles can take closer to one minute or longer, espeically during
+    # network incidents and outages.
     # @param [SearchCustomersRequest] body Required parameter: An object
     # containing the fields to POST for the request.  See the corresponding
     # object definition for field details.

data/lib/square/api/loyalty_api.rb

@@ -0,0 +1,543 @@
+module Square
+  # LoyaltyApi
+  class LoyaltyApi < BaseApi
+    def initialize(config, http_call_back: nil)
+      super(config, http_call_back: http_call_back)
+    end
+
+    # Creates a loyalty account. For more information, see
+    # [Create a loyalty
+    # account](https://developer.squareup.com/docs/docs/loyalty-api/overview/#lo
+    # yalty-overview-create-account).
+    # @param [CreateLoyaltyAccountRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CreateLoyaltyAccountResponse Hash] response from the API call
+    def create_loyalty_account(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/accounts'
+      _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
+
+    # Searches for loyalty accounts.
+    # In the current implementation, you can search for a loyalty account using
+    # the phone number associated with the account.
+    # If no phone number is provided, all loyalty accounts are returned.
+    # @param [SearchLoyaltyAccountsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [SearchLoyaltyAccountsResponse Hash] response from the API call
+    def search_loyalty_accounts(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/accounts/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 loyalty account.
+    # @param [String] account_id Required parameter: The ID of the [loyalty
+    # account](#type-LoyaltyAccount) to retrieve.
+    # @return [RetrieveLoyaltyAccountResponse Hash] response from the API call
+    def retrieve_loyalty_account(account_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/accounts/{account_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'account_id' => account_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
+
+    # Adds points to a loyalty account.
+    # - If you are using the Orders API to manage orders, you only provide the
+    # `order_id`.
+    # The endpoint reads the order to compute points to add to the buyer's
+    # account.
+    # - If you are not using the Orders API to manage orders,
+    # you first perform a client-side computation to compute the points.
+    # For spend-based and visit-based programs, you can call
+    # `CalculateLoyaltyPoints` to compute the points. For more information,
+    # see [Loyalty Program
+    # Overview](https://developer.squareup.com/docs/docs/loyalty/overview).
+    # You then provide the points in a request to this endpoint.
+    # For more information, see [Accumulate
+    # points](https://developer.squareup.com/docs/docs/loyalty-api/overview/#acc
+    # umulate-points).
+    # @param [String] account_id Required parameter: The [loyalty
+    # account](#type-LoyaltyAccount) ID to which to add the points.
+    # @param [AccumulateLoyaltyPointsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [AccumulateLoyaltyPointsResponse Hash] response from the API call
+    def accumulate_loyalty_points(account_id:,
+                                  body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/accounts/{account_id}/accumulate'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'account_id' => account_id
+      )
+      _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
+
+    # Adds points to or subtracts points from a buyer's account.
+    # Use this endpoint only when you need to manually adjust points. Otherwise,
+    # in your application flow, you call
+    # [AccumulateLoyaltyPoints](https://developer.squareup.com/docs/reference/sq
+    # uare/loyalty-api/accumulate-loyalty-points)
+    # to add points when a buyer pays for the purchase.
+    # @param [String] account_id Required parameter: The ID of the [loyalty
+    # account](#type-LoyaltyAccount) in which to adjust the points.
+    # @param [AdjustLoyaltyPointsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [AdjustLoyaltyPointsResponse Hash] response from the API call
+    def adjust_loyalty_points(account_id:,
+                              body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/accounts/{account_id}/adjust'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'account_id' => account_id
+      )
+      _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
+
+    # Searches for loyalty events.
+    # A Square loyalty program maintains a ledger of events that occur during
+    # the lifetime of a
+    # buyer's loyalty account. Each change in the point balance
+    # (for example, points earned, points redeemed, and points expired) is
+    # recorded in the ledger. Using this endpoint, you can search the ledger for
+    # events.
+    # For more information, see
+    # [Loyalty
+    # events](https://developer.squareup.com/docs/docs/loyalty-api/overview/#loy
+    # alty-events).
+    # @param [SearchLoyaltyEventsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [SearchLoyaltyEventsResponse Hash] response from the API call
+    def search_loyalty_events(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/events/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
+
+    # Returns a list of loyalty programs in the seller's account.
+    # Currently, a seller can only have one loyalty program. For more
+    # information, see
+    # [Loyalty
+    # Overview](https://developer.squareup.com/docs/docs/loyalty/overview).
+    # .
+    # @return [ListLoyaltyProgramsResponse Hash] response from the API call
+    def list_loyalty_programs
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/programs'
+      _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
+
+    # Calculates the points a purchase earns.
+    # - If you are using the Orders API to manage orders, you provide `order_id`
+    # in the request. The
+    # endpoint calculates the points by reading the order.
+    # - If you are not using the Orders API to manage orders, you provide the
+    # purchase amount in
+    # the request for the endpoint to calculate the points.
+    # An application might call this endpoint to show the points that a buyer
+    # can earn with the
+    # specific purchase.
+    # @param [String] program_id Required parameter: The [loyalty
+    # program](#type-LoyaltyProgram) ID, which defines the rules for accruing
+    # points.
+    # @param [CalculateLoyaltyPointsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CalculateLoyaltyPointsResponse Hash] response from the API call
+    def calculate_loyalty_points(program_id:,
+                                 body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/programs/{program_id}/calculate'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'program_id' => program_id
+      )
+      _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
+
+    # Creates a loyalty reward. In the process, the endpoint does following:
+    # - Uses the `reward_tier_id` in the request to determine the number of
+    # points
+    # to lock for this reward.
+    # - If the request includes `order_id`, it adds the reward and related
+    # discount to the order.
+    # After a reward is created, the points are locked and
+    # not available for the buyer to redeem another reward.
+    # For more information, see
+    # [Loyalty
+    # rewards](https://developer.squareup.com/docs/docs/loyalty-api/overview/#lo
+    # yalty-overview-loyalty-rewards).
+    # @param [CreateLoyaltyRewardRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CreateLoyaltyRewardResponse Hash] response from the API call
+    def create_loyalty_reward(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/rewards'
+      _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
+
+    # Searches for loyalty rewards in a loyalty account.
+    # In the current implementation, the endpoint supports search by the reward
+    # `status`.
+    # If you know a reward ID, use the
+    # [RetrieveLoyaltyReward](https://developer.squareup.com/docs/reference/squa
+    # re/loyalty-api/retrieve-loyalty-reward) endpoint.
+    # For more information about loyalty rewards, see
+    # [Loyalty
+    # Rewards](https://developer.squareup.com/docs/docs/loyalty-api/overview/#lo
+    # yalty-rewards).
+    # @param [SearchLoyaltyRewardsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [SearchLoyaltyRewardsResponse Hash] response from the API call
+    def search_loyalty_rewards(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/rewards/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
+
+    # Deletes a loyalty reward by doing the following:
+    # - Returns the loyalty points back to the loyalty account.
+    # - If an order ID was specified when the reward was created
+    # (see
+    # [CreateLoyaltyReward](https://developer.squareup.com/docs/reference/square
+    # /loyalty-api/create-loyalty-reward)),
+    # it updates the order by removing the reward and related
+    # discounts.
+    # You cannot delete a reward that has reached the terminal state (REDEEMED).
+    # For more information, see
+    # [Loyalty
+    # rewards](https://developer.squareup.com/docs/docs/loyalty-api/overview/#lo
+    # yalty-overview-loyalty-rewards).
+    # @param [String] reward_id Required parameter: The ID of the [loyalty
+    # reward](#type-LoyaltyReward) to delete.
+    # @return [DeleteLoyaltyRewardResponse Hash] response from the API call
+    def delete_loyalty_reward(reward_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/rewards/{reward_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'reward_id' => reward_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.delete(
+        _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
+
+    # Retrieves a loyalty reward.
+    # @param [String] reward_id Required parameter: The ID of the [loyalty
+    # reward](#type-LoyaltyReward) to retrieve.
+    # @return [RetrieveLoyaltyRewardResponse Hash] response from the API call
+    def retrieve_loyalty_reward(reward_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/rewards/{reward_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'reward_id' => reward_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
+
+    # Redeems a loyalty reward.
+    # The endpoint sets the reward to the terminal state (`REDEEMED`).
+    # If you are using your own order processing system (not using the
+    # Orders API), you call this endpoint after the buyer paid for the
+    # purchase.
+    # After the reward reaches the terminal state, it cannot be deleted.
+    # In other words, points used for the reward cannot be returned
+    # to the account.
+    # For more information, see
+    # [Loyalty
+    # rewards](https://developer.squareup.com/docs/docs/loyalty-api/overview/#lo
+    # yalty-overview-loyalty-rewards).
+    # @param [String] reward_id Required parameter: The ID of the [loyalty
+    # reward](#type-LoyaltyReward) to redeem.
+    # @param [RedeemLoyaltyRewardRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [RedeemLoyaltyRewardResponse Hash] response from the API call
+    def redeem_loyalty_reward(reward_id:,
+                              body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/loyalty/rewards/{reward_id}/redeem'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'reward_id' => reward_id
+      )
+      _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
+  end
+end

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/client.rb

@@ -4,11 +4,11 @@ module Square
     attr_reader :config
 
     def sdk_version
-      '5.2.2.20200422'
+      '5.3.0.20200528'
     end
 
     def square_version
-      '2020-04-22'
+      '2020-05-28'
     end
 
     # Access to mobile_authorization controller.
@@ -149,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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 5.2.2.20200422
+  version: 5.3.0.20200528
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-25 00:00:00.000000000 Z
+date: 2020-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logging
@@ -133,6 +133,7 @@ files:
 - 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
@@ -190,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