Release 2.20181205.0 (#81)

Author: ssung88

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

docs/Card.md

@@ -3,19 +3,19 @@
 
 ### Description
 
-Represents the non-confidential details of a credit card.
+Represents the payment details of a card to be used for payments. These details are determined by the `card_nonce` generated by `SqPaymentForm`.
 
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **str** | The card's unique ID, if any. | [optional] 
+**id** | **str** | Unique ID for this card. Generated by Square. | [optional] 
 **card_brand** | **str** | The card's brand (such as `VISA`). See [CardBrand](#type-cardbrand) for all possible values. | [optional] 
-**last_4** | **str** | The last 4 digits of the card's number. | [optional] 
-**exp_month** | **int** | The month of the card's expiration date. This value is always between `1` and `12`, inclusive. | [optional] 
+**last_4** | **str** | The last 4 digits of the card number. | [optional] 
+**exp_month** | **int** | The expiration month of the associated card as an integer between 1 and 12. | [optional] 
 **exp_year** | **int** | The four-digit year of the card's expiration date. | [optional] 
-**cardholder_name** | **str** | The cardholder name. This value is present only if this object represents a customer's card on file. | [optional] 
-**billing_address** | [**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** | **str** | 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] 
+**cardholder_name** | **str** | The name of the cardholder. | [optional] 
+**billing_address** | [**Address**](Address.md) | The billing address for this card. | [optional] 
+**fingerprint** | **str** | __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] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/CardBrand.md

@@ -3,7 +3,7 @@
 
 ### Description
 
-Indicates a credit card's brand, such as `VISA`.
+Indicates a credit card's brand, such as `VISA` or `MASTERCARD`.
 
 ## Properties
 Name | Type

docs/CreateCustomerRequest.md

@@ -8,6 +8,7 @@ Defines the body parameters that can be provided in a request to the [CreateCust
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**idempotency_key** | **str** | The idempotency key for the request. See the [Idempotency](/basics/api101/idempotency) guide for more information. | [optional] 
 **given_name** | **str** | The customer's given (i.e., first) name. | [optional] 
 **family_name** | **str** | The customer's family (i.e., last) name. | [optional] 
 **company_name** | **str** | The name of the customer's company. | [optional] 

docs/Customer.md

@@ -11,7 +11,7 @@ Name | Type | Description | Notes
 **id** | **str** | The customer's unique ID. | 
 **created_at** | **str** | The time when the customer was created, in RFC 3339 format. | 
 **updated_at** | **str** | 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] 
 **given_name** | **str** | The customer's given (i.e., first) name. | [optional] 
 **family_name** | **str** | The customer's family (i.e., last) name. | [optional] 
 **nickname** | **str** | The customer's nickname. | [optional] 

docs/CustomersApi.md

@@ -44,7 +44,7 @@ Assign your **Access Token** from developer portal to the authorization paramete
 
 ### Description
 
-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.
 
 ### Parameters
 

docs/ErrorCode.md

@@ -44,6 +44,7 @@ Name | Type
 **EXPECTED_STRING** | string
 **EXPECTED_OBJECT** | string
 **EXPECTED_ARRAY** | string
+**EXPECTED_MAP** | string
 **EXPECTED_BASE64_ENCODED_BYTE_ARRAY** | string
 **INVALID_ARRAY_VALUE** | string
 **INVALID_ENUM_VALUE** | string
@@ -58,6 +59,7 @@ Name | Type
 **INVALID_EXPIRATION_DATE** | string
 **UNSUPPORTED_CARD_BRAND** | string
 **UNSUPPORTED_ENTRY_METHOD** | string
+**INVALID_ENCRYPTED_CARD** | string
 **INVALID_CARD** | string
 **DELAYED_TRANSACTION_EXPIRED** | string
 **DELAYED_TRANSACTION_CANCELED** | string

docs/InventoryApi.md

@@ -66,7 +66,7 @@ Assign your **Access Token** from developer portal to the authorization paramete
 
 ### Description
 
-Returns current counts for the provided [CatalogObject](#type-catalogobject)s at the requested [Location](#type-location)s.  Results are paginated and sorted in descending order according to their `calculated_at` timestamp (newest first).  When `updated_at` is specified, only counts that have changed since that time (based on the server timestamp for the most recent change) are returned. This allows clients to perform a \"sync\" operation, for example in response to receiving a Webhook notification.
+Returns current counts for the provided [CatalogObject](#type-catalogobject)s at the requested [Location](#type-location)s.  Results are paginated and sorted in descending order according to their `calculated_at` timestamp (newest first).  When `updated_after` is specified, only counts that have changed since that time (based on the server timestamp for the most recent change) are returned. This allows clients to perform a \"sync\" operation, for example in response to receiving a Webhook notification.
 
 ### Parameters
 

docs/Product.md

@@ -15,6 +15,8 @@ Name | Type
 **INVOICES** | string
 **ONLINE_STORE** | string
 **PAYROLL** | string
+**DASHBOARD** | string
+**ITEM_LIBRARY_IMPORT** | string
 **OTHER** | string
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

docs/V1Payment.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **id** | **str** | The payment's unique identifier. | [optional] 
 **merchant_id** | **str** | The unique identifier of the merchant that took the payment. | [optional] 
-**created_at** | **str** | The time when the payment was created, in ISO 8601 format. | [optional] 
+**created_at** | **str** | The time when the payment was created, in ISO 8601 format. Reflects the time of the first payment if the object represents an incomplete partial payment, and the time of the last or complete payment otherwise. | [optional] 
 **creator_id** | **str** | The unique identifier of the Square account that took the payment. | [optional] 
 **device** | [**Device**](Device.md) | The device that took the payment. | [optional] 
 **payment_url** | **str** | The URL of the payment's detail page in the merchant dashboard. The merchant must be signed in to the merchant dashboard to view this page. | [optional]