Release/2.7.0 (#60)

* Release 2.7.0

.travis.yml

@@ -12,7 +12,7 @@ install:
 
 script:
   - export frameworkVersion=net45
-  - export releaseVersion="2.6.1"
+  - export releaseVersion="2.7.0"
   - /bin/sh ./mono_nunit_test.sh
 
 after_success:

CHANGES.md

@@ -1,5 +1,27 @@
 # Change Log
 
+## Version 2.7.0 (2018-04-26)
+
+### New features: Transactions API and Payments API
+
+The Transactions API in Connect v2 now includes payment and refund information from exchanges.
+
+* `ListTransactions` now includes payment information from sales and exchanges and refund
+information from returns and exchanges.
+* `ListRefunds` now includes refunds that result from exchanges in addition to partial refunds and
+itemized returns through Square's Point of Sale applications.
+
+The Payments API in Connect v1 now includes payment and refund information from exchanges.
+
+* `ListPayments` now includes refunds that are generated from exchanges to account for the
+value of returned goods.
+* `ListRefunds` now returns an approximate number of refunds (default: 100, max: 200).
+The response may contain more results than the prescribed limit when refunds are made
+simultaneously to multiple tenders in a payment or when refunds are generated from exchanges
+to account for the value of returned goods.
+* `is_exchange` is added to `V1Refund` and `V1Tender`. Refunds and tenders marked in this way
+represent the value of returned goods in an exchange, rather than actual money movement.
+
 ## Version 2.6.0 (2018-03-27)
 
 ### Improvements: Orders API

README.md

@@ -1,7 +1,7 @@
 Square Connect C# SDK [![Build Status](https://travis-ci.org/square/connect-csharp-sdk.svg?branch=master)](https://travis-ci.org/square/connect-csharp-sdk)[![NuGet version](https://badge.fury.io/nu/Square.Connect.svg)](https://badge.fury.io/nu/Square.Connect)
 ==================
 
-**If you have feedback about the new SDKs, or just want to talk to other Square Developers, request an invite to the new [slack community for Square Developers](https://docs.google.com/forms/d/e/1FAIpQLSfAZGIEZoNs-XryKqUoW3atFQHdQw5UqXLMOVPq3V4DEq-AJw/viewform?usp=sf_link#response=ACYDBNj5LFgPy8Tcac2gSgv_IjXvgWsPy2CO2xTXwnc0OSSxCvWFgc7SCDHvVQ)**
+**If you have feedback about the new SDKs, or just want to talk to other Square Developers, request an invite to the new [slack community for Square Developers](https://squ.re/2GUW1SQ)**
 
 This repository contains the released C# client SDK. Check out our [API
 specification repository](https://github.com/square/connect-api-specification)

docs/TransactionsApi.md

@@ -222,7 +222,7 @@ Name | Type | Description  | Notes
 
 ListRefunds
 
-Lists refunds for one of a business's locations.  Refunds with a `status` of `PENDING` are not currently included in this endpoint's response.  Max results per [page](#paginatingresults): 50
+Lists refunds for one of a business's locations.  In addition to full or partial tender refunds processed through Square APIs, refunds may result from itemized returns or exchanges through Square's Point of Sale applications.  Refunds with a `status` of `PENDING` are not currently included in this endpoint's response.  Max results per [page](#paginatingresults): 50
 
 ### Example
 ```csharp
@@ -295,7 +295,7 @@ Name | Type | Description  | Notes
 
 ListTransactions
 
-Lists transactions for a particular location.  Max results per [page](#paginatingresults): 50
+Lists transactions for a particular location.  Transactions include payment information from sales and exchanges and refund information from returns and exchanges.  Max results per [page](#paginatingresults): 50
 
 ### Example
 ```csharp

docs/V1Payment.md

@@ -25,7 +25,7 @@ Name | Type | Description | Notes
 **InclusiveTax** | [**List<V1PaymentTax>**](V1PaymentTax.md) | All of the inclusive taxes associated with the payment. | [optional] 
 **AdditiveTax** | [**List<V1PaymentTax>**](V1PaymentTax.md) | All of the additive taxes associated with the payment. | [optional] 
 **Tender** | [**List<V1Tender>**](V1Tender.md) | All of the additive taxes associated with the payment. | [optional] 
-**Refunds** | [**List<V1Refund>**](V1Refund.md) | All of the refunds applied to the payment. | [optional] 
+**Refunds** | [**List<V1Refund>**](V1Refund.md) | All of the refunds applied to the payment. Note that the value of all refunds on a payment can exceed the value of all tenders if a merchant chooses to refund money to a tender after previously accepting returned goods as part of an exchange. | [optional] 
 **Itemizations** | [**List<V1PaymentItemization>**](V1PaymentItemization.md) | The items purchased in the payment. | [optional] 
 
 

docs/V1Refund.md

@@ -6,10 +6,11 @@ Name | Type | Description | Notes
 **Type** | **TypeEnum** | The type of refund  | [optional] 
 **Reason** | **string** | The merchant-specified reason for the refund. | [optional] 
 **RefundedMoney** | [**V1Money**](V1Money.md) | The amount of money refunded. This amount is always negative. | [optional] 
-**CreatedAt** | **string** | The time when the merchant initiated the refund for Square to process, in ISO 8601 format.. | [optional] 
+**CreatedAt** | **string** | The time when the merchant initiated the refund for Square to process, in ISO 8601 format. | [optional] 
 **ProcessedAt** | **string** | The time when Square processed the refund on behalf of the merchant, in ISO 8601 format. | [optional] 
-**PaymentId** | **string** | The Square-issued ID of the payment the refund is applied to. | [optional] 
+**PaymentId** | **string** | A Square-issued ID associated with the refund. For single-tender refunds, payment_id is the ID of the original payment ID. For split-tender refunds, payment_id is the ID of the original tender. For exchange-based refunds (is_exchange == true), payment_id is the ID of the original payment ID even if the payment includes other tenders. | [optional] 
 **MerchantId** | **string** |  | [optional] 
+**IsExchange** | **bool?** | Indicates whether or not the refund is associated with an exchange. If is_exchange is true, the refund reflects the value of goods returned in the exchange not the total money refunded. | [optional] 
 
 
 ## TypeEnum

docs/V1Tender.md

@@ -16,6 +16,7 @@ Name | Type | Description | Notes
 **TenderedMoney** | [**V1Money**](V1Money.md) | The amount of total_money applied to the payment. | [optional] 
 **ChangeBackMoney** | [**V1Money**](V1Money.md) | The amount of total_money returned to the buyer as change. | [optional] 
 **RefundedMoney** | [**V1Money**](V1Money.md) | The total of all refunds applied to this tender. This amount is always negative or zero. | [optional] 
+**IsExchange** | **bool?** | Indicates whether or not the tender is associated with an exchange. If is_exchange is true, the tender represents the value of goods returned in an exchange not the actual money paid. The exchange value reduces the tender amounts needed to pay for items purchased in the exchange. | [optional] 
 
 
 ## TypeEnum

docs/V1TransactionsApi.md

@@ -326,7 +326,7 @@ namespace Example
             var order = order_example;  // string | TThe order in which payments are listed in the response. (optional) 
             var beginTime = beginTime_example;  // string | The beginning of the requested reporting period, in ISO 8601 format. If this value is before January 1, 2013 (2013-01-01T00:00:00Z), this endpoint returns an error. Default value: The current time minus one year. (optional) 
             var endTime = endTime_example;  // string | The end of the requested reporting period, in ISO 8601 format. If this value is more than one year greater than begin_time, this endpoint returns an error. Default value: The current time. (optional) 
-            var limit = 56;  // int? | The maximum number of payments to return in a single response. This value cannot exceed 200. (optional) 
+            var limit = 56;  // int? | The approximate number of refunds to return in a single response. Default: 100. Max: 200. Response may contain more results than the prescribed limit when refunds are made simultaneously to multiple tenders in a payment or when refunds are generated in an exchange to account for the value of returned goods. (optional) 
             var batchToken = batchToken_example;  // string | A pagination cursor to retrieve the next set of results for your original query to the endpoint. (optional) 
 
             try
@@ -352,7 +352,7 @@ Name | Type | Description  | Notes
  **order** | **string**| TThe order in which payments are listed in the response. | [optional] 
  **beginTime** | **string**| The beginning of the requested reporting period, in ISO 8601 format. If this value is before January 1, 2013 (2013-01-01T00:00:00Z), this endpoint returns an error. Default value: The current time minus one year. | [optional] 
  **endTime** | **string**| The end of the requested reporting period, in ISO 8601 format. If this value is more than one year greater than begin_time, this endpoint returns an error. Default value: The current time. | [optional] 
- **limit** | **int?**| The maximum number of payments to return in a single response. This value cannot exceed 200. | [optional] 
+ **limit** | **int?**| The approximate number of refunds to return in a single response. Default: 100. Max: 200. Response may contain more results than the prescribed limit when refunds are made simultaneously to multiple tenders in a payment or when refunds are generated in an exchange to account for the value of returned goods. | [optional] 
  **batchToken** | **string**| A pagination cursor to retrieve the next set of results for your original query to the endpoint. | [optional] 
 
 ### Return type
@@ -609,7 +609,7 @@ namespace Example
 
             var apiInstance = new V1TransactionsApi();
             var locationId = locationId_example;  // string | The ID of the payment's associated location.
-            var paymentId = paymentId_example;  // string | The payment's Square-issued ID. You obtain this value from Payment objects returned by the List Payments endpoint, or Settlement objects returned by the List Settlements endpoint.
+            var paymentId = paymentId_example;  // string | The Square-issued payment ID. payment_id comes from Payment objects returned by the List Payments endpoint, Settlement objects returned by the List Settlements endpoint, or Refund objects returned by the List Refunds endpoint.
 
             try
             {
@@ -631,7 +631,7 @@ namespace Example
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **locationId** | **string**| The ID of the payment's associated location. | 
- **paymentId** | **string**| The payment's Square-issued ID. You obtain this value from Payment objects returned by the List Payments endpoint, or Settlement objects returned by the List Settlements endpoint. | 
+ **paymentId** | **string**| The Square-issued payment ID. payment_id comes from Payment objects returned by the List Payments endpoint, Settlement objects returned by the List Settlements endpoint, or Refund objects returned by the List Refunds endpoint. | 
 
 ### Return type