Merge pull request #96 from square/release/20.1.0.20220720

Generated PR for Release: 20.1.0.20220720

doc/models/obtain-token-request.md

@@ -18,6 +18,7 @@
 | `migration_token` | `string` | Optional | A legacy OAuth access token obtained using a Connect API version prior<br>to 2019-03-13. This parameter is required if `grant_type` is set to<br>`migration_token` to indicate that the application wants to get a replacement<br>OAuth access token. The response also returns a refresh token.<br>For more information, see [Migrate to Using Refresh Tokens](https://developer.squareup.com/docs/oauth-api/migrate-to-refresh-tokens).<br>**Constraints**: *Minimum Length*: `2`, *Maximum Length*: `1024` |
 | `scopes` | `List of string` | Optional | A JSON list of strings representing the permissions that the application is requesting.<br>For example, "`["MERCHANT_PROFILE_READ","PAYMENTS_READ","BANK_ACCOUNTS_READ"]`".<br><br>The access token returned in the response is granted the permissions<br>that comprise the intersection between the requested list of permissions and those<br>that belong to the provided refresh token. |
 | `short_lived` | `bool` | Optional | A Boolean indicating a request for a short-lived access token.<br><br>The short-lived access token returned in the response expires in 24 hours. |
+| `code_verifier` | `string` | Optional | Must be provided when using PKCE OAuth flow. The `code_verifier` will be used to verify against the<br>`code_challenge` associated with the `authorization_code`. |
 
 ## Example (as JSON)
 

doc/models/obtain-token-response.md

@@ -19,6 +19,9 @@
 | `refresh_token` | `string` | Optional | A refresh token. OAuth refresh tokens are 64 bytes long.<br>For more information, see [Refresh, Revoke, and Limit the Scope of OAuth Tokens](https://developer.squareup.com/docs/oauth-api/refresh-revoke-limit-scope).<br>**Constraints**: *Minimum Length*: `2`, *Maximum Length*: `1024` |
 | `short_lived` | `bool` | Optional | A Boolean indicating that the access token is a short-lived access token.<br>The short-lived access token returned in the response expires in 24 hours. |
 | `errors` | [`List of Error`](../../doc/models/error.md) | Optional | Any errors that occurred during the request. |
+| `refresh_token_expires_at` | `string` | Optional | The date when the `refresh_token` expires, in [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm) format.<br>**Constraints**: *Minimum Length*: `20`, *Maximum Length*: `48` |
+| `app_subscription_id` | `string` | Optional | The subscription id of a v2 subscription the merchant signed up<br>for. The subscription id is only present if the merchant signed up for a subscription during authorization. |
+| `app_plan_id` | `string` | Optional | The plan id of a v2 subscription plan the merchant signed up<br>for. The plan id is only present if the merchant signed up for a subscription plan during authorization. |
 
 ## Example (as JSON)
 

setup.py

@@ -12,7 +12,7 @@
 
 setup(
     name='squareup',
-    version='20.0.0.20220720',
+    version='20.1.0.20220720',
     description='Use Square APIs to manage and run business including payment, customer, product, inventory, and employee management.',
     long_description=long_description,
     long_description_content_type="text/markdown",

square/api/base_api.py

@@ -89,7 +89,7 @@ def execute_request(self, request, binary=False, to_retry=None):
         return response
 
     def get_user_agent(self):
-        user_agent = 'Square-Python-SDK/20.0.0.20220720 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
+        user_agent = 'Square-Python-SDK/20.1.0.20220720 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
         parameters = {
             'engine': {'value': platform.python_implementation(), 'encode': False},
             'engine-version': {'value': "", 'encode': False},

square/client.py

@@ -46,7 +46,7 @@ class Client(object):
 
     @staticmethod
     def sdk_version():
-        return '20.0.0.20220720'
+        return '20.1.0.20220720'
 
     @staticmethod
     def square_version():