Merge pull request #22 from square/release/4.1.0.20200122

Release/4.1.0.20200122

Author: jessdelacruzsantos

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Change Log
 
+## Version 4.1.0.20200122 (2020-01-22)
+
+* New field:  The **Employee** object now has an `is_owner` field.
+* New enumeration:  The **CardBrand** enumeration has a new `SQUARE_CAPITAL_CARD` enum value to support a Square one-time Installments payment.
+
+* New request body field constraint: The __Refund__ Payment request now requires a payment_id. 
+
 ## Version 4.0.0-20191217 (2019-12-17)
 !!!important
 Square is excited to announce the public release of customized SDKs for [Java](https://github.com/square/square-java-sdk) and [.NET](https://github.com/square/square-dotnet-sdk). For more information, see [Square SDKs](/sdks).

doc/apple-pay.md

@@ -29,11 +29,11 @@ def register_domain(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Register Domain Request`]($m/RegisterDomainRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Register Domain Request`](/doc/models/register-domain-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Register Domain Response`]($m/RegisterDomainResponse)
+[`Register Domain Response`](/doc/models/register-domain-response.md)
 
 ### Example Usage
 

doc/cash-drawers.md

@@ -34,15 +34,15 @@ def list_cash_drawer_shifts(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `location_id` | `string` | Query, Required | The ID of the location to query for a list of cash drawer shifts. |
-| `sort_order` | [`str (Sort Order)`]($m/SortOrder) | Query, Optional | The order in which cash drawer shifts are listed in the response,<br>based on their opened_at field. Default value: ASC |
+| `sort_order` | [`str (Sort Order)`](/doc/models/sort-order.md) | Query, Optional | The order in which cash drawer shifts are listed in the response,<br>based on their opened_at field. Default value: ASC |
 | `begin_time` | `string` | Query, Optional | The inclusive start time of the query on opened_at, in ISO 8601 format. |
 | `end_time` | `string` | Query, Optional | The exclusive end date of the query on opened_at, in ISO 8601 format. |
 | `limit` | `int` | Query, Optional | Number of cash drawer shift events in a page of results (200 by<br>default, 1000 max). |
 | `cursor` | `string` | Query, Optional | Opaque cursor for fetching the next page of results. |
 
 ### Response Type
 
-[`List Cash Drawer Shifts Response`]($m/ListCashDrawerShiftsResponse)
+[`List Cash Drawer Shifts Response`](/doc/models/list-cash-drawer-shifts-response.md)
 
 ### Example Usage
 
@@ -77,7 +77,7 @@ def retrieve_cash_drawer_shift(self,
 
 ### Response Type
 
-[`Retrieve Cash Drawer Shift Response`]($m/RetrieveCashDrawerShiftResponse)
+[`Retrieve Cash Drawer Shift Response`](/doc/models/retrieve-cash-drawer-shift-response.md)
 
 ### Example Usage
 
@@ -116,7 +116,7 @@ def list_cash_drawer_shift_events(self,
 
 ### Response Type
 
-[`List Cash Drawer Shift Events Response`]($m/ListCashDrawerShiftEventsResponse)
+[`List Cash Drawer Shift Events Response`](/doc/models/list-cash-drawer-shift-events-response.md)
 
 ### Example Usage
 

doc/catalog.md

@@ -45,11 +45,11 @@ def batch_delete_catalog_objects(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Batch Delete Catalog Objects Request`]($m/BatchDeleteCatalogObjectsRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Batch Delete Catalog Objects Request`](/doc/models/batch-delete-catalog-objects-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Batch Delete Catalog Objects Response`]($m/BatchDeleteCatalogObjectsResponse)
+[`Batch Delete Catalog Objects Response`](/doc/models/batch-delete-catalog-objects-response.md)
 
 ### Example Usage
 
@@ -83,11 +83,11 @@ def batch_retrieve_catalog_objects(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Batch Retrieve Catalog Objects Request`]($m/BatchRetrieveCatalogObjectsRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Batch Retrieve Catalog Objects Request`](/doc/models/batch-retrieve-catalog-objects-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Batch Retrieve Catalog Objects Response`]($m/BatchRetrieveCatalogObjectsResponse)
+[`Batch Retrieve Catalog Objects Response`](/doc/models/batch-retrieve-catalog-objects-response.md)
 
 ### Example Usage
 
@@ -125,11 +125,11 @@ def batch_upsert_catalog_objects(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Batch Upsert Catalog Objects Request`]($m/BatchUpsertCatalogObjectsRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Batch Upsert Catalog Objects Request`](/doc/models/batch-upsert-catalog-objects-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Batch Upsert Catalog Objects Response`]($m/BatchUpsertCatalogObjectsResponse)
+[`Batch Upsert Catalog Objects Response`](/doc/models/batch-upsert-catalog-objects-response.md)
 
 ### Example Usage
 
@@ -251,12 +251,12 @@ def create_catalog_image(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `request` | [`Create Catalog Image Request`]($m/CreateCatalogImageRequest) | Form, Optional | - |
+| `request` | [`Create Catalog Image Request`](/doc/models/create-catalog-image-request.md) | Form, Optional | - |
 | `image_file` | `string` | Form, Optional | - |
 
 ### Response Type
 
-[`Create Catalog Image Response`]($m/CreateCatalogImageResponse)
+[`Create Catalog Image Response`](/doc/models/create-catalog-image-response.md)
 
 ### Example Usage
 
@@ -287,7 +287,7 @@ def catalog_info(self)
 
 ### Response Type
 
-[`Catalog Info Response`]($m/CatalogInfoResponse)
+[`Catalog Info Response`](/doc/models/catalog-info-response.md)
 
 ### Example Usage
 
@@ -327,7 +327,7 @@ def list_catalog(self,
 
 ### Response Type
 
-[`List Catalog Response`]($m/ListCatalogResponse)
+[`List Catalog Response`](/doc/models/list-catalog-response.md)
 
 ### Example Usage
 
@@ -353,11 +353,11 @@ def upsert_catalog_object(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Upsert Catalog Object Request`]($m/UpsertCatalogObjectRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Upsert Catalog Object Request`](/doc/models/upsert-catalog-object-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Upsert Catalog Object Response`]($m/UpsertCatalogObjectResponse)
+[`Upsert Catalog Object Response`](/doc/models/upsert-catalog-object-response.md)
 
 ### Example Usage
 
@@ -402,7 +402,7 @@ def delete_catalog_object(self,
 
 ### Response Type
 
-[`Delete Catalog Object Response`]($m/DeleteCatalogObjectResponse)
+[`Delete Catalog Object Response`](/doc/models/delete-catalog-object-response.md)
 
 ### Example Usage
 
@@ -442,7 +442,7 @@ def retrieve_catalog_object(self,
 
 ### Response Type
 
-[`Retrieve Catalog Object Response`]($m/RetrieveCatalogObjectResponse)
+[`Retrieve Catalog Object Response`](/doc/models/retrieve-catalog-object-response.md)
 
 ### Example Usage
 
@@ -483,11 +483,11 @@ def search_catalog_objects(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Search Catalog Objects Request`]($m/SearchCatalogObjectsRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Search Catalog Objects Request`](/doc/models/search-catalog-objects-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Search Catalog Objects Response`]($m/SearchCatalogObjectsResponse)
+[`Search Catalog Objects Response`](/doc/models/search-catalog-objects-response.md)
 
 ### Example Usage
 
@@ -523,11 +523,11 @@ def update_item_modifier_lists(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Update Item Modifier Lists Request`]($m/UpdateItemModifierListsRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Update Item Modifier Lists Request`](/doc/models/update-item-modifier-lists-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Update Item Modifier Lists Response`]($m/UpdateItemModifierListsResponse)
+[`Update Item Modifier Lists Response`](/doc/models/update-item-modifier-lists-response.md)
 
 ### Example Usage
 
@@ -560,11 +560,11 @@ def update_item_taxes(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Update Item Taxes Request`]($m/UpdateItemTaxesRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Update Item Taxes Request`](/doc/models/update-item-taxes-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Update Item Taxes Response`]($m/UpdateItemTaxesResponse)
+[`Update Item Taxes Response`](/doc/models/update-item-taxes-response.md)
 
 ### Example Usage
 

doc/checkout.md

@@ -25,11 +25,11 @@ def create_checkout(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `location_id` | `string` | Template, Required | The ID of the business location to associate the checkout with. |
-| `body` | [`Create Checkout Request`]($m/CreateCheckoutRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Create Checkout Request`](/doc/models/create-checkout-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Create Checkout Response`]($m/CreateCheckoutResponse)
+[`Create Checkout Response`](/doc/models/create-checkout-response.md)
 
 ### Example Usage
 

doc/customers.md

@@ -35,12 +35,12 @@ def list_customers(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `cursor` | `string` | Query, Optional | A pagination cursor returned by a previous call to this endpoint.<br>Provide this to retrieve the next set of results for your original query.<br><br>See the [Pagination guide](https://developer.squareup.com/docs/working-with-apis/pagination) for more information. |
-| `sort_field` | [`str (Customer Sort Field)`]($m/CustomerSortField) | Query, Optional | Indicates how Customers should be sorted.<br><br>Default: `DEFAULT`. |
-| `sort_order` | [`str (Sort Order)`]($m/SortOrder) | Query, Optional | Indicates whether Customers should be sorted in ascending (`ASC`) or<br>descending (`DESC`) order.<br><br>Default: `ASC`. |
+| `sort_field` | [`str (Customer Sort Field)`](/doc/models/customer-sort-field.md) | Query, Optional | Indicates how Customers should be sorted.<br><br>Default: `DEFAULT`. |
+| `sort_order` | [`str (Sort Order)`](/doc/models/sort-order.md) | Query, Optional | Indicates whether Customers should be sorted in ascending (`ASC`) or<br>descending (`DESC`) order.<br><br>Default: `ASC`. |
 
 ### Response Type
 
-[`List Customers Response`]($m/ListCustomersResponse)
+[`List Customers Response`](/doc/models/list-customers-response.md)
 
 ### Example Usage
 
@@ -75,11 +75,11 @@ def create_customer(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Create Customer Request`]($m/CreateCustomerRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Create Customer Request`](/doc/models/create-customer-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Create Customer Response`]($m/CreateCustomerResponse)
+[`Create Customer Response`](/doc/models/create-customer-response.md)
 
 ### Example Usage
 
@@ -123,11 +123,11 @@ def search_customers(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `body` | [`Search Customers Request`]($m/SearchCustomersRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Search Customers Request`](/doc/models/search-customers-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Search Customers Response`]($m/SearchCustomersResponse)
+[`Search Customers Response`](/doc/models/search-customers-response.md)
 
 ### Example Usage
 
@@ -173,7 +173,7 @@ def delete_customer(self,
 
 ### Response Type
 
-[`Delete Customer Response`]($m/DeleteCustomerResponse)
+[`Delete Customer Response`](/doc/models/delete-customer-response.md)
 
 ### Example Usage
 
@@ -205,7 +205,7 @@ def retrieve_customer(self,
 
 ### Response Type
 
-[`Retrieve Customer Response`]($m/RetrieveCustomerResponse)
+[`Retrieve Customer Response`](/doc/models/retrieve-customer-response.md)
 
 ### Example Usage
 
@@ -242,11 +242,11 @@ def update_customer(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `customer_id` | `string` | Template, Required | The ID of the customer to update. |
-| `body` | [`Update Customer Request`]($m/UpdateCustomerRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Update Customer Request`](/doc/models/update-customer-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Update Customer Response`]($m/UpdateCustomerResponse)
+[`Update Customer Response`](/doc/models/update-customer-response.md)
 
 ### Example Usage
 
@@ -284,11 +284,11 @@ def create_customer_card(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `customer_id` | `string` | Template, Required | The Square ID of the customer profile the card is linked to. |
-| `body` | [`Create Customer Card Request`]($m/CreateCustomerCardRequest) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+| `body` | [`Create Customer Card Request`](/doc/models/create-customer-card-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ### Response Type
 
-[`Create Customer Card Response`]($m/CreateCustomerCardResponse)
+[`Create Customer Card Response`](/doc/models/create-customer-card-response.md)
 
 ### Example Usage
 
@@ -332,7 +332,7 @@ def delete_customer_card(self,
 
 ### Response Type
 
-[`Delete Customer Card Response`]($m/DeleteCustomerCardResponse)
+[`Delete Customer Card Response`](/doc/models/delete-customer-card-response.md)
 
 ### Example Usage
 

doc/employees.md

@@ -30,13 +30,13 @@ def list_employees(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `location_id` | `string` | Query, Optional | Filter employees returned to only those that are associated with the specified location. |
-| `status` | [`str (Employee Status)`]($m/EmployeeStatus) | Query, Optional | Specifies the EmployeeStatus to filter the employee by. |
+| `status` | [`str (Employee Status)`](/doc/models/employee-status.md) | Query, Optional | Specifies the EmployeeStatus to filter the employee by. |
 | `limit` | `int` | Query, Optional | The number of employees to be returned on each page. |
 | `cursor` | `string` | Query, Optional | The token required to retrieve the specified page of results. |
 
 ### Response Type
 
-[`List Employees Response`]($m/ListEmployeesResponse)
+[`List Employees Response`](/doc/models/list-employees-response.md)
 
 ### Example Usage
 
@@ -66,7 +66,7 @@ def retrieve_employee(self,
 
 ### Response Type
 
-[`Retrieve Employee Response`]($m/RetrieveEmployeeResponse)
+[`Retrieve Employee Response`](/doc/models/retrieve-employee-response.md)
 
 ### Example Usage