Merge pull request #2 from square/release/4.1.0.20200122

Release/4.1.0.20200122

Author: jessdelacruzsantos

CHANGELOG.md

@@ -0,0 +1,17 @@
+# 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)
+* Square is excited to announce the public release of customized SDK for Java
+
+* __GA release:__ SDKs updated to support new `receipt_url` and `receipt_number` fields added to the  [Payment](${SQUARE_TECH_REF}/objects/Payment) type.  
+
+* __Beta release:__ SDKs updated to support the new [CashDrawerShifts](cashdrawershift-api/reporting) API.
+
+* Square now follows the semantic versioning scheme for all SDKs except PHP and Node.js. This versioning scheme uses three numbers to delineate MAJOR, MINOR, and PATCH versions of our SDK. In addition, the SDK version also includes the API version so you know what Square API version the SDK is related to. For more information, see [Versioning and SDKs](build-basics/versioning-overview#versioning-and-sdks).
+* Java, .Net, Python, and Ruby SDKs are now version 4.0.0. Java and .Net SDKs have breaking changes in version 4.0.0. Ruby and Python do not have breaking changes.

README.md

@@ -33,7 +33,7 @@ Install the client dynamically by adding a dependency to the POM for your projec
 <dependency>
     <groupId>com.squareup</groupId>
     <artifactId>square</artifactId>
-    <version>4.0.0.20191217</version>
+    <version>4.1.0.20200122</version>
 </dependency>
 ```
 
@@ -42,7 +42,7 @@ Install the client dynamically by adding a dependency to the POM for your projec
 Install the client by adding the following dependency to the build file for your project:
 
 ```
-implementation "com.squareup:square:4.0.0.20191217"
+implementation "com.squareup:square:4.1.0.20200122"
 ```
 
 

doc/apple-pay.md

@@ -22,8 +22,7 @@ To learn more about Apple Pay on Web see the Apple Pay section in the
 
 ```java
 CompletableFuture<RegisterDomainResponse> registerDomainAsync(
-    final RegisterDomainRequest body
-)
+    final RegisterDomainRequest body)
 ```
 
 ### Parameters

doc/cash-drawers.md

@@ -26,8 +26,7 @@ CompletableFuture<ListCashDrawerShiftsResponse> listCashDrawerShiftsAsync(
     final String beginTime,
     final String endTime,
     final Integer limit,
-    final String cursor
-)
+    final String cursor)
 ```
 
 ### Parameters
@@ -66,8 +65,7 @@ RetrieveCashDrawerShiftEvents for a list of cash drawer shift events.
 ```java
 CompletableFuture<RetrieveCashDrawerShiftResponse> retrieveCashDrawerShiftAsync(
     final String locationId,
-    final String shiftId
-)
+    final String shiftId)
 ```
 
 ### Parameters
@@ -104,8 +102,7 @@ CompletableFuture<ListCashDrawerShiftEventsResponse> listCashDrawerShiftEventsAs
     final String locationId,
     final String shiftId,
     final Integer limit,
-    final String cursor
-)
+    final String cursor)
 ```
 
 ### Parameters

doc/catalog.md

@@ -38,8 +38,7 @@ actually deleted.
 
 ```java
 CompletableFuture<BatchDeleteCatalogObjectsResponse> batchDeleteCatalogObjectsAsync(
-    final BatchDeleteCatalogObjectsRequest body
-)
+    final BatchDeleteCatalogObjectsRequest body)
 ```
 
 ### Parameters
@@ -81,8 +80,7 @@ any [CatalogTax](#type-catalogtax) objects that apply to it.
 
 ```java
 CompletableFuture<BatchRetrieveCatalogObjectsResponse> batchRetrieveCatalogObjectsAsync(
-    final BatchRetrieveCatalogObjectsRequest body
-)
+    final BatchRetrieveCatalogObjectsRequest body)
 ```
 
 ### Parameters
@@ -128,8 +126,7 @@ than 10,000.
 
 ```java
 CompletableFuture<BatchUpsertCatalogObjectsResponse> batchUpsertCatalogObjectsAsync(
-    final BatchUpsertCatalogObjectsRequest body
-)
+    final BatchUpsertCatalogObjectsRequest body)
 ```
 
 ### Parameters
@@ -315,8 +312,7 @@ Additional information and an example cURL request can be found in the [Create a
 ```java
 CompletableFuture<CreateCatalogImageResponse> createCatalogImageAsync(
     final CreateCatalogImageRequest request,
-    final File imageFile
-)
+    final File imageFile)
 ```
 
 ### Parameters
@@ -394,8 +390,7 @@ to `true`.
 ```java
 CompletableFuture<ListCatalogResponse> listCatalogAsync(
     final String cursor,
-    final String types
-)
+    final String types)
 ```
 
 ### Parameters
@@ -426,8 +421,7 @@ Creates or updates the target [CatalogObject](#type-catalogobject).
 
 ```java
 CompletableFuture<UpsertCatalogObjectResponse> upsertCatalogObjectAsync(
-    final UpsertCatalogObjectRequest body
-)
+    final UpsertCatalogObjectRequest body)
 ```
 
 ### Parameters
@@ -477,8 +471,7 @@ will also delete all of its
 
 ```java
 CompletableFuture<DeleteCatalogObjectResponse> deleteCatalogObjectAsync(
-    final String objectId
-)
+    final String objectId)
 ```
 
 ### Parameters
@@ -517,8 +510,7 @@ any [CatalogTax](#type-catalogtax) objects that apply to it.
 ```java
 CompletableFuture<RetrieveCatalogObjectResponse> retrieveCatalogObjectAsync(
     final String objectId,
-    final Boolean includeRelatedObjects
-)
+    final Boolean includeRelatedObjects)
 ```
 
 ### Parameters
@@ -564,8 +556,7 @@ Future end of the above comment:
 
 ```java
 CompletableFuture<SearchCatalogObjectsResponse> searchCatalogObjectsAsync(
-    final SearchCatalogObjectsRequest body
-)
+    final SearchCatalogObjectsRequest body)
 ```
 
 ### Parameters
@@ -612,8 +603,7 @@ to perform an upsert on the entire item.
 
 ```java
 CompletableFuture<UpdateItemModifierListsResponse> updateItemModifierListsAsync(
-    final UpdateItemModifierListsRequest body
-)
+    final UpdateItemModifierListsRequest body)
 ```
 
 ### Parameters
@@ -659,8 +649,7 @@ upsert on the entire item.
 
 ```java
 CompletableFuture<UpdateItemTaxesResponse> updateItemTaxesAsync(
-    final UpdateItemTaxesRequest body
-)
+    final UpdateItemTaxesRequest body)
 ```
 
 ### Parameters

doc/checkout.md

@@ -17,8 +17,7 @@ payment processing workflow hosted on connect.squareup.com.
 ```java
 CompletableFuture<CreateCheckoutResponse> createCheckoutAsync(
     final String locationId,
-    final CreateCheckoutRequest body
-)
+    final CreateCheckoutRequest body)
 ```
 
 ### Parameters

doc/customers.md

@@ -27,8 +27,7 @@ Lists a business's customers.
 CompletableFuture<ListCustomersResponse> listCustomersAsync(
     final String cursor,
     final String sortField,
-    final String sortOrder
-)
+    final String sortOrder)
 ```
 
 ### Parameters
@@ -69,8 +68,7 @@ endpoint:
 
 ```java
 CompletableFuture<CreateCustomerResponse> createCustomerAsync(
-    final CreateCustomerRequest body
-)
+    final CreateCustomerRequest body)
 ```
 
 ### Parameters
@@ -121,8 +119,7 @@ customer profiles ordered alphabetically based on `given_name` and
 
 ```java
 CompletableFuture<SearchCustomersResponse> searchCustomersAsync(
-    final SearchCustomersRequest body
-)
+    final SearchCustomersRequest body)
 ```
 
 ### Parameters
@@ -181,8 +178,7 @@ new `customer_id` to delete merged profiles.
 
 ```java
 CompletableFuture<DeleteCustomerResponse> deleteCustomerAsync(
-    final String customerId
-)
+    final String customerId)
 ```
 
 ### Parameters
@@ -214,8 +210,7 @@ Returns details for a single customer.
 
 ```java
 CompletableFuture<RetrieveCustomerResponse> retrieveCustomerAsync(
-    final String customerId
-)
+    final String customerId)
 ```
 
 ### Parameters
@@ -255,8 +250,7 @@ to a card on file, you must delete the existing card on file with the
 ```java
 CompletableFuture<UpdateCustomerResponse> updateCustomerAsync(
     final String customerId,
-    final UpdateCustomerRequest body
-)
+    final UpdateCustomerRequest body)
 ```
 
 ### Parameters
@@ -299,8 +293,7 @@ with the provided nonce during the _first_ call.
 ```java
 CompletableFuture<CreateCustomerCardResponse> createCustomerCardAsync(
     final String customerId,
-    final CreateCustomerCardRequest body
-)
+    final CreateCustomerCardRequest body)
 ```
 
 ### Parameters
@@ -347,8 +340,7 @@ Removes a card on file from a customer.
 ```java
 CompletableFuture<DeleteCustomerCardResponse> deleteCustomerCardAsync(
     final String customerId,
-    final String cardId
-)
+    final String cardId)
 ```
 
 ### Parameters

doc/employees.md

@@ -22,8 +22,7 @@ CompletableFuture<ListEmployeesResponse> listEmployeesAsync(
     final String locationId,
     final String status,
     final Integer limit,
-    final String cursor
-)
+    final String cursor)
 ```
 
 ### Parameters
@@ -56,8 +55,7 @@ RetrieveEmployee
 
 ```java
 CompletableFuture<RetrieveEmployeeResponse> retrieveEmployeeAsync(
-    final String id
-)
+    final String id)
 ```
 
 ### Parameters

doc/inventory.md

@@ -25,8 +25,7 @@ with the provided `adjustment_id`.
 
 ```java
 CompletableFuture<RetrieveInventoryAdjustmentResponse> retrieveInventoryAdjustmentAsync(
-    final String adjustmentId
-)
+    final String adjustmentId)
 ```
 
 ### Parameters
@@ -62,8 +61,7 @@ On failure: returns a list of related errors.
 
 ```java
 CompletableFuture<BatchChangeInventoryResponse> batchChangeInventoryAsync(
-    final BatchChangeInventoryRequest body
-)
+    final BatchChangeInventoryRequest body)
 ```
 
 ### Parameters
@@ -123,8 +121,7 @@ that cannot be handled by other, simpler endpoints.
 
 ```java
 CompletableFuture<BatchRetrieveInventoryChangesResponse> batchRetrieveInventoryChangesAsync(
-    final BatchRetrieveInventoryChangesRequest body
-)
+    final BatchRetrieveInventoryChangesRequest body)
 ```
 
 ### Parameters
@@ -181,8 +178,7 @@ in response to receiving a Webhook notification.
 
 ```java
 CompletableFuture<BatchRetrieveInventoryCountsResponse> batchRetrieveInventoryCountsAsync(
-    final BatchRetrieveInventoryCountsRequest body
-)
+    final BatchRetrieveInventoryCountsRequest body)
 ```
 
 ### Parameters
@@ -223,8 +219,7 @@ object with the provided `physical_count_id`.
 
 ```java
 CompletableFuture<RetrieveInventoryPhysicalCountResponse> retrieveInventoryPhysicalCountAsync(
-    final String physicalCountId
-)
+    final String physicalCountId)
 ```
 
 ### Parameters
@@ -261,8 +256,7 @@ For more sophisticated queries, use a batch endpoint.
 CompletableFuture<RetrieveInventoryCountResponse> retrieveInventoryCountAsync(
     final String catalogObjectId,
     final String locationIds,
-    final String cursor
-)
+    final String cursor)
 ```
 
 ### Parameters
@@ -307,8 +301,7 @@ sophisticated queries, use a batch endpoint.
 CompletableFuture<RetrieveInventoryChangesResponse> retrieveInventoryChangesAsync(
     final String catalogObjectId,
     final String locationIds,
-    final String cursor
-)
+    final String cursor)
 ```
 
 ### Parameters