square.rb 38.1.1.20240717 → 39.0.0.20240821

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cce93ff0125b15e7eade6f156a88af3df95fefe77472e14145003f647ac3290
-  data.tar.gz: 5fb22cfd130b0e709f84c17a1eee3f3796fb3cf24e69c32c92f11924bb2d8013
+  metadata.gz: 1bda4ce1c716807ae293b2cacb11f2e9db303538ddd78828a1eca0a5464615e9
+  data.tar.gz: 122c807617e5cc3f57766ef7f2af22b4fd1d24b08c6b56195d41e44cdd2c17ab
 SHA512:
-  metadata.gz: 22248613a64e80016c2da4c143cd16833dfdf5d617baafd79cd73194cdeef521e56351a4f0f94c39d088fc77a90e09f1ee3e90b87397dc4525d906937c2936af
-  data.tar.gz: bc563352893ab4ebc268778f52181f755ea3f4bcc612ea1cd764e4aed18659335af2232133d953ae163fd0d4f454fba827f81b6d1e284fd454c88f2fab3ab7a6
+  metadata.gz: 5348106016605477e1878bb2c0397bb8c32445e58b74142cedc1aa26cf1587509dc98b3c5ab4f8fdc31f0d758b270367c776f1af97d8ef756468743fe2339bdd
+  data.tar.gz: 212b361dc1a9414fffb346967520ccf74189c30851de9e1632d967fda0d7888dab1066fc1e620109511ad2dba13dcb6208fb99fc05f1279fa12aacdfc4a94afe

data/lib/square/api/base_api.rb

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

data/lib/square/api/gift_card_activities_api.rb

@@ -73,9 +73,8 @@ module Square
 
     # Creates a gift card activity to manage the balance or state of a [gift
     # card]($m/GiftCard).
-    # For example, you create an `ACTIVATE` activity to activate a gift card
-    # with an initial balance
-    # before the gift card can be used.
+    # For example, create an `ACTIVATE` activity to activate a gift card with an
+    # initial balance before first use.
     # @param [CreateGiftCardActivityRequest] 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/gift_cards_api.rb

@@ -50,11 +50,14 @@ module Square
     end
 
     # Creates a digital gift card or registers a physical (plastic) gift card.
-    # After the gift card
-    # is created, you must call
-    # [CreateGiftCardActivity]($e/GiftCardActivities/CreateGiftCardActivity)
-    # to activate the card with an initial balance before it can be used for
-    # payment.
+    # The resulting gift card
+    # has a `PENDING` state. To activate a gift card so that it can be redeemed
+    # for purchases, call
+    # [CreateGiftCardActivity]($e/GiftCardActivities/CreateGiftCardActivity) and
+    # create an `ACTIVATE`
+    # activity with the initial balance. Alternatively, you can use
+    # [RefundPayment]($e/Refunds/RefundPayment)
+    # to refund a payment to the new gift card.
     # @param [CreateGiftCardRequest] 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/o_auth_api.rb

@@ -89,16 +89,14 @@ module Square
     # ).
     # If the access token is expired or not a valid access token, the endpoint
     # returns an `UNAUTHORIZED` error.
-    # @param [String] authorization Required parameter: Client
-    # APPLICATION_SECRET
     # @return [RetrieveTokenStatusResponse Hash] response from the API call
-    def retrieve_token_status(authorization:)
+    def retrieve_token_status
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/oauth2/token/status',
                                      'default')
-                   .header_param(new_parameter(authorization, key: 'Authorization'))
-                   .header_param(new_parameter('application/json', key: 'accept')))
+                   .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)

data/lib/square/api/payments_api.rb

@@ -37,6 +37,22 @@ module Square
     # also the maximum allowed value. If the provided value is  greater than
     # 100, it is ignored and the default value is used instead.  Default:
     # `100`
+    # @param [TrueClass | FalseClass] is_offline_payment Optional parameter:
+    # Whether the payment was taken offline or not.
+    # @param [String] offline_begin_time Optional parameter: Indicates the start
+    # of the time range for which to retrieve offline payments, in RFC 3339
+    # format for timestamps. The range is determined using the
+    # `offline_payment_details.client_created_at` field for each Payment. If
+    # set, payments without a value set in
+    # `offline_payment_details.client_created_at` will not be returned.
+    # Default: The current time.
+    # @param [String] offline_end_time Optional parameter: Indicates the end of
+    # the time range for which to retrieve offline payments, in RFC 3339 format
+    # for timestamps. The range is determined using the
+    # `offline_payment_details.client_created_at` field for each Payment. If
+    # set, payments without a value set in
+    # `offline_payment_details.client_created_at` will not be returned.
+    # Default: The current time.
     # @return [ListPaymentsResponse Hash] response from the API call
     def list_payments(begin_time: nil,
                       end_time: nil,
@@ -46,7 +62,10 @@ module Square
                       total: nil,
                       last_4: nil,
                       card_brand: nil,
-                      limit: nil)
+                      limit: nil,
+                      is_offline_payment: false,
+                      offline_begin_time: nil,
+                      offline_end_time: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/payments',
@@ -60,6 +79,9 @@ module Square
                    .query_param(new_parameter(last_4, key: 'last_4'))
                    .query_param(new_parameter(card_brand, key: 'card_brand'))
                    .query_param(new_parameter(limit, key: 'limit'))
+                   .query_param(new_parameter(is_offline_payment, key: 'is_offline_payment'))
+                   .query_param(new_parameter(offline_begin_time, key: 'offline_begin_time'))
+                   .query_param(new_parameter(offline_end_time, key: 'offline_end_time'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('global')))
         .response(new_response_handler

data/lib/square/client.rb

@@ -5,7 +5,7 @@ module Square
     attr_reader :config, :auth_managers
 
     def sdk_version
-      '38.1.1.20240717'
+      '39.0.0.20240821'
     end
 
     def square_version
@@ -274,7 +274,7 @@ module Square
       retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
       retry_methods: %i[get put], http_callback: nil, environment: 'production',
       custom_url: 'https://connect.squareup.com', access_token: nil,
-      bearer_auth_credentials: nil, square_version: '2024-07-17',
+      bearer_auth_credentials: nil, square_version: '2024-08-21',
       user_agent_detail: '', additional_headers: {}, config: nil
     )
       @config = if config.nil?

data/lib/square/configuration.rb

@@ -24,7 +24,7 @@ module Square
       retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
       retry_methods: %i[get put], http_callback: nil, environment: 'production',
       custom_url: 'https://connect.squareup.com', access_token: nil,
-      bearer_auth_credentials: nil, square_version: '2024-07-17',
+      bearer_auth_credentials: nil, square_version: '2024-08-21',
       user_agent_detail: '', additional_headers: {}
     )
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 38.1.1.20240717
+  version: 39.0.0.20240821
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-17 00:00:00.000000000 Z
+date: 2024-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: apimatic_core_interfaces
@@ -58,20 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.14.1
+        version: 5.24.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.14.1
+        version: 5.24.0
 - !ruby/object:Gem::Dependency
   name: minitest-proveit
   requirement: !ruby/object:Gem::Requirement