5.39.0

braintreeps · braintreeps · commit 063d82fa3305 · 2026-02-02T23:19:54.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## 5.39.0
+- Add `acceptPartialAuthorization` in `TransactionRequest` and `PartiallyAuthorized` in `Transaction`
+- Deprecate transactions for `visa_checkout_card` and maintain search functionality
+- Add `UsBankAccount` to `TransactionOptionsRequest`
+- Add field `AchType` to `TransactionOptionsUsBankAccountRequest`
+- Add response field `RequestedAchType`, `AchType` to `Transaction`
+
 ## 5.38.0
 - Add `MiddleName` to sender and receiver, and `DateOfBirth` to sender in transfer on Transaction
 
diff --git a/src/Braintree/Braintree.csproj b/src/Braintree/Braintree.csproj
@@ -4,16 +4,19 @@
   <PropertyGroup>
     <Description>Braintree Client Library</Description>
     <Copyright>Copyright © Braintree, a division of PayPal, Inc. 2021</Copyright>
-    <VersionPrefix>5.38.0</VersionPrefix>
+    <VersionPrefix>5.39.0</VersionPrefix>
     <Authors>Braintree</Authors>
     <!-- We target NET standard 2.0 so that we can support NET Core 2.1. When NET Core 2.1 reaches EOL, we can update to Net Standard 2.1 -->
     <TargetFrameworks>net452;netstandard2.0</TargetFrameworks>
     <AssemblyName>Braintree</AssemblyName>
     <PackageId>Braintree</PackageId>
     <PackageTags>braintree;paypal;venmo;intenational;payments;gateway;currencies;money;visa;mastercard;bitcoin;maestro;apple pay;android pay;amex;jcb;diners club;discover;american express</PackageTags>
     <PackageReleaseNotes>
-- Add `ProcessingMerchantCategoryCode` to `TransactionRequest`
-- Add missing `transfer` validation error codes in `Transaction`
+      -Add acceptPartialAuthorization in TransactionRequest and PartiallyAuthorized in Transaction
+      -Deprecate transactions for visa_checkout_card and maintain search functionality
+      -Add UsBankAccount to TransactionOptionsRequest
+      -Add field AchType to TransactionOptionsUsBankAccountRequest
+      -Add response field RequestedAchType, AchType to Transaction
     </PackageReleaseNotes>
     <PackageProjectUrl>https://github.com/braintree/braintree_dotnet</PackageProjectUrl>
     <GenerateAssemblyTitleAttribute>false</GenerateAssemblyTitleAttribute>
diff --git a/src/Braintree/Customer.cs b/src/Braintree/Customer.cs
@@ -39,7 +39,9 @@ public class Customer
         public virtual DateTime? UpdatedAt { get; protected set; }
         public virtual UsBankAccount[] UsBankAccounts { get; protected set; }
         public virtual VenmoAccount[] VenmoAccounts { get; protected set; }
+        #pragma warning disable 618
         public virtual VisaCheckoutCard[] VisaCheckoutCards { get; protected set; }
+        #pragma warning restore 618
         public virtual string Website { get; protected set; }
 
         public PaymentMethod DefaultPaymentMethod
@@ -122,11 +124,14 @@ protected internal Customer(NodeWrapper node, IBraintreeGateway gateway)
             }
 
             var visaCheckoutCardsXmlNodes = node.GetList("visa-checkout-cards/visa-checkout-card");
+            // VisaCheckoutCard has been deprecated for transactions
+            #pragma warning disable 618
             VisaCheckoutCards = new VisaCheckoutCard[visaCheckoutCardsXmlNodes.Count];
             for (int i = 0; i < visaCheckoutCardsXmlNodes.Count; i++)
             {
                 VisaCheckoutCards[i] = new VisaCheckoutCard(visaCheckoutCardsXmlNodes[i], gateway);
             }
+            #pragma warning restore 618
 
             var usBankAccountXmlNodes = node.GetList("us-bank-accounts/us-bank-account");
             UsBankAccounts = new UsBankAccount[usBankAccountXmlNodes.Count];
diff --git a/src/Braintree/PaymentMethodGateway.cs b/src/Braintree/PaymentMethodGateway.cs
@@ -125,7 +125,10 @@ private Result<PaymentMethod> ExtractResultFromResponse(NodeWrapper response)
             }
             else if (response.GetName() == "visa-checkout-card")
             {
+                // VisaCheckoutCard has been deprecated for transactions
+                #pragma warning disable 618
                 return new ResultImpl<VisaCheckoutCard>(response, gateway);
+                #pragma warning restore 618
             }
             else if (response.GetName() == "samsung-pay-card")
             {
diff --git a/src/Braintree/PaymentMethodParser.cs b/src/Braintree/PaymentMethodParser.cs
@@ -51,7 +51,9 @@ public static PaymentMethod ParsePaymentMethod(NodeWrapper response, IBraintreeG
             }
             else if (response.GetName() == "visa-checkout-card")
             {
+                #pragma warning disable 618
                 return new VisaCheckoutCard(response, gateway);
+                #pragma warning restore 618
             }
             else
             {
diff --git a/src/Braintree/Properties/AssemblyInfo.cs b/src/Braintree/Properties/AssemblyInfo.cs
@@ -32,5 +32,5 @@
 //      Build Number
 //      Revision
 //
-[assembly: AssemblyVersion("5.38.0.0")]
-[assembly: AssemblyFileVersion("5.38.0.0")]
+[assembly: AssemblyVersion("5.39.0.0")]
+[assembly: AssemblyFileVersion("5.39.0.0")]
diff --git a/src/Braintree/Result.cs b/src/Braintree/Result.cs
@@ -165,10 +165,13 @@ private T newInstanceFromResponse(NodeWrapper node, IBraintreeGateway gateway)
             {
                 return new UsBankAccountVerification(node) as T;
             }
+            // VisaCheckoutCard has been deprecated for transactions
+            #pragma warning disable 618
             else if (typeof(T) == typeof(VisaCheckoutCard))
             {
                 return new VisaCheckoutCard(node, gateway) as T;
             }
+            #pragma warning restore 618
             #pragma warning disable 618
             else if (typeof(T) == typeof(SamsungPayCard))
             {
diff --git a/src/Braintree/SandboxValues.cs b/src/Braintree/SandboxValues.cs
@@ -37,6 +37,7 @@ public class Dispute
         public class TransactionAmount
         {
             public const decimal AUTHORIZE = 1000;
+            public const decimal PARTIALLY_AUTHORIZED = 1004;
             public const decimal DECLINE = 2000;
             public const decimal HARD_DECLINE = 2015;
             public const decimal FAILED = 3000;
diff --git a/src/Braintree/Transaction.cs b/src/Braintree/Transaction.cs
@@ -119,6 +119,7 @@ public class Transaction
         public virtual bool? AccountFundingTransaction { get; protected set; }
         public virtual string AchRejectReason { get; protected set; }
         public virtual string AchReturnCode { get; protected set; }
+        public virtual string AchType { get; protected set; }
         public virtual string AcquirerReferenceNumber { get; protected set; }
         public virtual string AdditionalProcessorResponse { get; protected set; }
         public virtual List<AddOn> AddOns { get; protected set; }
@@ -165,6 +166,7 @@ public class Transaction
         public virtual string NetworkTransactionId { get; protected set; }
         public virtual string OrderId { get; protected set; }
         public virtual PackageDetails[] Packages { get; protected set; }
+        public virtual bool? PartiallyAuthorized { get; protected set; }
         public virtual List<string> PartialSettlementTransactionIds { get; protected set; }
         public virtual PaymentInstrumentType PaymentInstrumentType { get; protected set; }
         public virtual PayPalDetails PayPalDetails { get; protected set; }
@@ -182,6 +184,7 @@ public class Transaction
         public virtual List<Installment> RefundedInstallments { get; protected set; }
         public virtual string RefundedTransactionId { get; protected set; }
         public virtual List<string> RefundIds { get; protected set; }
+        public virtual string RequestedAchType { get; protected set; }
         public virtual bool? Retried { get; protected set; }
         public virtual string RetriedTransactionId { get; protected set; }
         public virtual string RetrievalReferenceNumber { get; protected set; }
@@ -212,7 +215,9 @@ public class Transaction
         public virtual DateTime? UpdatedAt { get; protected set; }
         public virtual UsBankAccountDetails UsBankAccountDetails { get; protected set; }
         public virtual VenmoAccountDetails VenmoAccountDetails { get; protected set; }
+        #pragma warning disable 618
         public virtual VisaCheckoutCardDetails VisaCheckoutCardDetails { get; protected set; }
+        #pragma warning restore 618
         public virtual string VoiceReferralNumber { get; protected set; }
 
         private IBraintreeGateway Gateway;
@@ -284,6 +289,10 @@ protected internal Transaction(NodeWrapper node, IBraintreeGateway gateway)
             TaxExempt = node.GetBoolean("tax-exempt");
             CustomFields = node.GetDictionary("custom-fields");
             ForeignRetailer = node.GetBoolean("foreign-retailer");
+            if (ProcessorResponseCode != null)
+            {
+                PartiallyAuthorized = ProcessorResponseCode.Equals("1004");
+            }
 
             var creditCardNode = node.GetNode("credit-card");
             if (creditCardNode != null)
@@ -371,7 +380,9 @@ protected internal Transaction(NodeWrapper node, IBraintreeGateway gateway)
             var visaCheckoutNode = node.GetNode("visa-checkout-card");
             if (visaCheckoutNode != null)
             {
+                #pragma warning disable 618
                 VisaCheckoutCardDetails = new VisaCheckoutCardDetails(visaCheckoutNode);
+                #pragma warning restore 618
             }
             // NEXT_MAJOR_VERSION SamsungPayCard has been deprecated, remove all associated references
             var samsungPayNode = node.GetNode("samsung-pay-card");
@@ -450,6 +461,8 @@ protected internal Transaction(NodeWrapper node, IBraintreeGateway gateway)
 
             AchRejectReason = node.GetString("ach-reject-reason");
             AchReturnCode = node.GetString("ach-return-code");
+            AchType = node.GetString("ach-type");
+            RequestedAchType = node.GetString("requested-ach-type");
 
             SepaDirectDebitReturnCode = node.GetString("sepa-direct-debit-return-code");
 
diff --git a/src/Braintree/TransactionOptionsRequest.cs b/src/Braintree/TransactionOptionsRequest.cs
@@ -25,6 +25,7 @@ public class TransactionOptionsRequest : Request
         public TransactionOptionsAmexRewardsRequest AmexRewards { get; set; }
         public TransactionOptionsVenmoRequest Venmo { get; set; }
         public TransactionOptionsCreditCardRequest CreditCard { get; set; }
+        public TransactionOptionsUsBankAccountRequest UsBankAccount { get; set; }
         public TransactionOptionsProcessingOverridesRequest ProcessingOverrides { get; set; }
 
         public override string ToXml(string root)
@@ -60,6 +61,7 @@ protected virtual RequestBuilder BuildRequest(string root)
                 AddElement("credit-card", CreditCard).
                 AddElement("amex-rewards", AmexRewards).
                 AddElement("venmo", Venmo).
+                AddElement("us-bank-account", UsBankAccount).
                 AddElement("processing-overrides", ProcessingOverrides);
         }
     }
diff --git a/src/Braintree/TransactionOptionsUsBankAccountRequest.cs b/src/Braintree/TransactionOptionsUsBankAccountRequest.cs
@@ -0,0 +1,24 @@
+namespace Braintree
+{
+    public class TransactionOptionsUsBankAccountRequest : Request
+    {
+        public string AchType { get; set; }
+
+        public override string ToXml(string root)
+        {
+            return BuildRequest(root).ToXml();
+        }
+
+        public override string ToQueryString(string root)
+        {
+            return BuildRequest(root).ToQueryString();
+        }
+
+        private RequestBuilder BuildRequest(string root)
+        {
+            return new RequestBuilder(root).
+                AddElement("ach-type", AchType);
+        }
+    }
+}
+
diff --git a/src/Braintree/TransactionRequest.cs b/src/Braintree/TransactionRequest.cs
@@ -41,6 +41,7 @@ protected override RequestBuilder BuildRequest(string root)
     // NEXT_MAJOR_VERSION Remove ObsoleteAttributes
     public class TransactionRequest : Request
     {
+        public bool? AcceptPartialAuthorization { get; set; }
         public decimal Amount { get; set; }
         // NEXT_MAJOR_VERSION Rename Android Pay to Google Pay
         public TransactionAndroidPayCardRequest AndroidPayCard { get; set; }
@@ -157,6 +158,7 @@ protected virtual RequestBuilder BuildRequest(string root)
         {
             var builder = new RequestBuilder(root);
 
+            builder.AddElement("accept-partial-authorization", AcceptPartialAuthorization);
             if (Amount != 0) builder.AddElement("amount", Amount);
             if (AndroidPayCard != null) builder.AddElement("android-pay-card", AndroidPayCard);
             if (ApplePayCard != null) builder.AddElement("apple-pay-card", ApplePayCard);
diff --git a/src/Braintree/VisaCheckoutCard.cs b/src/Braintree/VisaCheckoutCard.cs
@@ -5,6 +5,11 @@
 
 namespace Braintree
 {
+    /// <summary>
+    /// DEPRECATED: Visa Checkout is no longer supported for creating new transactions.
+    /// This class is retained for search functionality and historical transaction data only.
+    /// </summary>
+    [Obsolete("VisaCheckoutCard has been deprecated", false)]
     public class VisaCheckoutCard : PaymentMethod
     {
 
diff --git a/src/Braintree/VisaCheckoutCardDetails.cs b/src/Braintree/VisaCheckoutCardDetails.cs
@@ -2,6 +2,11 @@
 
 namespace Braintree
 {
+    /// <summary>
+    /// DEPRECATED: Visa Checkout is no longer supported for creating new transactions.
+    /// This class is retained for search functionality and historical transaction data only.
+    /// </summary>
+    [Obsolete("VisaCheckoutCardDetails has been deprecated", false)]
     public class VisaCheckoutCardDetails
     {
 
diff --git a/test/Braintree.Tests.Integration/CustomerIntegrationTest.cs b/test/Braintree.Tests.Integration/CustomerIntegrationTest.cs
@@ -1133,48 +1133,6 @@ public void Create_WithUsBankAccountPaymentMethodNonce()
             Assert.IsTrue(Regex.IsMatch(usBankAccount.BankName, ".*CHASE.*"));
         }
 
-        [Test]
-        public void Create_WithVisaCheckoutCardPaymentMethodNonce()
-        {
-            string nonce = Braintree.Test.Nonce.VisaCheckoutMasterCard;
-            Result<Customer> result = gateway.Customer.Create(new CustomerRequest{
-                PaymentMethodNonce = nonce
-            });
-            Assert.IsTrue(result.IsSuccess());
-            Assert.AreEqual(1, result.Target.PaymentMethods.Length);
-            Assert.AreEqual("VisaCheckoutCard", result.Target.PaymentMethods[0].GetType().Name);
-
-            VisaCheckoutCard visaCheckoutCard = result.Target.VisaCheckoutCards[0];
-            Assert.AreEqual("abc123", visaCheckoutCard.CallId);
-            Assert.IsNotNull(visaCheckoutCard.BillingAddress);
-            Assert.IsNotNull(visaCheckoutCard.Bin);
-            Assert.IsNotNull(visaCheckoutCard.CardType);
-            Assert.IsNotNull(visaCheckoutCard.CardholderName);
-            Assert.IsNotNull(visaCheckoutCard.Commercial);
-            Assert.IsNotNull(visaCheckoutCard.CountryOfIssuance);
-            Assert.IsNotNull(visaCheckoutCard.CreatedAt);
-            Assert.IsNotNull(visaCheckoutCard.CustomerId);
-            Assert.IsNotNull(visaCheckoutCard.CustomerLocation);
-            Assert.IsNotNull(visaCheckoutCard.Debit);
-            Assert.IsNotNull(visaCheckoutCard.IsDefault);
-            Assert.IsNotNull(visaCheckoutCard.DurbinRegulated);
-            Assert.IsNotNull(visaCheckoutCard.ExpirationDate);
-            Assert.IsNotNull(visaCheckoutCard.ExpirationMonth);
-            Assert.IsNotNull(visaCheckoutCard.ExpirationYear);
-            Assert.IsNotNull(visaCheckoutCard.IsExpired);
-            Assert.IsNotNull(visaCheckoutCard.Healthcare);
-            Assert.IsNotNull(visaCheckoutCard.ImageUrl);
-            Assert.IsNotNull(visaCheckoutCard.IssuingBank);
-            Assert.IsNotNull(visaCheckoutCard.LastFour);
-            Assert.IsNotNull(visaCheckoutCard.MaskedNumber);
-            Assert.IsNotNull(visaCheckoutCard.Payroll);
-            Assert.IsNotNull(visaCheckoutCard.Prepaid);
-            Assert.IsNotNull(visaCheckoutCard.ProductId);
-            Assert.IsNotNull(visaCheckoutCard.Subscriptions);
-            Assert.IsNotNull(visaCheckoutCard.Token);
-            Assert.IsNotNull(visaCheckoutCard.UniqueNumberIdentifier);
-            Assert.IsNotNull(visaCheckoutCard.UpdatedAt);
-        }
 
         [Test]
         public void Create_WithAccountTypeCredit()
diff --git a/test/Braintree.Tests.Integration/TransactionIntegrationTest.cs b/test/Braintree.Tests.Integration/TransactionIntegrationTest.cs
diff --git a/test/Braintree.Tests.Integration/UsBankAccountVerificationIntegrationTest.cs b/test/Braintree.Tests.Integration/UsBankAccountVerificationIntegrationTest.cs
diff --git a/test/Braintree.Tests.Integration/VisaCheckoutIntegrationTest.cs b/test/Braintree.Tests.Integration/VisaCheckoutIntegrationTest.cs
diff --git a/test/Braintree.Tests/TransactionOptionsUsBankAccountRequestTest.cs b/test/Braintree.Tests/TransactionOptionsUsBankAccountRequestTest.cs
diff --git a/test/Braintree.Tests/TransactionRequestTest.cs b/test/Braintree.Tests/TransactionRequestTest.cs
diff --git a/test/Braintree.Tests/TransactionTest.cs b/test/Braintree.Tests/TransactionTest.cs

Original file line number	Diff line number	Diff line change
`@@ -125,7 +125,10 @@ private Result<PaymentMethod> ExtractResultFromResponse(NodeWrapper response)`
`125`	`125`	`}`
`126`	`126`	`else if (response.GetName() == "visa-checkout-card")`
`127`	`127`	`{`
	`128`	`+ // VisaCheckoutCard has been deprecated for transactions`
	`129`	`+ #pragma warning disable 618`
`128`	`130`	`return new ResultImpl<VisaCheckoutCard>(response, gateway);`
	`131`	`+ #pragma warning restore 618`
`129`	`132`	`}`
`130`	`133`	`else if (response.GetName() == "samsung-pay-card")`
`131`	`134`	`{`
Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,9 @@ public static PaymentMethod ParsePaymentMethod(NodeWrapper response, IBraintreeG`
`51`	`51`	`}`
`52`	`52`	`else if (response.GetName() == "visa-checkout-card")`
`53`	`53`	`{`
	`54`	`+ #pragma warning disable 618`
`54`	`55`	`return new VisaCheckoutCard(response, gateway);`
	`56`	`+ #pragma warning restore 618`
`55`	`57`	`}`
`56`	`58`	`else`
`57`	`59`	`{`
Original file line number	Diff line number	Diff line change
`@@ -165,10 +165,13 @@ private T newInstanceFromResponse(NodeWrapper node, IBraintreeGateway gateway)`
`165`	`165`	`{`
`166`	`166`	`return new UsBankAccountVerification(node) as T;`
`167`	`167`	`}`
	`168`	`+ // VisaCheckoutCard has been deprecated for transactions`
	`169`	`+ #pragma warning disable 618`
`168`	`170`	`else if (typeof(T) == typeof(VisaCheckoutCard))`
`169`	`171`	`{`
`170`	`172`	`return new VisaCheckoutCard(node, gateway) as T;`
`171`	`173`	`}`
	`174`	`+ #pragma warning restore 618`
`172`	`175`	`#pragma warning disable 618`
`173`	`176`	`else if (typeof(T) == typeof(SamsungPayCard))`
`174`	`177`	`{`
Original file line number	Diff line number	Diff line change
`@@ -37,6 +37,7 @@ public class Dispute`
`37`	`37`	`public class TransactionAmount`
`38`	`38`	`{`
`39`	`39`	`public const decimal AUTHORIZE = 1000;`
	`40`	`+ public const decimal PARTIALLY_AUTHORIZED = 1004;`
`40`	`41`	`public const decimal DECLINE = 2000;`
`41`	`42`	`public const decimal HARD_DECLINE = 2015;`
`42`	`43`	`public const decimal FAILED = 3000;`
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,7 @@ public class TransactionOptionsRequest : Request`
`25`	`25`	`public TransactionOptionsAmexRewardsRequest AmexRewards { get; set; }`
`26`	`26`	`public TransactionOptionsVenmoRequest Venmo { get; set; }`
`27`	`27`	`public TransactionOptionsCreditCardRequest CreditCard { get; set; }`
	`28`	`+ public TransactionOptionsUsBankAccountRequest UsBankAccount { get; set; }`
`28`	`29`	`public TransactionOptionsProcessingOverridesRequest ProcessingOverrides { get; set; }`
`29`	`30`
`30`	`31`	`public override string ToXml(string root)`
`@@ -60,6 +61,7 @@ protected virtual RequestBuilder BuildRequest(string root)`
`60`	`61`	`AddElement("credit-card", CreditCard).`
`61`	`62`	`AddElement("amex-rewards", AmexRewards).`
`62`	`63`	`AddElement("venmo", Venmo).`
	`64`	`+ AddElement("us-bank-account", UsBankAccount).`
`63`	`65`	`AddElement("processing-overrides", ProcessingOverrides);`
`64`	`66`	`}`
`65`	`67`	`}`