Release 2.20181205.0 (#50)

Author: ssung88

.vscode/settings.json

@@ -1,3 +1,3 @@
 {
     "java.configuration.updateBuildConfiguration": "disabled"
-}
+}

CHANGES.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## Version 2.20181205.0 (2018-12-05)
+
+## New feature: Idempotent customer profile creation in Connect v2
+
+Requests to the CreateCustomer endpoint now include a `idempotency_key` field to
+ensure idempotent creation of new profiles.
+
+## New feature: Refund Adjustment fields for Refunds in Connect v1
+
+The Connect SDK now supports refund adjustments for the Connect v1
+Refunds API with the addition of multiple new fields in the `Refund` data type
+
 ## Version 2.20180918.1 (2018-10-24)
 
 ### New feature: Support for Partial Payments in Connect v1

README.md

@@ -18,7 +18,7 @@ Add this dependency to your project's POM:
 <dependency>
     <groupId>com.squareup</groupId>
     <artifactId>connect</artifactId>
-    <version>2.20180918.1</version>
+    <version>2.20181205.0</version>
     <scope>compile</scope>
 </dependency>
 ```
@@ -28,7 +28,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.squareup:connect:2.20180918.1"
+compile "com.squareup:connect:2.20181205.0"
 ```
 
 ### Build and Install locally
@@ -47,7 +47,7 @@ At first generate the JAR by executing:
 
 Then manually install the following JARs:
 
-* target/connect-2.20180918.1.jar
+* target/connect-2.20181205.0.jar
 * target/lib/*.jar
 
 ## Getting Started

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'com.squareup'
-version = '2.20180918.1'
+version = '2.20181205.0'
 
 buildscript {
     repositories {

docs/Card.md

@@ -4,14 +4,14 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **String** | The card's unique ID, if any. |  [optional]
+**id** | **String** | Unique ID for this card. Generated by Square. |  [optional]
 **cardBrand** | [**CardBrandEnum**](#CardBrandEnum) | The card's brand (such as `VISA`). See [CardBrand](#type-cardbrand) for all possible values. |  [optional]
-**last4** | **String** | The last 4 digits of the card's number. |  [optional]
-**expMonth** | **Long** | The month of the card's expiration date. This value is always between `1` and `12`, inclusive. |  [optional]
+**last4** | **String** | The last 4 digits of the card number. |  [optional]
+**expMonth** | **Long** | The expiration month of the associated card as an integer between 1 and 12. |  [optional]
 **expYear** | **Long** | The four-digit year of the card's expiration date. |  [optional]
-**cardholderName** | **String** | The cardholder name. This value is present only if this object represents a customer's card on file. |  [optional]
-**billingAddress** | [**Address**](Address.md) | The card's billing address. This value is present only if this object represents a customer's card on file. |  [optional]
-**fingerprint** | **String** | The unique string fingerprint for the card. The fingerprint is based on the credit card number and is unique to the merchant. If a card is used at multiple locations for the same merchant, it will have the same fingerprint in each case. Note: Fingerprint may not exist on old transactions. |  [optional]
+**cardholderName** | **String** | The name of the cardholder. |  [optional]
+**billingAddress** | [**Address**](Address.md) | The billing address for this card. |  [optional]
+**fingerprint** | **String** | __Not currently set.__ Intended as a Square-assigned identifier, based  on the card number, to identify the card across multiple locations within a single application. |  [optional]
 
 
 <a name="CardBrandEnum"></a>

docs/CreateCustomerRequest.md

@@ -4,6 +4,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**idempotencyKey** | **String** | The idempotency key for the request. See the [Idempotency](/basics/api101/idempotency) guide for more information. |  [optional]
 **givenName** | **String** | The customer's given (i.e., first) name. |  [optional]
 **familyName** | **String** | The customer's family (i.e., last) name. |  [optional]
 **companyName** | **String** | The name of the customer's company. |  [optional]

docs/Customer.md

@@ -7,7 +7,7 @@ Name | Type | Description | Notes
 **id** | **String** | The customer's unique ID. | 
 **createdAt** | **String** | The time when the customer was created, in RFC 3339 format. | 
 **updatedAt** | **String** | The time when the customer was last updated, in RFC 3339 format. | 
-**cards** | [**List<Card>**](Card.md) | The non-confidential details of the customer's cards on file. |  [optional]
+**cards** | [**List<Card>**](Card.md) | The payment details of the customer's cards on file. |  [optional]
 **givenName** | **String** | The customer's given (i.e., first) name. |  [optional]
 **familyName** | **String** | The customer's family (i.e., last) name. |  [optional]
 **nickname** | **String** | The customer's nickname. |  [optional]

docs/CustomersApi.md

@@ -73,7 +73,7 @@ Name | Type | Description  | Notes
 
 CreateCustomerCard
 
-Adds a card on file to an existing customer. In the United States Square takes care of automatically updating any cards on file that might have expired since you first attached them to a customer.  As with charges, calls to `CreateCustomerCard` are idempotent. Multiple calls with the same card nonce return the same card record that was created with the provided nonce during the _first_ call.
+Adds a card on file to an existing customer.  As with charges, calls to `CreateCustomerCard` are idempotent. Multiple calls with the same card nonce return the same card record that was created with the provided nonce during the _first_ call.
 
 ### Example
 ```java

docs/Error.md

@@ -62,6 +62,7 @@ EXPECTED_FLOAT | "EXPECTED_FLOAT"
 EXPECTED_STRING | "EXPECTED_STRING"
 EXPECTED_OBJECT | "EXPECTED_OBJECT"
 EXPECTED_ARRAY | "EXPECTED_ARRAY"
+EXPECTED_MAP | "EXPECTED_MAP"
 EXPECTED_BASE64_ENCODED_BYTE_ARRAY | "EXPECTED_BASE64_ENCODED_BYTE_ARRAY"
 INVALID_ARRAY_VALUE | "INVALID_ARRAY_VALUE"
 INVALID_ENUM_VALUE | "INVALID_ENUM_VALUE"
@@ -76,6 +77,7 @@ INVALID_EXPIRATION_YEAR | "INVALID_EXPIRATION_YEAR"
 INVALID_EXPIRATION_DATE | "INVALID_EXPIRATION_DATE"
 UNSUPPORTED_CARD_BRAND | "UNSUPPORTED_CARD_BRAND"
 UNSUPPORTED_ENTRY_METHOD | "UNSUPPORTED_ENTRY_METHOD"
+INVALID_ENCRYPTED_CARD | "INVALID_ENCRYPTED_CARD"
 INVALID_CARD | "INVALID_CARD"
 DELAYED_TRANSACTION_EXPIRED | "DELAYED_TRANSACTION_EXPIRED"
 DELAYED_TRANSACTION_CANCELED | "DELAYED_TRANSACTION_CANCELED"

docs/ErrorCode.md

@@ -76,6 +76,8 @@
 
 * `EXPECTED_ARRAY` (value: `"EXPECTED_ARRAY"`)
 
+* `EXPECTED_MAP` (value: `"EXPECTED_MAP"`)
+
 * `EXPECTED_BASE64_ENCODED_BYTE_ARRAY` (value: `"EXPECTED_BASE64_ENCODED_BYTE_ARRAY"`)
 
 * `INVALID_ARRAY_VALUE` (value: `"INVALID_ARRAY_VALUE"`)
@@ -104,6 +106,8 @@
 
 * `UNSUPPORTED_ENTRY_METHOD` (value: `"UNSUPPORTED_ENTRY_METHOD"`)
 
+* `INVALID_ENCRYPTED_CARD` (value: `"INVALID_ENCRYPTED_CARD"`)
+
 * `INVALID_CARD` (value: `"INVALID_CARD"`)
 
 * `DELAYED_TRANSACTION_EXPIRED` (value: `"DELAYED_TRANSACTION_EXPIRED"`)