square_connect 2.0.0 → 2.0.2.13

data/lib/square_connect/api/transaction_api.rb

@@ -1,11 +1,10 @@
 =begin
-Square Connect API
+#Square Connect API
 
 OpenAPI spec version: 2.0
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 
-
 =end
 
 require "uri"
@@ -18,66 +17,47 @@ module SquareConnect
       @api_client = api_client
     end
 
-    # ListTransactions
-    # Lists transactions for a particular location.\n\nWhen making a request to this endpoint, your request body **must** include either the `cursor` parameter, or it must\ninclude both `begin_time` and `end_time` with an optional `sort_order`.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id The ID of the location to list transactions for.
+    # CaptureTransaction
+    # Captures a transaction that was created with the [Charge](#endpoint-charge) endpoint with a `delay_capture` value of `true`.  See [Delayed capture transactions](/articles/delayed-capture-transactions/) for more information.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
+    # @param location_id 
+    # @param transaction_id 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :begin_time The beginning of the requested reporting period, in RFC 3339 format.
-    # @option opts [String] :end_time The end of the requested reporting period, in RFC 3339 format.
-    # @option opts [String] :sort_order The order in which results are listed in the response (`ASC` for\nchronological, `DESC` for reverse-chronological).
-    # @option opts [String] :cursor A pagination cursor to retrieve the next set of results for your\noriginal query to the endpoint.
-    # @return [ListTransactionsResponse]
-    def list_transactions(authorization, location_id, opts = {})
-      data, status_code, headers = list_transactions_with_http_info(authorization, location_id, opts)
+    # @return [CaptureTransactionResponse]
+    def capture_transaction(authorization, location_id, transaction_id, opts = {})
+      data, _status_code, _headers = capture_transaction_with_http_info(authorization, location_id, transaction_id, opts)
       return data
     end
 
-    # ListTransactions
-    # Lists transactions for a particular location.\n\nWhen making a request to this endpoint, your request body **must** include either the `cursor` parameter, or it must\ninclude both `begin_time` and `end_time` with an optional `sort_order`.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id The ID of the location to list transactions for.
+    # CaptureTransaction
+    # Captures a transaction that was created with the [Charge](#endpoint-charge) endpoint with a `delay_capture` value of `true`.  See [Delayed capture transactions](/articles/delayed-capture-transactions/) for more information.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
+    # @param location_id 
+    # @param transaction_id 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :begin_time The beginning of the requested reporting period, in RFC 3339 format.
-    # @option opts [String] :end_time The end of the requested reporting period, in RFC 3339 format.
-    # @option opts [String] :sort_order The order in which results are listed in the response (`ASC` for\nchronological, `DESC` for reverse-chronological).
-    # @option opts [String] :cursor A pagination cursor to retrieve the next set of results for your\noriginal query to the endpoint.
-    # @return [Array<(ListTransactionsResponse, Fixnum, Hash)>] ListTransactionsResponse data, response status code and response headers
-    def list_transactions_with_http_info(authorization, location_id, opts = {})
+    # @return [Array<(CaptureTransactionResponse, Fixnum, Hash)>] CaptureTransactionResponse data, response status code and response headers
+    def capture_transaction_with_http_info(authorization, location_id, transaction_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: TransactionApi#list_transactions ..."
+        @api_client.config.logger.debug "Calling API: TransactionApi.capture_transaction ..."
       end
-      
       # verify the required parameter 'authorization' is set
-      fail "Missing the required parameter 'authorization' when calling list_transactions" if authorization.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'authorization' when calling TransactionApi.capture_transaction" if authorization.nil?
       # verify the required parameter 'location_id' is set
-      fail "Missing the required parameter 'location_id' when calling list_transactions" if location_id.nil?
-      
-      if opts[:'sort_order'] && !['DESC', 'ASC'].include?(opts[:'sort_order'])
-        fail 'invalid value for "sort_order", must be one of DESC, ASC'
-      end
-      
+      fail ArgumentError, "Missing the required parameter 'location_id' when calling TransactionApi.capture_transaction" if location_id.nil?
+      # verify the required parameter 'transaction_id' is set
+      fail ArgumentError, "Missing the required parameter 'transaction_id' when calling TransactionApi.capture_transaction" if transaction_id.nil?
       # resource path
-      path = "/v2/locations/{location_id}/transactions".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s)
+      local_var_path = "/v2/locations/{location_id}/transactions/{transaction_id}/capture".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s).sub('{' + 'transaction_id' + '}', transaction_id.to_s)
 
       # query parameters
       query_params = {}
-      query_params[:'begin_time'] = opts[:'begin_time'] if opts[:'begin_time']
-      query_params[:'end_time'] = opts[:'end_time'] if opts[:'end_time']
-      query_params[:'sort_order'] = opts[:'sort_order'] if opts[:'sort_order']
-      query_params[:'cursor'] = opts[:'cursor'] if opts[:'cursor']
 
       # header parameters
       header_params = {}
-
       # HTTP header 'Accept' (if needed)
-      _header_accept = ['application/json']
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
-      _header_content_type = ['application/json']
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'Authorization'] = authorization
 
       # form parameters
@@ -85,70 +65,61 @@ module SquareConnect
 
       # http body (model)
       post_body = nil
-      
       auth_names = []
-      data, status_code, headers = @api_client.call_api(:GET, path,
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'ListTransactionsResponse')
+        :return_type => 'CaptureTransactionResponse')
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: TransactionApi#list_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: TransactionApi#capture_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
     # Charge
-    # Charges a card represented by a token.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id The ID of the location to associate the transaction with.
-    # @param body An object containing the fields to POST for the request.\n\nSee the corresponding object definition for field details.
+    # Charges a card represented by a card nonce or a customer's card on file.  Your request to this endpoint must include _either_:  - A value for the `card_nonce` parameter (to charge a card nonce generated with the `SqPaymentForm`) - Values for the `customer_card_id` and `customer_id` parameters (to charge a customer's card on file)  In order for an e-commerce payment to potentially qualify for [Square chargeback protection](https://squareup.com/help/article/5394), you _must_ provide values for the following parameters in your request:  - `buyer_email_address` - At least one of `billing_address` or `shipping_address`  When this response is returned, the amount of Square's processing fee might not yet be calculated. To obtain the processing fee, wait about ten seconds and call [RetrieveTransaction](#endpoint-retrievetransaction). See the `processing_fee_money` field of each [Tender included](#type-tender) in the transaction.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
+    # @param location_id The ID of the location to associate the created transaction with.
+    # @param body An object containing the fields to POST for the request.  See the corresponding object definition for field details.
     # @param [Hash] opts the optional parameters
     # @return [ChargeResponse]
     def charge(authorization, location_id, body, opts = {})
-      data, status_code, headers = charge_with_http_info(authorization, location_id, body, opts)
+      data, _status_code, _headers = charge_with_http_info(authorization, location_id, body, opts)
       return data
     end
 
     # Charge
-    # Charges a card represented by a token.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id The ID of the location to associate the transaction with.
-    # @param body An object containing the fields to POST for the request.\n\nSee the corresponding object definition for field details.
+    # Charges a card represented by a card nonce or a customer&#39;s card on file.  Your request to this endpoint must include _either_:  - A value for the &#x60;card_nonce&#x60; parameter (to charge a card nonce generated with the &#x60;SqPaymentForm&#x60;) - Values for the &#x60;customer_card_id&#x60; and &#x60;customer_id&#x60; parameters (to charge a customer&#39;s card on file)  In order for an e-commerce payment to potentially qualify for [Square chargeback protection](https://squareup.com/help/article/5394), you _must_ provide values for the following parameters in your request:  - &#x60;buyer_email_address&#x60; - At least one of &#x60;billing_address&#x60; or &#x60;shipping_address&#x60;  When this response is returned, the amount of Square&#39;s processing fee might not yet be calculated. To obtain the processing fee, wait about ten seconds and call [RetrieveTransaction](#endpoint-retrievetransaction). See the &#x60;processing_fee_money&#x60; field of each [Tender included](#type-tender) in the transaction.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
+    # @param location_id The ID of the location to associate the created transaction with.
+    # @param body An object containing the fields to POST for the request.  See the corresponding object definition for field details.
     # @param [Hash] opts the optional parameters
     # @return [Array<(ChargeResponse, Fixnum, Hash)>] ChargeResponse data, response status code and response headers
     def charge_with_http_info(authorization, location_id, body, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: TransactionApi#charge ..."
+        @api_client.config.logger.debug "Calling API: TransactionApi.charge ..."
       end
-      
       # verify the required parameter 'authorization' is set
-      fail "Missing the required parameter 'authorization' when calling charge" if authorization.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'authorization' when calling TransactionApi.charge" if authorization.nil?
       # verify the required parameter 'location_id' is set
-      fail "Missing the required parameter 'location_id' when calling charge" if location_id.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'location_id' when calling TransactionApi.charge" if location_id.nil?
       # verify the required parameter 'body' is set
-      fail "Missing the required parameter 'body' when calling charge" if body.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'body' when calling TransactionApi.charge" if body.nil?
       # resource path
-      path = "/v2/locations/{location_id}/transactions".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s)
+      local_var_path = "/v2/locations/{location_id}/transactions".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s)
 
       # query parameters
       query_params = {}
 
       # header parameters
       header_params = {}
-
       # HTTP header 'Accept' (if needed)
-      _header_accept = ['application/json']
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
-      _header_content_type = ['application/json']
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'Authorization'] = authorization
 
       # form parameters
@@ -156,9 +127,8 @@ module SquareConnect
 
       # http body (model)
       post_body = @api_client.object_to_http_body(body)
-      
       auth_names = []
-      data, status_code, headers = @api_client.call_api(:POST, path,
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -171,55 +141,58 @@ module SquareConnect
       return data, status_code, headers
     end
 
-    # RetrieveTransaction
-    # Retrieves details for a single transaction.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id 
-    # @param transaction_id 
+    # ListTransactions
+    # Lists transactions for a particular location.  Max results per [page](#paginatingresults): 50
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
+    # @param location_id The ID of the location to list transactions for.
     # @param [Hash] opts the optional parameters
-    # @return [RetrieveTransactionResponse]
-    def retrieve_transaction(authorization, location_id, transaction_id, opts = {})
-      data, status_code, headers = retrieve_transaction_with_http_info(authorization, location_id, transaction_id, opts)
+    # @option opts [String] :begin_time The beginning of the requested reporting period, in RFC 3339 format.  See [Date ranges](#dateranges) for details on date inclusivity/exclusivity.  Default value: The current time minus one year.
+    # @option opts [String] :end_time The end of the requested reporting period, in RFC 3339 format.  See [Date ranges](#dateranges) for details on date inclusivity/exclusivity.  Default value: The current time.
+    # @option opts [String] :sort_order The order in which results are listed in the response (&#x60;ASC&#x60; for oldest first, &#x60;DESC&#x60; for newest first).  Default value: &#x60;DESC&#x60;
+    # @option opts [String] :cursor 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 [Paginating results](#paginatingresults) for more information.
+    # @return [ListTransactionsResponse]
+    def list_transactions(authorization, location_id, opts = {})
+      data, _status_code, _headers = list_transactions_with_http_info(authorization, location_id, opts)
       return data
     end
 
-    # RetrieveTransaction
-    # Retrieves details for a single transaction.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id 
-    # @param transaction_id 
+    # ListTransactions
+    # Lists transactions for a particular location.  Max results per [page](#paginatingresults): 50
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
+    # @param location_id The ID of the location to list transactions for.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(RetrieveTransactionResponse, Fixnum, Hash)>] RetrieveTransactionResponse data, response status code and response headers
-    def retrieve_transaction_with_http_info(authorization, location_id, transaction_id, opts = {})
+    # @option opts [String] :begin_time The beginning of the requested reporting period, in RFC 3339 format.  See [Date ranges](#dateranges) for details on date inclusivity/exclusivity.  Default value: The current time minus one year.
+    # @option opts [String] :end_time The end of the requested reporting period, in RFC 3339 format.  See [Date ranges](#dateranges) for details on date inclusivity/exclusivity.  Default value: The current time.
+    # @option opts [String] :sort_order The order in which results are listed in the response (&#x60;ASC&#x60; for oldest first, &#x60;DESC&#x60; for newest first).  Default value: &#x60;DESC&#x60;
+    # @option opts [String] :cursor 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 [Paginating results](#paginatingresults) for more information.
+    # @return [Array<(ListTransactionsResponse, Fixnum, Hash)>] ListTransactionsResponse data, response status code and response headers
+    def list_transactions_with_http_info(authorization, location_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: TransactionApi#retrieve_transaction ..."
+        @api_client.config.logger.debug "Calling API: TransactionApi.list_transactions ..."
       end
-      
       # verify the required parameter 'authorization' is set
-      fail "Missing the required parameter 'authorization' when calling retrieve_transaction" if authorization.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'authorization' when calling TransactionApi.list_transactions" if authorization.nil?
       # verify the required parameter 'location_id' is set
-      fail "Missing the required parameter 'location_id' when calling retrieve_transaction" if location_id.nil?
-      
-      # verify the required parameter 'transaction_id' is set
-      fail "Missing the required parameter 'transaction_id' when calling retrieve_transaction" if transaction_id.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'location_id' when calling TransactionApi.list_transactions" if location_id.nil?
+      if opts[:'sort_order'] && !['DESC', 'ASC'].include?(opts[:'sort_order'])
+        fail ArgumentError, 'invalid value for "sort_order", must be one of DESC, ASC'
+      end
       # resource path
-      path = "/v2/locations/{location_id}/transactions/{transaction_id}".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s).sub('{' + 'transaction_id' + '}', transaction_id.to_s)
+      local_var_path = "/v2/locations/{location_id}/transactions".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s)
 
       # query parameters
       query_params = {}
+      query_params[:'begin_time'] = opts[:'begin_time'] if !opts[:'begin_time'].nil?
+      query_params[:'end_time'] = opts[:'end_time'] if !opts[:'end_time'].nil?
+      query_params[:'sort_order'] = opts[:'sort_order'] if !opts[:'sort_order'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
 
       # header parameters
       header_params = {}
-
       # HTTP header 'Accept' (if needed)
-      _header_accept = ['application/json']
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
-      _header_content_type = ['application/json']
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'Authorization'] = authorization
 
       # form parameters
@@ -227,70 +200,61 @@ module SquareConnect
 
       # http body (model)
       post_body = nil
-      
       auth_names = []
-      data, status_code, headers = @api_client.call_api(:GET, path,
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'RetrieveTransactionResponse')
+        :return_type => 'ListTransactionsResponse')
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: TransactionApi#retrieve_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: TransactionApi#list_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # CaptureTransaction
-    # Captures a transaction that was created with the **Charge**\nendpoint with a `delay_capture` value of `true`.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id 
-    # @param transaction_id 
+    # RetrieveTransaction
+    # Retrieves details for a single transaction.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
+    # @param location_id The ID of the transaction&#39;s associated location.
+    # @param transaction_id The ID of the transaction to retrieve.
     # @param [Hash] opts the optional parameters
-    # @return [CaptureTransactionResponse]
-    def capture_transaction(authorization, location_id, transaction_id, opts = {})
-      data, status_code, headers = capture_transaction_with_http_info(authorization, location_id, transaction_id, opts)
+    # @return [RetrieveTransactionResponse]
+    def retrieve_transaction(authorization, location_id, transaction_id, opts = {})
+      data, _status_code, _headers = retrieve_transaction_with_http_info(authorization, location_id, transaction_id, opts)
       return data
     end
 
-    # CaptureTransaction
-    # Captures a transaction that was created with the **Charge**\nendpoint with a `delay_capture` value of `true`.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
-    # @param location_id 
-    # @param transaction_id 
+    # RetrieveTransaction
+    # Retrieves details for a single transaction.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
+    # @param location_id The ID of the transaction&#39;s associated location.
+    # @param transaction_id The ID of the transaction to retrieve.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(CaptureTransactionResponse, Fixnum, Hash)>] CaptureTransactionResponse data, response status code and response headers
-    def capture_transaction_with_http_info(authorization, location_id, transaction_id, opts = {})
+    # @return [Array<(RetrieveTransactionResponse, Fixnum, Hash)>] RetrieveTransactionResponse data, response status code and response headers
+    def retrieve_transaction_with_http_info(authorization, location_id, transaction_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: TransactionApi#capture_transaction ..."
+        @api_client.config.logger.debug "Calling API: TransactionApi.retrieve_transaction ..."
       end
-      
       # verify the required parameter 'authorization' is set
-      fail "Missing the required parameter 'authorization' when calling capture_transaction" if authorization.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'authorization' when calling TransactionApi.retrieve_transaction" if authorization.nil?
       # verify the required parameter 'location_id' is set
-      fail "Missing the required parameter 'location_id' when calling capture_transaction" if location_id.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'location_id' when calling TransactionApi.retrieve_transaction" if location_id.nil?
       # verify the required parameter 'transaction_id' is set
-      fail "Missing the required parameter 'transaction_id' when calling capture_transaction" if transaction_id.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'transaction_id' when calling TransactionApi.retrieve_transaction" if transaction_id.nil?
       # resource path
-      path = "/v2/locations/{location_id}/transactions/{transaction_id}/capture".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s).sub('{' + 'transaction_id' + '}', transaction_id.to_s)
+      local_var_path = "/v2/locations/{location_id}/transactions/{transaction_id}".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s).sub('{' + 'transaction_id' + '}', transaction_id.to_s)
 
       # query parameters
       query_params = {}
 
       # header parameters
       header_params = {}
-
       # HTTP header 'Accept' (if needed)
-      _header_accept = ['application/json']
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
-      _header_content_type = ['application/json']
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'Authorization'] = authorization
 
       # form parameters
@@ -298,70 +262,61 @@ module SquareConnect
 
       # http body (model)
       post_body = nil
-      
       auth_names = []
-      data, status_code, headers = @api_client.call_api(:POST, path,
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'CaptureTransactionResponse')
+        :return_type => 'RetrieveTransactionResponse')
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: TransactionApi#capture_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: TransactionApi#retrieve_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
     # VoidTransaction
-    # Cancels a transaction that was created with the **Charge**\nendpoint with a `delay_capture` value of `true`.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
+    # Cancels a transaction that was created with the [Charge](#endpoint-charge) endpoint with a `delay_capture` value of `true`.  See [Delayed capture transactions](/articles/delayed-capture-transactions/) for more information.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
     # @param location_id 
     # @param transaction_id 
     # @param [Hash] opts the optional parameters
     # @return [VoidTransactionResponse]
     def void_transaction(authorization, location_id, transaction_id, opts = {})
-      data, status_code, headers = void_transaction_with_http_info(authorization, location_id, transaction_id, opts)
+      data, _status_code, _headers = void_transaction_with_http_info(authorization, location_id, transaction_id, opts)
       return data
     end
 
     # VoidTransaction
-    # Cancels a transaction that was created with the **Charge**\nendpoint with a `delay_capture` value of `true`.
-    # @param authorization The value to provide in the Authorization header of\nyour request. This value should follow the format `Bearer YOUR_ACCESS_TOKEN_HERE`.
+    # Cancels a transaction that was created with the [Charge](#endpoint-charge) endpoint with a &#x60;delay_capture&#x60; value of &#x60;true&#x60;.  See [Delayed capture transactions](/articles/delayed-capture-transactions/) for more information.
+    # @param authorization The value to provide in the Authorization header of your request. This value should follow the format &#x60;Bearer YOUR_ACCESS_TOKEN_HERE&#x60;.
     # @param location_id 
     # @param transaction_id 
     # @param [Hash] opts the optional parameters
     # @return [Array<(VoidTransactionResponse, Fixnum, Hash)>] VoidTransactionResponse data, response status code and response headers
     def void_transaction_with_http_info(authorization, location_id, transaction_id, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: TransactionApi#void_transaction ..."
+        @api_client.config.logger.debug "Calling API: TransactionApi.void_transaction ..."
       end
-      
       # verify the required parameter 'authorization' is set
-      fail "Missing the required parameter 'authorization' when calling void_transaction" if authorization.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'authorization' when calling TransactionApi.void_transaction" if authorization.nil?
       # verify the required parameter 'location_id' is set
-      fail "Missing the required parameter 'location_id' when calling void_transaction" if location_id.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'location_id' when calling TransactionApi.void_transaction" if location_id.nil?
       # verify the required parameter 'transaction_id' is set
-      fail "Missing the required parameter 'transaction_id' when calling void_transaction" if transaction_id.nil?
-      
+      fail ArgumentError, "Missing the required parameter 'transaction_id' when calling TransactionApi.void_transaction" if transaction_id.nil?
       # resource path
-      path = "/v2/locations/{location_id}/transactions/{transaction_id}/void".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s).sub('{' + 'transaction_id' + '}', transaction_id.to_s)
+      local_var_path = "/v2/locations/{location_id}/transactions/{transaction_id}/void".sub('{format}','json').sub('{' + 'location_id' + '}', location_id.to_s).sub('{' + 'transaction_id' + '}', transaction_id.to_s)
 
       # query parameters
       query_params = {}
 
       # header parameters
       header_params = {}
-
       # HTTP header 'Accept' (if needed)
-      _header_accept = ['application/json']
-      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
-
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
-      _header_content_type = ['application/json']
-      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'Authorization'] = authorization
 
       # form parameters
@@ -369,9 +324,8 @@ module SquareConnect
 
       # http body (model)
       post_body = nil
-      
       auth_names = []
-      data, status_code, headers = @api_client.call_api(:POST, path,
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,