Changes from gocardless/gocardless-dotnet-template

.gitignore

@@ -75,6 +75,7 @@ artifacts/
 *.pidb
 *.svclog
 *.scc
+*.DS_Store
 
 # Chutzpah Test files
 _Chutzpah*

GoCardless/GoCardless.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <PackageId>GoCardless</PackageId>
-    <PackageVersion>5.21.1</PackageVersion>
+    <PackageVersion>5.21.2</PackageVersion>
     <Authors>GoCardless Ltd</Authors>
     <Description>Client for the GoCardless API - a powerful, simple solution for the collection of recurring bank-to-bank payments</Description>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
@@ -11,7 +11,7 @@
     <Copyright>GoCardless Ltd</Copyright>
     <PackageTags>gocardless payments rest api direct debit</PackageTags>
     <PackageLicenseUrl>https://github.com/gocardless/gocardless-dotnet/blob/master/LICENSE.txt</PackageLicenseUrl>
-    <PackageReleaseNotes>https://github.com/gocardless/gocardless-dotnet/releases/tag/v5.21.1</PackageReleaseNotes>
+    <PackageReleaseNotes>https://github.com/gocardless/gocardless-dotnet/releases/tag/v5.21.2</PackageReleaseNotes>
     <TargetFrameworks>netstandard1.6;netstandard2.0;net46</TargetFrameworks>
     <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>

GoCardless/GoCardlessClient.cs

@@ -277,11 +277,11 @@ private HttpRequestMessage BuildHttpRequestMessage<T>(string method, string path
             runtimeFrameworkInformation = System.Runtime.InteropServices.RuntimeEnvironment.GetSystemVersion();
 #endif
 
-            var userAgentInformation = $" gocardless-dotnet/5.21.1 {runtimeFrameworkInformation} {Helpers.CleanupOSDescriptionString(OSRunningOn)}";
+            var userAgentInformation = $" gocardless-dotnet/5.21.2 {runtimeFrameworkInformation} {Helpers.CleanupOSDescriptionString(OSRunningOn)}";
 
             requestMessage.Headers.Add("User-Agent", userAgentInformation);
             requestMessage.Headers.Add("GoCardless-Version", "2015-07-06");
-            requestMessage.Headers.Add("GoCardless-Client-Version", "5.21.1");
+            requestMessage.Headers.Add("GoCardless-Client-Version", "5.21.2");
             requestMessage.Headers.Add("GoCardless-Client-Library", "gocardless-dotnet");
             requestMessage.Headers.Authorization =
                 new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", _accessToken);

GoCardless/Resources/BillingRequest.cs

@@ -844,6 +844,20 @@ public class BillingRequestPaymentRequest
         [JsonProperty("description")]
         public string Description { get; set; }
 
+        /// <summary>
+        /// This field will decide how GoCardless handles settlement of funds
+        /// from the customer.
+        /// 
+        /// - `managed` will be moved through GoCardless' account, batched, and
+        /// payed out.
+        /// - `direct` will be a direct transfer from the payer's account to the
+        /// merchant where
+        ///   invoicing will be handled separately.
+        /// 
+        /// </summary>
+        [JsonProperty("funds_settlement")]
+        public BillingRequestPaymentRequestFundsSettlement? FundsSettlement { get; set; }
+
         /// <summary>
         /// Resources linked to this BillingRequestPaymentRequest.
         /// </summary>
@@ -870,6 +884,28 @@ public class BillingRequestPaymentRequest
         public string Scheme { get; set; }
     }
 
+    /// <summary>
+    /// This field will decide how GoCardless handles settlement of funds from the customer.
+    /// 
+    /// - `managed` will be moved through GoCardless' account, batched, and payed out.
+    /// - `direct` will be a direct transfer from the payer's account to the merchant where
+    ///   invoicing will be handled separately.
+    /// 
+    /// </summary>
+    [JsonConverter(typeof(GcStringEnumConverter), (int)Unknown)]
+    public enum BillingRequestPaymentRequestFundsSettlement {
+        /// <summary>Unknown status</summary>
+        [EnumMember(Value = "unknown")]
+        Unknown = 0,
+
+        /// <summary>`funds_settlement` with a value of "managed"</summary>
+        [EnumMember(Value = "managed")]
+        Managed,
+        /// <summary>`funds_settlement` with a value of "direct"</summary>
+        [EnumMember(Value = "direct")]
+        Direct,
+    }
+
     /// <summary>
     /// Resources linked to this BillingRequestPaymentRequest
     /// </summary>

GoCardless/Services/BankDetailsLookupService.cs

@@ -37,6 +37,12 @@ public BankDetailsLookupService(GoCardlessClient goCardlessClient)
         /// check and
         /// reachability check are performed.
         /// 
+        /// For UK-based bank accounts, where an account holder name is provided
+        /// (and an account number, a sort code or an iban
+        /// are already present), we verify that the account holder name and
+        /// bank account number match the details held by
+        /// the relevant bank.
+        /// 
         /// If your request returns an [error](#api-usage-errors) or the
         /// `available_debit_schemes`
         /// attribute is an empty array, you will not be able to collect
@@ -83,6 +89,12 @@ public Task<BankDetailsLookupResponse> CreateAsync(BankDetailsLookupCreateReques
     /// and
     /// reachability check are performed.
     /// 
+    /// For UK-based bank accounts, where an account holder name is provided
+    /// (and an account number, a sort code or an iban
+    /// are already present), we verify that the account holder name and bank
+    /// account number match the details held by
+    /// the relevant bank.
+    /// 
     /// If your request returns an [error](#api-usage-errors) or the
     /// `available_debit_schemes`
     /// attribute is an empty array, you will not be able to collect payments
@@ -111,6 +123,14 @@ public Task<BankDetailsLookupResponse> CreateAsync(BankDetailsLookupCreateReques
     public class BankDetailsLookupCreateRequest
     {
 
+        /// <summary>
+        /// The account holder name associated with the account number (if
+        /// available). If provided and the country code is GB, a payer name
+        /// verification will be performed.
+        /// </summary>
+        [JsonProperty("account_holder_name")]
+        public string AccountHolderName { get; set; }
+
         /// <summary>
         /// Bank account number - see [local
         /// details](#appendix-local-bank-details) for more information.

GoCardless/Services/BillingRequestService.cs

@@ -115,6 +115,12 @@ public Task<BillingRequestResponse> CollectCustomerDetailsAsync(string identity,
         /// customer is requested to adjust the account number/routing number
         /// and
         /// succeed in this check to continue with the flow.
+        /// 
+        /// _BACS scheme_ [Payer Name
+        /// Verification](https://hub.gocardless.com/s/article/Introduction-to-Payer-Name-Verification?language=en_GB)
+        /// is enabled by default for UK based bank accounts, meaning we verify
+        /// the account holder name and bank account
+        /// number match the details held by the relevant bank.
         /// </summary>  
         /// <param name="identity">Unique identifier, beginning with "BRQ".</param> 
         /// <param name="request">An optional `BillingRequestCollectBankAccountRequest` representing the body for this collect_bank_account request.</param>
@@ -786,6 +792,42 @@ public class BillingRequestPaymentRequest
                 [JsonProperty("description")]
                 public string Description { get; set; }
 
+                /// <summary>
+                            /// This field will decide how GoCardless handles settlement of
+            /// funds from the customer.
+            /// 
+            /// - `managed` will be moved through GoCardless' account, batched,
+            /// and payed out.
+            /// - `direct` will be a direct transfer from the payer's account to
+            /// the merchant where
+            ///   invoicing will be handled separately.
+            /// 
+                /// </summary>
+                [JsonProperty("funds_settlement")]
+                public BillingRequestFundsSettlement? FundsSettlement { get; set; }
+        /// <summary>
+        /// This field will decide how GoCardless handles settlement of funds
+        /// from the customer.
+        /// 
+        /// - `managed` will be moved through GoCardless' account, batched, and
+        /// payed out.
+        /// - `direct` will be a direct transfer from the payer's account to the
+        /// merchant where
+        ///   invoicing will be handled separately.
+        /// 
+        /// </summary>
+        [JsonConverter(typeof(StringEnumConverter))]
+        public enum BillingRequestFundsSettlement
+        {
+
+            /// <summary>`funds_settlement` with a value of "managed"</summary>
+            [EnumMember(Value = "managed")]
+            Managed,
+            /// <summary>`funds_settlement` with a value of "direct"</summary>
+            [EnumMember(Value = "direct")]
+            Direct,
+        }
+
                 /// <summary>
                             /// Key-value store of custom data. Up to 3 keys are permitted, with
             /// key names up to 50 characters and values up to 500 characters.
@@ -1070,6 +1112,12 @@ public class BillingRequestCustomerBillingDetail
     /// the
     /// customer is requested to adjust the account number/routing number and
     /// succeed in this check to continue with the flow.
+    /// 
+    /// _BACS scheme_ [Payer Name
+    /// Verification](https://hub.gocardless.com/s/article/Introduction-to-Payer-Name-Verification?language=en_GB)
+    /// is enabled by default for UK based bank accounts, meaning we verify the
+    /// account holder name and bank account
+    /// number match the details held by the relevant bank.
     /// </summary>
     public class BillingRequestCollectBankAccountRequest
     {

README.md

@@ -13,7 +13,7 @@ For full details of the GoCardless API, see the [API docs](https://developer.goc
 
 To install `GoCardless`, run the following command in the [Package Manager Console](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console)
 
-`Install-Package GoCardless -Version 5.21.1`
+`Install-Package GoCardless -Version 5.21.2`
 
 
 ## Usage