square_connect 2.20180712.1.234 → 2.20180712.2.237

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae35dcc77ca9d4c9237ef793c0705e35e339e6e405e4a23f9ec1499f5aa8b5cb
-  data.tar.gz: 48c4190f9e040ed33bd69a4c6ae8faeec3148f4be1de0258e0617c744a3083a9
+  metadata.gz: 7fd9e4618a2eb573bc5a2f90c06484f712edff424d0d4e0db65b5ad202bba934
+  data.tar.gz: 1957542f6fd3e07d4ad97eb8a527a64e85dd5b8f71724045bfb88de2a0a96d9c
 SHA512:
-  metadata.gz: 6dc88b69ea94b19cffff9aacf123c1ab6893be3d21232d3270e2af37adee835c7ceb4bdc511f9e056bc2adb1099149556c78446ba795fb5b09c4e588797ae420
-  data.tar.gz: 1b0964fe2038553a3966ef475769ae749b6e26b20694f16724715fa91f2d7e2c18071baba0ead0833d7fb1b1ed8b29ce4f07a46ed32480551342fb03de272c60
+  metadata.gz: b1b67173dda7bb4078c465c81eec01a7c9a5b1755ffc328065d9eaa83bc267cc118ce7091583549b2d93ceee0a1b80e894531fcf3f292bc8c11659c8c9263110
+  data.tar.gz: c8c6ba9110f351a1665c4b3d4cf269f6559ca99a47cf9553f9a6661cb5506c9cbd5ad231c305deca8ef490854a677886aa57749cded1e2dd841088ef8c9d004f

data/CHANGES.md

@@ -1,5 +1,16 @@
 # Change Log
 
+## Version 2.20180712.2 (2018-08-21)
+
+The Connect SDK now includes functionality for the OAuth API. The Square OAuth API lets applications request and obtain permission from a Square account to make API calls on behalf of that account. Applications can request individual permissions so that users do not need to grant full access to their Square accounts.
+
+### OAuth API
+
+* `ObtainToken` endpoint — Exchanges the authorization code for an access token.  After a merchant authorizes your application with the permissions form, an authorization code is sent to the application's redirect URL (See [Implementing OAuth](https://docs.connect.squareup.com/api/oauth#implementingoauth) for information about how to set up the redirect URL).
+
+* `RenewToken` endpoint — Renews an OAuth access token before it expires.  OAuth access tokens besides your application's personal access token expire after __30 days__. You can also renew expired tokens within __15 days__ of their expiration. You cannot renew an access token that has been expired for more than 15 days. Instead, the associated merchant must complete the [OAuth flow](https://docs.connect.squareup.com/api/oauth#implementingoauth) from the beginning.  __Important:__ The `Authorization` header you provide to this endpoint must have the following format:  ``` Authorization: Client APPLICATION_SECRET ```  Replace `APPLICATION_SECRET` with your application's secret, available from the [application dashboard](https://connect.squareup.com/apps).
+* `RevokeToken` endpoint — Revokes an access token generated with the OAuth flow.  If a merchant has more than one access token for your application, this endpoint revokes all of them, regardless of which token you specify. If you revoke a merchant's access token, all of the merchant's active subscriptions associated with your application are canceled immediately.  __Important:__ The `Authorization` header you provide to this endpoint must have the following format:  ``` Authorization: Client APPLICATION_SECRET ```  Replace `APPLICATION_SECRET` with your application's secret, available from the [application dashboard](https://connect.squareup.com/apps).
+
 ## Version 2.20180712.1 (2018-08-02)
 
 We have added MobileAuthorization API.

data/README.md

@@ -10,7 +10,7 @@ for the specification and template files we used to generate this.
 This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
 - API version: 2.0
-- Package version: 2.20180712.1
+- Package version: 2.20180712.2
 - Build package: io.swagger.codegen.languages.RubyClientCodegen
 
 For more information, please visit [https://squareup.com/developers](https://squareup.com/developers)
@@ -96,6 +96,9 @@ Class | Method | HTTP request | Description
 *SquareConnect::CustomersApi* | [**update_customer**](docs/CustomersApi.md#update_customer) | **PUT** /v2/customers/{customer_id} | UpdateCustomer
 *SquareConnect::LocationsApi* | [**list_locations**](docs/LocationsApi.md#list_locations) | **GET** /v2/locations | ListLocations
 *SquareConnect::MobileAuthorizationApi* | [**create_mobile_authorization_code**](docs/MobileAuthorizationApi.md#create_mobile_authorization_code) | **POST** /mobile/authorization-code | CreateMobileAuthorizationCode
+*SquareConnect::OAuthApi* | [**obtain_token**](docs/OAuthApi.md#obtain_token) | **POST** /oauth2/token | ObtainToken
+*SquareConnect::OAuthApi* | [**renew_token**](docs/OAuthApi.md#renew_token) | **POST** /oauth2/clients/{client_id}/access-token/renew | RenewToken
+*SquareConnect::OAuthApi* | [**revoke_token**](docs/OAuthApi.md#revoke_token) | **POST** /oauth2/revoke | RevokeToken
 *SquareConnect::OrdersApi* | [**batch_retrieve_orders**](docs/OrdersApi.md#batch_retrieve_orders) | **POST** /v2/locations/{location_id}/orders/batch-retrieve | BatchRetrieveOrders
 *SquareConnect::OrdersApi* | [**create_order**](docs/OrdersApi.md#create_order) | **POST** /v2/locations/{location_id}/orders | CreateOrder
 *SquareConnect::ReportingApi* | [**list_additional_recipient_receivable_refunds**](docs/ReportingApi.md#list_additional_recipient_receivable_refunds) | **GET** /v2/locations/{location_id}/additional-recipient-receivable-refunds | ListAdditionalRecipientReceivableRefunds
@@ -288,6 +291,8 @@ Class | Method | HTTP request | Description
  - [SquareConnect::LocationStatus](docs/LocationStatus.md)
  - [SquareConnect::LocationType](docs/LocationType.md)
  - [SquareConnect::Money](docs/Money.md)
+ - [SquareConnect::ObtainTokenRequest](docs/ObtainTokenRequest.md)
+ - [SquareConnect::ObtainTokenResponse](docs/ObtainTokenResponse.md)
  - [SquareConnect::Order](docs/Order.md)
  - [SquareConnect::OrderLineItem](docs/OrderLineItem.md)
  - [SquareConnect::OrderLineItemDiscount](docs/OrderLineItemDiscount.md)
@@ -301,12 +306,16 @@ Class | Method | HTTP request | Description
  - [SquareConnect::RegisterDomainRequest](docs/RegisterDomainRequest.md)
  - [SquareConnect::RegisterDomainResponse](docs/RegisterDomainResponse.md)
  - [SquareConnect::RegisterDomainResponseStatus](docs/RegisterDomainResponseStatus.md)
+ - [SquareConnect::RenewTokenRequest](docs/RenewTokenRequest.md)
+ - [SquareConnect::RenewTokenResponse](docs/RenewTokenResponse.md)
  - [SquareConnect::RetrieveCatalogObjectRequest](docs/RetrieveCatalogObjectRequest.md)
  - [SquareConnect::RetrieveCatalogObjectResponse](docs/RetrieveCatalogObjectResponse.md)
  - [SquareConnect::RetrieveCustomerRequest](docs/RetrieveCustomerRequest.md)
  - [SquareConnect::RetrieveCustomerResponse](docs/RetrieveCustomerResponse.md)
  - [SquareConnect::RetrieveTransactionRequest](docs/RetrieveTransactionRequest.md)
  - [SquareConnect::RetrieveTransactionResponse](docs/RetrieveTransactionResponse.md)
+ - [SquareConnect::RevokeTokenRequest](docs/RevokeTokenRequest.md)
+ - [SquareConnect::RevokeTokenResponse](docs/RevokeTokenResponse.md)
  - [SquareConnect::SearchCatalogObjectsRequest](docs/SearchCatalogObjectsRequest.md)
  - [SquareConnect::SearchCatalogObjectsResponse](docs/SearchCatalogObjectsResponse.md)
  - [SquareConnect::SearchCustomersRequest](docs/SearchCustomersRequest.md)

data/docs/OAuthApi.md

@@ -0,0 +1,169 @@
+# SquareConnect::OAuthApi
+
+All URIs are relative to *https://connect.squareup.com*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**obtain_token**](OAuthApi.md#obtain_token) | **POST** /oauth2/token | ObtainToken
+[**renew_token**](OAuthApi.md#renew_token) | **POST** /oauth2/clients/{client_id}/access-token/renew | RenewToken
+[**revoke_token**](OAuthApi.md#revoke_token) | **POST** /oauth2/revoke | RevokeToken
+
+
+# **obtain_token**
+> ObtainTokenResponse obtain_token(body)
+
+ObtainToken
+
+Exchanges the authorization code for an access token.  After a merchant authorizes your application with the permissions form, an authorization code is sent to the application's redirect URL (See [Implementing OAuth](https://docs.connect.squareup.com/api/oauth#implementingoauth) for information about how to set up the redirect URL).
+
+### Example
+```ruby
+# load the gem
+require 'square_connect'
+
+api_instance = SquareConnect::OAuthApi.new
+
+body = SquareConnect::ObtainTokenRequest.new # ObtainTokenRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.
+
+
+begin
+  #ObtainToken
+  result = api_instance.obtain_token(body)
+  p result
+rescue SquareConnect::ApiError => e
+  puts "Exception when calling OAuthApi->obtain_token: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **body** | [**ObtainTokenRequest**](ObtainTokenRequest.md)| An object containing the fields to POST for the request.  See the corresponding object definition for field details. | 
+
+### Return type
+
+[**ObtainTokenResponse**](ObtainTokenResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
+# **renew_token**
+> RenewTokenResponse renew_token(client_id, body)
+
+RenewToken
+
+Renews an OAuth access token before it expires.  OAuth access tokens besides your application's personal access token expire after __30 days__. You can also renew expired tokens within __15 days__ of their expiration. You cannot renew an access token that has been expired for more than 15 days. Instead, the associated merchant must complete the [OAuth flow](https://docs.connect.squareup.com/api/oauth#implementingoauth) from the beginning.  __Important:__ The `Authorization` header you provide to this endpoint must have the following format:  ``` Authorization: Client APPLICATION_SECRET ```  Replace `APPLICATION_SECRET` with your application's secret, available from the [application dashboard](https://connect.squareup.com/apps).
+
+### Example
+```ruby
+# load the gem
+require 'square_connect'
+# setup authorization
+SquareConnect.configure do |config|
+  # Configure API key authorization: oauth2ClientSecret
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  #config.api_key_prefix['Authorization'] = 'Bearer'
+end
+
+api_instance = SquareConnect::OAuthApi.new
+
+client_id = "client_id_example" # String | Your application's ID, available from the [application dashboard](https://connect.squareup.com/apps).
+
+body = SquareConnect::RenewTokenRequest.new # RenewTokenRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.
+
+
+begin
+  #RenewToken
+  result = api_instance.renew_token(client_id, body)
+  p result
+rescue SquareConnect::ApiError => e
+  puts "Exception when calling OAuthApi->renew_token: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **client_id** | **String**| Your application's ID, available from the [application dashboard](https://connect.squareup.com/apps). | 
+ **body** | [**RenewTokenRequest**](RenewTokenRequest.md)| An object containing the fields to POST for the request.  See the corresponding object definition for field details. | 
+
+### Return type
+
+[**RenewTokenResponse**](RenewTokenResponse.md)
+
+### Authorization
+
+[oauth2ClientSecret](../README.md#oauth2ClientSecret)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
+# **revoke_token**
+> RevokeTokenResponse revoke_token(body)
+
+RevokeToken
+
+Revokes an access token generated with the OAuth flow.  If a merchant has more than one access token for your application, this endpoint revokes all of them, regardless of which token you specify. If you revoke a merchant's access token, all of the merchant's active subscriptions associated with your application are canceled immediately.  __Important:__ The `Authorization` header you provide to this endpoint must have the following format:  ``` Authorization: Client APPLICATION_SECRET ```  Replace `APPLICATION_SECRET` with your application's secret, available from the [application dashboard](https://connect.squareup.com/apps).
+
+### Example
+```ruby
+# load the gem
+require 'square_connect'
+# setup authorization
+SquareConnect.configure do |config|
+  # Configure API key authorization: oauth2ClientSecret
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  #config.api_key_prefix['Authorization'] = 'Bearer'
+end
+
+api_instance = SquareConnect::OAuthApi.new
+
+body = SquareConnect::RevokeTokenRequest.new # RevokeTokenRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.
+
+
+begin
+  #RevokeToken
+  result = api_instance.revoke_token(body)
+  p result
+rescue SquareConnect::ApiError => e
+  puts "Exception when calling OAuthApi->revoke_token: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **body** | [**RevokeTokenRequest**](RevokeTokenRequest.md)| An object containing the fields to POST for the request.  See the corresponding object definition for field details. | 
+
+### Return type
+
+[**RevokeTokenResponse**](RevokeTokenResponse.md)
+
+### Authorization
+
+[oauth2ClientSecret](../README.md#oauth2ClientSecret)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+

data/docs/ObtainTokenRequest.md

@@ -0,0 +1,15 @@
+# SquareConnect::ObtainTokenRequest
+
+### Description
+
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**client_id** | **String** | Your application's ID, available from the [application dashboard](https://connect.squareup.com/apps). | [optional] 
+**client_secret** | **String** | Your application's secret, available from the [application dashboard](https://connect.squareup.com/apps). | [optional] 
+**code** | **String** | The authorization code to exchange. | [optional] 
+**redirect_uri** | **String** | The redirect URL assigned in the [application dashboard](https://connect.squareup.com/apps). | [optional] 
+
+

data/docs/ObtainTokenResponse.md

@@ -0,0 +1,18 @@
+# SquareConnect::ObtainTokenResponse
+
+### Description
+
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**access_token** | **String** | Your application's access token. You provide this token in a header with every request to Connect API endpoints. See [Request and response headers](https://docs.connect.squareup.com/api/connect/v2/#requestandresponseheaders) for the format of this header. | [optional] 
+**token_type** | **String** | This value is always _bearer_. | [optional] 
+**expires_at** | **String** | The date when access_token expires, in [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm) format. | [optional] 
+**merchant_id** | **String** | The ID of the authorizing merchant's business. | [optional] 
+**subscription_id** | **String** | The ID of the merchant [subscription](https://docs.connect.squareup.com/api/connect/v1/#navsection-subscriptionmanagement) associated with the authorization. Only present if the merchant signed up for a subscription during authorization. | [optional] 
+**plan_id** | **String** | The ID of the [subscription](https://docs.connect.squareup.com/api/connect/v1/#navsection-subscriptionmanagement) plan the merchant signed up for. Only present if the merchant signed up for a subscription during authorization. | [optional] 
+**id_token** | **String** | Then OpenID token belonging to this this person. Only present if the OPENID scope is included in the authorize request. | [optional] 
+
+

data/docs/RenewTokenRequest.md

@@ -0,0 +1,12 @@
+# SquareConnect::RenewTokenRequest
+
+### Description
+
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**access_token** | **String** | The token you want to renew. | [optional] 
+
+

data/docs/RenewTokenResponse.md

@@ -0,0 +1,17 @@
+# SquareConnect::RenewTokenResponse
+
+### Description
+
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**access_token** | **String** | The renewed access token. This value might be different from the `access_token` you provided in your request. You provide this token in a header with every request to Connect API endpoints. See [Request and response headers](https://docs.connect.squareup.com/api/connect/v2/#requestandresponseheaders) for the format of this header. | [optional] 
+**token_type** | **String** | This value is always _bearer_. | [optional] 
+**expires_at** | **String** | The date when access_token expires, in [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm) format. | [optional] 
+**merchant_id** | **String** | The ID of the authorizing merchant's business. | [optional] 
+**subscription_id** | **String** | The ID of the merchant [subscription](https://docs.connect.squareup.com/api/connect/v1/#navsection-subscriptionmanagement) associated with the authorization. Only present if the merchant signed up for a subscription during authorization. | [optional] 
+**plan_id** | **String** | The ID of the [subscription](https://docs.connect.squareup.com/api/connect/v1/#navsection-subscriptionmanagement) plan the merchant signed up for. Only present if the merchant signed up for a subscription during authorization. | [optional] 
+
+

data/docs/RevokeTokenRequest.md

@@ -0,0 +1,14 @@
+# SquareConnect::RevokeTokenRequest
+
+### Description
+
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**client_id** | **String** | Your application's ID, available from the [application dashboard](https://connect.squareup.com/apps). | [optional] 
+**access_token** | **String** | The access token of the merchant whose token you want to revoke. Do not provide a value for merchant_id if you provide this parameter. | [optional] 
+**merchant_id** | **String** | The ID of the merchant whose token you want to revoke. Do not provide a value for access_token if you provide this parameter. | [optional] 
+
+

data/docs/RevokeTokenResponse.md

@@ -0,0 +1,12 @@
+# SquareConnect::RevokeTokenResponse
+
+### Description
+
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**success** | **BOOLEAN** | If the request is successful, this is true. | [optional] 
+
+

data/lib/square_connect/api/o_auth_api.rb

@@ -0,0 +1,189 @@
+=begin
+#Square Connect API
+
+OpenAPI spec version: 2.0
+Contact: developers@squareup.com
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+
+=end
+
+require "uri"
+
+module SquareConnect
+  class OAuthApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+
+    # ObtainToken
+    # Exchanges the authorization code for an access token.  After a merchant authorizes your application with the permissions form, an authorization code is sent to the application's redirect URL (See [Implementing OAuth](https://docs.connect.squareup.com/api/oauth#implementingoauth) for information about how to set up the redirect URL).
+    # @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 [ObtainTokenResponse]
+    def obtain_token(body, opts = {})
+      data, _status_code, _headers = obtain_token_with_http_info(body, opts)
+      return data
+    end
+
+    # ObtainToken
+    # Exchanges the authorization code for an access token.  After a merchant authorizes your application with the permissions form, an authorization code is sent to the application's redirect URL (See [Implementing OAuth](https://docs.connect.squareup.com/api/oauth#implementingoauth) for information about how to set up the redirect URL).
+    # @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<(ObtainTokenResponse, Fixnum, Hash)>] ObtainTokenResponse data, response status code and response headers
+    def obtain_token_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: OAuthApi.obtain_token ..."
+      end
+      # verify the required parameter 'body' is set
+      fail ArgumentError, "Missing the required parameter 'body' when calling OAuthApi.obtain_token" if body.nil?
+      # resource path
+      local_var_path = "/oauth2/token".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      
+      header_params['Square-Version'] = "2018-07-12"
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = []
+      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 => 'ObtainTokenResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: OAuthApi#obtain_token\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # RenewToken
+    # Renews an OAuth access token before it expires.  OAuth access tokens besides your application's personal access token expire after __30 days__. You can also renew expired tokens within __15 days__ of their expiration. You cannot renew an access token that has been expired for more than 15 days. Instead, the associated merchant must complete the [OAuth flow](https://docs.connect.squareup.com/api/oauth#implementingoauth) from the beginning.  __Important:__ The `Authorization` header you provide to this endpoint must have the following format:  ``` Authorization: Client APPLICATION_SECRET ```  Replace `APPLICATION_SECRET` with your application's secret, available from the [application dashboard](https://connect.squareup.com/apps).
+    # @param client_id Your application&#39;s ID, available from the [application dashboard](https://connect.squareup.com/apps).
+    # @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 [RenewTokenResponse]
+    def renew_token(client_id, body, opts = {})
+      data, _status_code, _headers = renew_token_with_http_info(client_id, body, opts)
+      return data
+    end
+
+    # RenewToken
+    # Renews an OAuth access token before it expires.  OAuth access tokens besides your application&#39;s personal access token expire after __30 days__. You can also renew expired tokens within __15 days__ of their expiration. You cannot renew an access token that has been expired for more than 15 days. Instead, the associated merchant must complete the [OAuth flow](https://docs.connect.squareup.com/api/oauth#implementingoauth) from the beginning.  __Important:__ The &#x60;Authorization&#x60; header you provide to this endpoint must have the following format:  &#x60;&#x60;&#x60; Authorization: Client APPLICATION_SECRET &#x60;&#x60;&#x60;  Replace &#x60;APPLICATION_SECRET&#x60; with your application&#39;s secret, available from the [application dashboard](https://connect.squareup.com/apps).
+    # @param client_id Your application&#39;s ID, available from the [application dashboard](https://connect.squareup.com/apps).
+    # @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<(RenewTokenResponse, Fixnum, Hash)>] RenewTokenResponse data, response status code and response headers
+    def renew_token_with_http_info(client_id, body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: OAuthApi.renew_token ..."
+      end
+      # verify the required parameter 'client_id' is set
+      fail ArgumentError, "Missing the required parameter 'client_id' when calling OAuthApi.renew_token" if client_id.nil?
+      # verify the required parameter 'body' is set
+      fail ArgumentError, "Missing the required parameter 'body' when calling OAuthApi.renew_token" if body.nil?
+      # resource path
+      local_var_path = "/oauth2/clients/{client_id}/access-token/renew".sub('{format}','json').sub('{' + 'client_id' + '}', client_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      
+      header_params['Square-Version'] = "2018-07-12"
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = ['oauth2ClientSecret']
+      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 => 'RenewTokenResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: OAuthApi#renew_token\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # RevokeToken
+    # Revokes an access token generated with the OAuth flow.  If a merchant has more than one access token for your application, this endpoint revokes all of them, regardless of which token you specify. If you revoke a merchant's access token, all of the merchant's active subscriptions associated with your application are canceled immediately.  __Important:__ The `Authorization` header you provide to this endpoint must have the following format:  ``` Authorization: Client APPLICATION_SECRET ```  Replace `APPLICATION_SECRET` with your application's secret, available from the [application dashboard](https://connect.squareup.com/apps).
+    # @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 [RevokeTokenResponse]
+    def revoke_token(body, opts = {})
+      data, _status_code, _headers = revoke_token_with_http_info(body, opts)
+      return data
+    end
+
+    # RevokeToken
+    # Revokes an access token generated with the OAuth flow.  If a merchant has more than one access token for your application, this endpoint revokes all of them, regardless of which token you specify. If you revoke a merchant&#39;s access token, all of the merchant&#39;s active subscriptions associated with your application are canceled immediately.  __Important:__ The &#x60;Authorization&#x60; header you provide to this endpoint must have the following format:  &#x60;&#x60;&#x60; Authorization: Client APPLICATION_SECRET &#x60;&#x60;&#x60;  Replace &#x60;APPLICATION_SECRET&#x60; with your application&#39;s secret, available from the [application dashboard](https://connect.squareup.com/apps).
+    # @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<(RevokeTokenResponse, Fixnum, Hash)>] RevokeTokenResponse data, response status code and response headers
+    def revoke_token_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: OAuthApi.revoke_token ..."
+      end
+      # verify the required parameter 'body' is set
+      fail ArgumentError, "Missing the required parameter 'body' when calling OAuthApi.revoke_token" if body.nil?
+      # resource path
+      local_var_path = "/oauth2/revoke".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      
+      header_params['Square-Version'] = "2018-07-12"
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = ['oauth2ClientSecret']
+      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 => 'RevokeTokenResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: OAuthApi#revoke_token\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end