3.45.0

Co-authored-by: David Johnson <djohnson14@paypal.com>

Author: braintreeps

CHANGELOG.md

@@ -1,7 +1,14 @@
 # Changelog
 
-## 3.45.0
-
+## Unreleased
+
+* Add Bank Account Instant Verification functionality
+* Add `BankAccountInstantVerificationGateway` for creating JWT tokens
+* Add `BankAccountInstantVerificationJwt` response object
+* Add `BankAccountInstantVerificationJwtRequest` for JWT creation
+* Add `achMandate` and `achMandateAcceptedAt` fields to `TransactionRequest`
+* Add `INSTANT_VERIFICATION` method to `UsBankAccountVerification.VerificationMethod`
+* Add `isDeviceToken` to `ApplePayCard` and `ApplePayDetails`
 * Add `achRejectReason` to `Transaction`
 * Add `rejectReason` to `AchReturnResponse`
 * Add `sender` and `receiver` to `transfer` in `Transaction`

pom.xml

@@ -2,7 +2,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.braintreepayments.gateway</groupId>
     <artifactId>braintree-java</artifactId>
-    <version>3.45.1-SNAPSHOT</version>
+    <version>3.45.0-SNAPSHOT</version>
     <description>Java Client Library for Braintree Payments Gateway</description>
     <packaging>bundle</packaging>
     <name>Braintree Gateway Java Client Library</name>
@@ -37,7 +37,7 @@
       <developerConnection>
         ${scmConnection}
       </developerConnection>
-      <tag>3.45.0</tag>
+      <tag>3.45.0-SNAPSHOT</tag>
     </scm>
 
     <developers>

src/main/java/com/braintreegateway/ApplePayCard.java

@@ -32,6 +32,7 @@ public class ApplePayCard implements PaymentMethod {
     private String healthcare;
     private String imageUrl;
     private boolean isDefault;
+    private boolean isDeviceToken;
     private String issuingBank;
     private String last4;
     private String merchantTokenIdentifier;
@@ -66,6 +67,7 @@ public ApplePayCard(NodeWrapper node) {
         this.healthcare = node.findString("healthcare");
         this.imageUrl = node.findString("image-url");
         this.isDefault = node.findBoolean("default");
+        this.isDeviceToken = node.findBoolean("is-device-token");
         this.issuingBank = node.findString("issuing-bank");
         this.last4 = node.findString("last-4");
         this.merchantTokenIdentifier = node.findString("merchant-token-identifier");
@@ -163,6 +165,10 @@ public String getImageUrl() {
         return imageUrl;
     }
 
+    public boolean getIsDeviceToken(){
+        return isDeviceToken;
+    }
+
     public String getIssuingBank() {
         return issuingBank;
     }

src/main/java/com/braintreegateway/ApplePayDetails.java

@@ -24,6 +24,7 @@ public class ApplePayDetails {
     private String globalId;
     private String healthcare;
     private String imageUrl;
+    private boolean isDeviceToken;
     private String issuingBank;
     private String last4;
     private String merchantTokenIdentifier;
@@ -53,6 +54,7 @@ public ApplePayDetails(NodeWrapper node) {
         globalId = node.findString("global-id");
         healthcare = node.findString("healthcare");
         imageUrl = node.findString("image-url");
+        isDeviceToken = node.findBoolean("is-device-token");
         issuingBank = node.findString("issuing-bank");
         last4 = node.findString("last-4");
         merchantTokenIdentifier = node.findString("merchant-token-identifier");
@@ -131,6 +133,10 @@ public String getPayroll() {
         return payroll;
     }
 
+    public boolean getIsDeviceToken(){
+        return isDeviceToken;
+    }
+
     public String getIssuingBank() {
         return issuingBank;
     }

src/main/java/com/braintreegateway/BankAccountInstantVerificationGateway.java

@@ -0,0 +1,53 @@
+package com.braintreegateway;
+
+import com.braintreegateway.exceptions.ServerException;
+import com.braintreegateway.util.GraphQLClient;
+import com.braintreegateway.util.Http;
+
+import java.util.Map;
+
+/**
+ * Provides methods to interact with Bank Account Instant Verification functionality.
+ */
+public class BankAccountInstantVerificationGateway {
+
+    private final GraphQLClient graphQLClient;
+
+    private static final String CREATE_JWT_MUTATION =
+        "mutation CreateBankAccountInstantVerificationJwt($input: CreateBankAccountInstantVerificationJwtInput!) { "
+        + "createBankAccountInstantVerificationJwt(input: $input) {"
+        + "    jwt"
+        + "  }"
+        + "}";
+
+    public BankAccountInstantVerificationGateway(BraintreeGateway gateway, Http http, Configuration configuration, GraphQLClient graphQLClient) {
+        this.graphQLClient = graphQLClient;
+    }
+
+    /**
+     * Creates a Bank Account Instant Verification JWT for initiating the Open Banking flow.
+     *
+     * @param request the JWT creation request containing business name and redirect URLs
+     * @return a {@link Result} containing the JWT
+     */
+    public Result<BankAccountInstantVerificationJwt> createJwt(BankAccountInstantVerificationJwtRequest request) {
+        Map<String, Object> response = graphQLClient.query(CREATE_JWT_MUTATION, request);
+        ValidationErrors errors = GraphQLClient.getErrors(response);
+
+        if (errors != null) {
+            return new Result<>(errors);
+        }
+
+        try {
+            Map<String, Object> data = (Map<String, Object>) response.get("data");
+            Map<String, Object> result = (Map<String, Object>) data.get("createBankAccountInstantVerificationJwt");
+            String jwt = (String) result.get("jwt");
+
+            BankAccountInstantVerificationJwt jwtObject = new BankAccountInstantVerificationJwt(jwt);
+            return new Result<>(jwtObject);
+
+        } catch (ClassCastException | NullPointerException e) {
+            throw new ServerException("Couldn't parse response: " + e.getMessage());
+        }
+  }
+}

src/main/java/com/braintreegateway/BankAccountInstantVerificationJwt.java

@@ -0,0 +1,22 @@
+package com.braintreegateway;
+
+/**
+ * Represents a Bank Account Instant Verification JWT.
+ */
+public class BankAccountInstantVerificationJwt {
+    private final String jwt;
+
+    public BankAccountInstantVerificationJwt(String jwt) {
+        this.jwt = jwt;
+    }
+
+    /**
+     * Returns the JWT for Bank Account Instant Verification.
+     *
+     * @return the JWT as a string
+     */
+    public String getJwt() {
+        return jwt;
+    }
+
+}

src/main/java/com/braintreegateway/BankAccountInstantVerificationJwtRequest.java

@@ -0,0 +1,79 @@
+package com.braintreegateway;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Provides a fluent interface to build requests for creating Bank Account Instant Verification JWTs.
+ */
+public class BankAccountInstantVerificationJwtRequest extends Request {
+    private String businessName;
+    private String returnUrl;
+    private String cancelUrl;
+
+    /**
+     * Sets the officially registered business name for the merchant.
+     *
+     * @param businessName the business name
+     * @return the BankAccountInstantVerificationJwtRequest
+     */
+    public BankAccountInstantVerificationJwtRequest businessName(String businessName) {
+        this.businessName = businessName;
+        return this;
+    }
+
+    /**
+     * Sets the URL to redirect the consumer after successful account selection.
+     *
+     * @param returnUrl the return URL
+     * @return the BankAccountInstantVerificationJwtRequest
+     */
+    public BankAccountInstantVerificationJwtRequest returnUrl(String returnUrl) {
+        this.returnUrl = returnUrl;
+        return this;
+    }
+
+    /**
+     * Sets the URL to redirect the consumer upon cancellation of the Open Banking flow.
+     *
+     * @param cancelUrl the cancel URL
+     * @return the BankAccountInstantVerificationJwtRequest
+     */
+    public BankAccountInstantVerificationJwtRequest cancelUrl(String cancelUrl) {
+        this.cancelUrl = cancelUrl;
+        return this;
+    }
+
+
+    public String getBusinessName() {
+        return businessName;
+    }
+
+    public String getReturnUrl() {
+        return returnUrl;
+    }
+
+    public String getCancelUrl() {
+        return cancelUrl;
+    }
+
+
+    @Override
+    public Map<String, Object> toGraphQLVariables() {
+        Map<String, Object> variables = new HashMap<>();
+        Map<String, Object> input = new HashMap<>();
+
+        if (businessName != null) {
+            input.put("businessName", businessName);
+        }
+        if (returnUrl != null) {
+            input.put("returnUrl", returnUrl);
+        }
+        if (cancelUrl != null) {
+            input.put("cancelUrl", cancelUrl);
+        }
+
+        variables.put("input", input);
+        return variables;
+    }
+}

src/main/java/com/braintreegateway/BraintreeGateway.java

@@ -303,4 +303,14 @@ public ReportGateway report() {
     public ExchangeRateQuoteGateway exchangeRateQuote() {
         return new ExchangeRateQuoteGateway(http, graphQLClient, configuration);
     }
+
+    /**
+     * Returns a {@link BankAccountInstantVerificationGateway} for interacting with
+     * Bank Account Instant Verification functionality.
+     *
+     * @return a {@link BankAccountInstantVerificationGateway}.
+     */
+    public BankAccountInstantVerificationGateway bankAccountInstantVerification() {
+        return new BankAccountInstantVerificationGateway(this, http, configuration, graphQLClient);
+    }
 }

src/main/java/com/braintreegateway/PaymentMethodRequest.java

@@ -23,6 +23,7 @@ public class PaymentMethodRequest extends Request {
     private String threeDSecureAuthenticationId;
     private String venmoSdkPaymentMethodCode;
     private PaymentMethodThreeDSecurePassThruRequest threeDSecurePassThruRequest;
+    private PaymentMethodUsBankAccountRequest usBankAccountRequest;
 
     public PaymentMethodRequest() {
     }
@@ -144,6 +145,11 @@ public PaymentMethodThreeDSecurePassThruRequest threeDSecurePassThruRequest() {
         return threeDSecurePassThruRequest;
     }
 
+    public PaymentMethodUsBankAccountRequest usBankAccount() {
+        this.usBankAccountRequest = new PaymentMethodUsBankAccountRequest(this);
+        return usBankAccountRequest;
+    }
+
     @Override
     public String toXML() {
         return buildRequest("payment-method").toXML();
@@ -171,7 +177,8 @@ protected RequestBuilder buildRequest(String root) {
             .addElement("paymentMethodNonce", paymentMethodNonce)
             .addElement("paypalRefreshToken", paypalRefreshToken)
             .addElement("threeDSecureAuthenticationId", threeDSecureAuthenticationId)
-            .addElement("venmoSdkPaymentMethodCode", venmoSdkPaymentMethodCode);
+            .addElement("venmoSdkPaymentMethodCode", venmoSdkPaymentMethodCode)
+            .addElement("usBankAccount", usBankAccountRequest);
 
         return builder;
     }

src/main/java/com/braintreegateway/PaymentMethodUsBankAccountRequest.java

@@ -0,0 +1,66 @@
+package com.braintreegateway;
+
+import java.util.Calendar;
+
+/**
+ * A request builder for US Bank Account data used in payment method requests.
+ */
+public class PaymentMethodUsBankAccountRequest extends Request {
+    private String achMandateText;
+    private Calendar achMandateAcceptedAt;
+    private PaymentMethodRequest parent;
+
+    public PaymentMethodUsBankAccountRequest(PaymentMethodRequest parent) {
+        this.parent = parent;
+    }
+
+    /**
+     * Sets the ACH mandate text for authorization.
+     *
+     * @param achMandateText the ACH mandate text
+     * @return the PaymentMethodUsBankAccountRequest
+     */
+    public PaymentMethodUsBankAccountRequest achMandateText(String achMandateText) {
+        this.achMandateText = achMandateText;
+        return this;
+    }
+
+    /**
+     * Sets the timestamp when the ACH mandate was accepted.
+     *
+     * @param achMandateAcceptedAt the timestamp when the mandate was accepted
+     * @return the PaymentMethodUsBankAccountRequest
+     */
+    public PaymentMethodUsBankAccountRequest achMandateAcceptedAt(Calendar achMandateAcceptedAt) {
+        this.achMandateAcceptedAt = achMandateAcceptedAt;
+        return this;
+    }
+
+    /**
+     * Returns to the parent PaymentMethodRequest.
+     *
+     * @return the PaymentMethodRequest
+     */
+    public PaymentMethodRequest done() {
+        return parent;
+    }
+
+    public String getAchMandateText() {
+        return achMandateText;
+    }
+
+    public Calendar getAchMandateAcceptedAt() {
+        return achMandateAcceptedAt;
+    }
+
+    @Override
+    public String toXML() {
+        return buildRequest("usBankAccount").toXML();
+    }
+
+    public RequestBuilder buildRequest(String root) {
+        return new RequestBuilder(root)
+            .addElement("achMandateText", achMandateText)
+            .addElement("achMandateAcceptedAt", achMandateAcceptedAt);
+    }
+}