Merge pull request #70 from square/release/2.20191023.0

Release/2.20191023.0 CreateCheckout api test failed due to service issue.
square · Oct 23, 2019 · c636129 · c636129
2 parents 08cd704 + f5d2350
commit c636129
Show file tree

Hide file tree

Showing 181 changed files with 913 additions and 242 deletions.
diff --git a/CHANGES.md b/CHANGES.md
@@ -1,5 +1,11 @@
 # Change Log
 
+## Version 2.20191023.0 (2019-10-23)
+* **GA release**: Merchants.ListMerchant is GA for all SDKs.
+* **Beta release**: All SDKs support new Locations API endpoint, CreateLocation.
+* **Beta release**: All SDKs support exclusion strategies for pricing rules.
+
+
 ## Version 2.20190925.0 (2019-09-25)
 
 * **GA release**: All SDKs have been updated to support the new Merchants API.
@@ -21,7 +27,7 @@
 
 ## Version 2.20190814.1 (2018-08-16)
 
-* **Bug fix**: Removed a currently unsupported API object type
+* **Bug fix**: Removed a currentlyunsupported API object type
 ## Version 2.20190814.0 (2019-08-15)
 
 * **New functionality**: All SDKs have been updated to support the Sandbox v2 BETA release

diff --git a/README.md b/README.md
@@ -114,6 +114,7 @@ Class | Method | HTTP request | Description
 *SquareConnect.LocationsApi* | [**listLocations**](docs/LocationsApi.md#listLocations) | **GET** /v2/locations | ListLocations
 *SquareConnect.LocationsApi* | [**retrieveLocation**](docs/LocationsApi.md#retrieveLocation) | **GET** /v2/locations/{location_id} | RetrieveLocation
 *SquareConnect.LocationsApi* | [**updateLocation**](docs/LocationsApi.md#updateLocation) | **PUT** /v2/locations/{location_id} | UpdateLocation
+*SquareConnect.MerchantsApi* | [**listMerchants**](docs/MerchantsApi.md#listMerchants) | **GET** /v2/merchants | ListMerchants
 *SquareConnect.MerchantsApi* | [**retrieveMerchant**](docs/MerchantsApi.md#retrieveMerchant) | **GET** /v2/merchants/{merchant_id} | RetrieveMerchant
 *SquareConnect.MobileAuthorizationApi* | [**createMobileAuthorizationCode**](docs/MobileAuthorizationApi.md#createMobileAuthorizationCode) | **POST** /mobile/authorization-code | CreateMobileAuthorizationCode
 *SquareConnect.OAuthApi* | [**obtainToken**](docs/OAuthApi.md#obtainToken) | **POST** /oauth2/token | ObtainToken
@@ -346,6 +347,7 @@ Class | Method | HTTP request | Description
  - [SquareConnect.Error](docs/Error.md)
  - [SquareConnect.ErrorCategory](docs/ErrorCategory.md)
  - [SquareConnect.ErrorCode](docs/ErrorCode.md)
+ - [SquareConnect.ExcludeStrategy](docs/ExcludeStrategy.md)
  - [SquareConnect.GetBreakTypeRequest](docs/GetBreakTypeRequest.md)
  - [SquareConnect.GetBreakTypeResponse](docs/GetBreakTypeResponse.md)
  - [SquareConnect.GetEmployeeWageRequest](docs/GetEmployeeWageRequest.md)
@@ -381,6 +383,8 @@ Class | Method | HTTP request | Description
  - [SquareConnect.ListEmployeesResponse](docs/ListEmployeesResponse.md)
  - [SquareConnect.ListLocationsRequest](docs/ListLocationsRequest.md)
  - [SquareConnect.ListLocationsResponse](docs/ListLocationsResponse.md)
+ - [SquareConnect.ListMerchantsRequest](docs/ListMerchantsRequest.md)
+ - [SquareConnect.ListMerchantsResponse](docs/ListMerchantsResponse.md)
  - [SquareConnect.ListPaymentRefundsRequest](docs/ListPaymentRefundsRequest.md)
  - [SquareConnect.ListPaymentRefundsResponse](docs/ListPaymentRefundsResponse.md)
  - [SquareConnect.ListPaymentsRequest](docs/ListPaymentsRequest.md)

diff --git a/docs/AdditionalRecipientReceivable.md b/docs/AdditionalRecipientReceivable.md
@@ -1,6 +1,7 @@
 # SquareConnect.AdditionalRecipientReceivable
 
 ### Description
+**Note: This model is deprecated.**
 
 Represents a monetary distribution of part of a [Transaction](#type-transaction)'s amount for Transactions which included additional recipients. The location of this receivable is that same as the one specified in the [AdditionalRecipient](#type-additionalrecipient).
 

diff --git a/docs/AdditionalRecipientReceivableRefund.md b/docs/AdditionalRecipientReceivableRefund.md
@@ -1,6 +1,7 @@
 # SquareConnect.AdditionalRecipientReceivableRefund
 
 ### Description
+**Note: This model is deprecated.**
 
 A refund of an [AdditionalRecipientReceivable](#type-additionalrecipientreceivable). This includes the ID of the additional recipient receivable associated to this object, as well as a reference to the [Refund](#type-refund) that created this receivable refund.
 

diff --git a/docs/CaptureTransactionRequest.md b/docs/CaptureTransactionRequest.md
@@ -1,6 +1,7 @@
 # SquareConnect.CaptureTransactionRequest
 
 ### Description
+**Note: This model is deprecated.**
 
 Defines the query parameters for calls to the CaptureTransaction endpoint.
 

diff --git a/docs/CaptureTransactionResponse.md b/docs/CaptureTransactionResponse.md
@@ -1,6 +1,7 @@
 # SquareConnect.CaptureTransactionResponse
 
 ### Description
+**Note: This model is deprecated.**
 
 Defines the fields that are included in the response body of a request to the [CaptureTransaction](#endpoint-capturetransaction) endpoint.
 

diff --git a/docs/CatalogApi.md b/docs/CatalogApi.md
@@ -257,7 +257,7 @@ Name | Type | Description  | Notes
 
 ListCatalog
 
-Returns a list of [CatalogObject](#type-catalogobject)s that includes all objects of a set of desired types (for example, all [CatalogItem](#type-catalogitem) and [CatalogTax](#type-catalogtax) objects) in the catalog. The &#x60;types&#x60; parameter is specified as a comma-separated list of valid [CatalogObject](#type-catalogobject) types: &#x60;ITEM&#x60;, &#x60;ITEM_VARIATION&#x60;, &#x60;MODIFIER&#x60;, &#x60;MODIFIER_LIST&#x60;, &#x60;CATEGORY&#x60;, &#x60;DISCOUNT&#x60;, &#x60;TAX&#x60;.  __Important:__ ListCatalog does not return deleted catalog items. To retrieve deleted catalog items, use SearchCatalogObjects and set &#x60;include_deleted_objects&#x60; to &#x60;true&#x60;.
+Returns a list of [CatalogObject](#type-catalogobject)s that includes all objects of a set of desired types (for example, all [CatalogItem](#type-catalogitem) and [CatalogTax](#type-catalogtax) objects) in the catalog. The &#x60;types&#x60; parameter is specified as a comma-separated list of valid [CatalogObject](#type-catalogobject) types: &#x60;ITEM&#x60;, &#x60;ITEM_VARIATION&#x60;, &#x60;MODIFIER&#x60;, &#x60;MODIFIER_LIST&#x60;, &#x60;CATEGORY&#x60;, &#x60;DISCOUNT&#x60;, &#x60;TAX&#x60;, &#x60;IMAGE&#x60;.  __Important:__ ListCatalog does not return deleted catalog items. To retrieve deleted catalog items, use SearchCatalogObjects and set &#x60;include_deleted_objects&#x60; to &#x60;true&#x60;.
 
 ### Example
 ```javascript

diff --git a/docs/CatalogItem.md b/docs/CatalogItem.md
@@ -20,6 +20,6 @@ Name | Type | Description | Notes
 **variations** | [**[CatalogObject]**](CatalogObject.md) | A list of &#x60;CatalogObject&#x60;s containing the &#x60;CatalogItemVariation&#x60;s for this item.  Maximum: 250 item variations | [optional] 
 **product_type** | **String** | The product type of the item. May not be changed once an item has been created.  Only items of product type &#x60;REGULAR&#x60; or &#x60;APPOINTMENTS_SERVICE&#x60; may be created by this API; items with other product types are read-only. See [CatalogItemProductType](#type-catalogitemproducttype) for possible values | [optional] 
 **skip_modifier_screen** | **Boolean** | If &#x60;false&#x60;, the Square Point of Sale app will present the &#x60;CatalogItem&#x60;&#39;s details screen immediately, allowing the merchant to choose &#x60;CatalogModifier&#x60;s before adding the item to the cart.  This is the default behavior.  If &#x60;true&#x60;, the Square Point of Sale app will immediately add the item to the cart with the pre-selected modifiers, and merchants can edit modifiers by drilling down onto the item&#39;s details.  Third-party clients are encouraged to implement similar behaviors. | [optional] 
-**item_options** | [**[CatalogItemOptionForItem]**](CatalogItemOptionForItem.md) | List of item options IDs for this item. Used to manage and group item variations in a specified order.  Maximum: 6 item options. | [optional] 
+**item_options** | [**[CatalogItemOptionForItem]**](CatalogItemOptionForItem.md) | List of item options IDs for this item. Used to manage and group item variations in a specified order.  Maximum: 6 item options. | [optional] [beta]
 
 
diff --git a/docs/CatalogItemOption.md b/docs/CatalogItemOption.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogItemOption
 
 ### Description
+**Note: This model is in beta.**
 
 A group of variations for a [CatalogItem](#type-catalogitem)'s.
 

diff --git a/docs/CatalogItemOptionForItem.md b/docs/CatalogItemOptionForItem.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogItemOptionForItem
 
 ### Description
+**Note: This model is in beta.**
 
  A list of item option values that can be assigned to item variations. For example, a t-shirt item may offer a color option or a size option.
 

diff --git a/docs/CatalogItemOptionValue.md b/docs/CatalogItemOptionValue.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogItemOptionValue
 
 ### Description
+**Note: This model is in beta.**
 
 An enumerated value that can link a [CatalogItemVariation(#type-catalogitemvariation) to an item option as one of its item option values.
 
@@ -10,7 +11,7 @@ Name | Type | Description | Notes
 **item_option_id** | **String** | Unique ID of the associated item option. | [optional] 
 **name** | **String** | Name of this item option value. Searchable. | [optional] 
 **description** | **String** | The option value&#39;s human-readable description. | [optional] 
-**color** | **String** | The HTML color for this value in the format #FFRRGGBB or #RRGGBB (e.g., \&quot;#ff8d4e85\&quot;). Only displayed if parent Item Option&#39;s &#x60;show_colors&#x60; flag is enabled. value. | [optional] 
+**color** | **String** | The HTML-supported hex color for the item option (e.g., \&quot;#ff8d4e85\&quot;). Only displayed if &#x60;show_colors&#x60; is enabled on the parent &#x60;ItemOption&#x60;. When left unset, &#x60;color&#x60; defaults to white (\&quot;#ffffff\&quot;) when &#x60;show_colors&#x60; is enabled on the parent &#x60;ItemOption&#x60;. | [optional] 
 **ordinal** | **Number** | Determines where this option value appears in a list of option values. | [optional] 
 **item_variation_count** | **Number** | The number of [CatalogItemVariation(#type-catalogitemvariation)s that currently make use of this Item Option value. Present only if &#x60;retrieve_counts&#x60; was specified on the request used to retrieve the parent Item Option of this value.  Maximum: 100 counts. | [optional] 
 

diff --git a/docs/CatalogItemOptionValueForItemVariation.md b/docs/CatalogItemOptionValueForItemVariation.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogItemOptionValueForItemVariation
 
 ### Description
+**Note: This model is in beta.**
 
 A [CatalogItemOptionValue](#type-catalogitemoptionvalue) links an item variation to an item option as an item option value. For example, a t-shirt item may offer a color option and a size option. An item option value would represent each variation of t-shirt: For example, “Color:Red, Size:Small” or “Color:Blue, Size:Medium”.
 

diff --git a/docs/CatalogItemVariation.md b/docs/CatalogItemVariation.md
@@ -20,7 +20,7 @@ Name | Type | Description | Notes
 **inventory_alert_threshold** | **Number** | If the inventory quantity for the variation is less than or equal to this value and &#x60;inventory_alert_type&#x60; is &#x60;LOW_QUANTITY&#x60;, the variation displays an alert in the merchant dashboard.  This value is always an integer. | [optional] 
 **user_data** | **String** | Arbitrary user metadata to associate with the item variation. Cannot exceed 255 characters. Searchable. | [optional] 
 **service_duration** | **Number** | If the &#x60;CatalogItem&#x60; that owns this item variation is of type &#x60;APPOINTMENTS_SERVICE&#x60;, then this is the duration of the service in milliseconds. For example, a 30 minute appointment would have the value &#x60;1800000&#x60;, which is equal to 30 (minutes) * 60 (seconds per minute) * 1000 (milliseconds per second). | [optional] 
-**item_option_values** | [**[CatalogItemOptionValueForItemVariation]**](CatalogItemOptionValueForItemVariation.md) | List of item option values associated with this item variation. Listed in the same order as the item options of the parent item. | [optional] 
-**measurement_unit_id** | **String** | ID of the ‘CatalogMeasurementUnit’ that is used to measure the quantity sold of this item variation. If left unset, the item will be sold in whole quantities. | [optional] 
+**item_option_values** | [**[CatalogItemOptionValueForItemVariation]**](CatalogItemOptionValueForItemVariation.md) | List of item option values associated with this item variation. Listed in the same order as the item options of the parent item. | [optional] [beta]
+**measurement_unit_id** | **String** | ID of the ‘CatalogMeasurementUnit’ that is used to measure the quantity sold of this item variation. If left unset, the item will be sold in whole quantities. | [optional] [beta]
 
 
diff --git a/docs/CatalogMeasurementUnit.md b/docs/CatalogMeasurementUnit.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogMeasurementUnit
 
 ### Description
+**Note: This model is in beta.**
 
 Represents the unit used to measure a [CatalogItemVariation](#type-catalogitemvariation) and specifies the precision for decimal quantities.
 

diff --git a/docs/CatalogPricingRule.md b/docs/CatalogPricingRule.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogPricingRule
 
 ### Description
+**Note: This model is in beta.**
 
 Defines how prices are modified or set for items that match the pricing rule during the active time period.
 
@@ -11,11 +12,12 @@ Name | Type | Description | Notes
 **time_period_ids** | **[String]** | Unique ID for the &#x60;CatalogTimePeriod&#x60;s when this pricing rule is in effect. If left unset, the pricing rule is always in effect. | [optional] 
 **discount_id** | **String** | Unique ID for the &#x60;CatalogDiscount&#x60; to take off the price of all matched items. | [optional] 
 **match_products_id** | **String** | Unique ID for the &#x60;CatalogProductSet&#x60; that will be matched by this rule. A match rule matches within the entire cart. | [optional] 
-**apply_products_id** | **String** | The &#x60;CatalogProductSet&#x60; to apply the pricing rule to within the set of matched products specified by &#x60;match_products_id&#x60;. An apply rule can only match once within the set of matched products. If left unset, the pricing rule will be applied to all products within the set of matched products. | [optional] 
+**apply_products_id** | **String** | &#x60;CatalogProductSet&#x60; to apply the pricing to. An apply rule matches within the subset of the cart that fits the match rules (the match set). An apply rule can only match once in the match set. If not supplied, the pricing will be applied to all products in the match set. Other products retain their base price, or a price generated by other rules. This field has been deprecated: new pricing rules should prefer the exclude_products_id field. Exclude sets allow better control over quantity ranges and offer more flexibility for which matched items receive a discount. | [optional] [deprecated]
 **exclude_products_id** | **String** | Identifies the &#x60;CatalogProductSet&#x60; to exclude from this pricing rule. An exclude rule matches within the subset of the cart that fits the match rules (the match set). An exclude rule can only match once in the match set. If not supplied, the pricing will be applied to all products in the match set. Other products retain their base price, or a price generated by other rules. | [optional] 
 **valid_from_date** | **String** | Represents the date the Pricing Rule is valid from. Represented in RFC3339 full-date format (YYYY-MM-DD). | [optional] 
 **valid_from_local_time** | **String** | Represents the local time the pricing rule should be valid from. Time zone is determined by the device running the Point of Sale app.  Represented in RFC3339 partial-time format (HH:MM:SS). Partial seconds will be truncated. | [optional] 
 **valid_until_date** | **String** | Represents the date the pricing rule will become inactive.  Represented in RFC3339 full-date format (YYYY-MM-DD). | [optional] 
 **valid_until_local_time** | **String** | Represents the local time at which the pricing rule will become inactive. Time zone is determined by the device running the Point of Sale app.  Represented in RFC3339 partial-time format (HH:MM:SS). Partial seconds will be truncated. | [optional] 
+**exclude_strategy** | **String** | If an &#x60;exclude_products_id&#x60; was given, controls which subset of matched products is excluded from any discounts. See &#x60;ExcludeStrategy&#x60; for all possible values.  Default value: &#x60;LEAST_EXPENSIVE&#x60; See [ExcludeStrategy](#type-excludestrategy) for possible values | [optional] 
 
 
diff --git a/docs/CatalogProductSet.md b/docs/CatalogProductSet.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogProductSet
 
 ### Description
+**Note: This model is in beta.**
 
 Represents a collection of catalog objects for the purpose of applying a [PricingRule](#type-pricingrule). Including a catalog object will include all of its subtypes. For example, including a category in a product set will include all of its items and associated item variations in the product set. Including an item in a product set will also include its item variations.
 

diff --git a/docs/CatalogQueryItemVariationsForItemOptionValues.md b/docs/CatalogQueryItemVariationsForItemOptionValues.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogQueryItemVariationsForItemOptionValues
 
 ### Description
+**Note: This model is in beta.**
 
 
 

diff --git a/docs/CatalogQueryItemsForItemOptions.md b/docs/CatalogQueryItemsForItemOptions.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogQueryItemsForItemOptions
 
 ### Description
+**Note: This model is in beta.**
 
 
 

diff --git a/docs/CatalogTimePeriod.md b/docs/CatalogTimePeriod.md
@@ -1,6 +1,7 @@
 # SquareConnect.CatalogTimePeriod
 
 ### Description
+**Note: This model is in beta.**
 
 Represents a time period - either a single period or a repeating period.
 

diff --git a/docs/ChargeRequest.md b/docs/ChargeRequest.md
@@ -1,14 +1,15 @@
 # SquareConnect.ChargeRequest
 
 ### Description
+**Note: This model is deprecated.**
 
 Defines the parameters that can be included in the body of a request to the [Charge](#endpoint-charge) endpoint.  Deprecated - recommend using [CreatePayment](#endpoint-payments-createpayment)
 
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **idempotency_key** | **String** | A value you specify that uniquely identifies this transaction among transactions you&#39;ve created.  If you&#39;re unsure whether a particular transaction succeeded, you can reattempt it with the same idempotency key without worrying about double-charging the buyer.  See [Idempotency](https://developer.squareup.com/docs/basics/api101/idempotency) for more information. | 
-**amount_money** | [**Money**](Money.md) | The amount of money to charge.  Note that you specify the amount in the __smallest denomination of the applicable currency__. For example, US dollar amounts are specified in cents. See [Working with monetary amounts](#workingwithmonetaryamounts) for details.  The value of &#x60;currency&#x60; must match the currency associated with the business that is charging the card. | 
+**amount_money** | [**Money**](Money.md) | The amount of money to charge.  Note that you specify the amount in the __smallest denomination of the applicable currency__. For example, US dollar amounts are specified in cents. See [Working with monetary amounts](https://developer.squareup.com/docs/build-basics/working-with-monetary-amounts) for details.  The value of &#x60;currency&#x60; must match the currency associated with the business that is charging the card. | 
 **card_nonce** | **String** | A nonce generated from the &#x60;SqPaymentForm&#x60; that represents the card to charge.  The application that provides a nonce to this endpoint must be the _same application_ that generated the nonce with the &#x60;SqPaymentForm&#x60;. Otherwise, the nonce is invalid.  Do not provide a value for this field if you provide a value for &#x60;customer_card_id&#x60;. | [optional] 
 **customer_card_id** | **String** | The ID of the customer card on file to charge. Do not provide a value for this field if you provide a value for &#x60;card_nonce&#x60;.  If you provide this value, you _must_ also provide a value for &#x60;customer_id&#x60;. | [optional] 
 **delay_capture** | **Boolean** | If &#x60;true&#x60;, the request will only perform an Auth on the provided card. You can then later perform either a Capture (with the &#x60;CaptureTransaction&#x60; or a Void (with the &#x60;VoidTransaction&#x60;.  Default value: &#x60;false&#x60; | [optional] 

diff --git a/docs/ChargeRequestAdditionalRecipient.md b/docs/ChargeRequestAdditionalRecipient.md
@@ -1,6 +1,7 @@
 # SquareConnect.ChargeRequestAdditionalRecipient
 
 ### Description
+**Note: This model is deprecated.**
 
 Represents an additional recipient (other than the merchant) entitled to a portion of the tender. Support is currently limited to USD, CAD and GBP currencies
 

diff --git a/docs/ChargeResponse.md b/docs/ChargeResponse.md
@@ -1,6 +1,7 @@
 # SquareConnect.ChargeResponse
 
 ### Description
+**Note: This model is deprecated.**
 
 Defines the fields that are included in the response body of a request to the [Charge](#endpoint-charge) endpoint.  One of `errors` or `transaction` is present in a given response (never both).