Merchant Passed Email addition to Native Checkout

Sources/BraintreePayPal/BTPayPalCheckoutRequest.swift

@@ -82,6 +82,9 @@ import BraintreeCore
     /// Optional: If set to `true`, this enables the Checkout with Vault flow, where the customer will be prompted to consent to a billing agreement during checkout. Defaults to `false`.
     public var requestBillingAgreement: Bool
 
+    /// Optional: User email that we want to pass through to PayPal Checkout to initiate a quicker authentication flow in case the merchant's user has a PayPal Account with the same email.
+    public var userAuthenticationEmail: String?
+
     // MARK: - Initializer
 
     /// Initializes a PayPal Native Checkout request
@@ -101,14 +104,16 @@ import BraintreeCore
         userAction: BTPayPalRequestUserAction = .none,
         offerPayLater: Bool = false,
         currencyCode: String? = nil,
-        requestBillingAgreement: Bool = false
+        requestBillingAgreement: Bool = false,
+        userAuthenticationEmail: String? = nil
     ) {
         self.amount = amount
         self.intent = intent
         self.userAction = userAction
         self.offerPayLater = offerPayLater
         self.currencyCode = currencyCode
         self.requestBillingAgreement = requestBillingAgreement
+        self.userAuthenticationEmail = userAuthenticationEmail
 
         super.init(hermesPath: "v1/paypal_hermes/create_payment_resource", paymentType: .checkout)
     }

Sources/BraintreePayPal/BTPayPalVaultRequest.swift

@@ -12,12 +12,16 @@ import BraintreeCore
     /// Optional: Offers PayPal Credit if the customer qualifies. Defaults to `false`.
     public var offerCredit: Bool
 
+    /// Optional: User email that we want to pass through to PayPal Checkout to initiate a quicker authentication flow in case the merchant's user has a PayPal Account with the same email..
+    public var userAuthenticationEmail: String?
+
     // MARK: - Initializer
 
     /// Initializes a PayPal Native Vault request
     /// - Parameter offerCredit: Optional: Offers PayPal Credit if the customer qualifies. Defaults to `false`.
-    public init(offerCredit: Bool = false) {
+    public init(offerCredit: Bool = false, userAuthenticationEmail: String? = nil) {
         self.offerCredit = offerCredit
+        self.userAuthenticationEmail = userAuthenticationEmail
 
         super.init(hermesPath: "v1/paypal_hermes/setup_billing_agreement", paymentType: .vault)
     }

Sources/BraintreePayPalNativeCheckout/BTPayPalNativeCheckoutClient.swift

@@ -41,7 +41,7 @@ import PayPalCheckout
         _ request: BTPayPalNativeCheckoutRequest,
         completion: @escaping (BTPayPalNativeCheckoutAccountNonce?, Error?) -> Void
     ) {
-        tokenize(request: request, completion: completion)
+        tokenize(request: request, userAuthenticationEmail: request.userAuthenticationEmail, completion: completion)
     }
 
     /// Tokenize a PayPal request to be used with the PayPal Native Checkout flow.
@@ -107,6 +107,7 @@ import PayPalCheckout
 
     private func tokenize(
         request: BTPayPalRequest,
+        userAuthenticationEmail: String? = nil,
         completion: @escaping (BTPayPalNativeCheckoutAccountNonce?, Error?) -> Void
     ) {
         clientMetadataID = request.riskCorrelationID ?? State.correlationIDs.riskCorrelationID
@@ -156,7 +157,7 @@ import PayPalCheckout
                     },
                     environment: order.environment
                 )
-
+                payPalNativeConfig.authConfig.userEmail = userAuthenticationEmail
                 PayPalCheckout.Checkout.showsExitAlert = false
                 PayPalCheckout.Checkout.set(config: payPalNativeConfig)
 

Sources/BraintreePayPalNativeCheckout/BTPayPalNativeCheckoutRequest.swift

@@ -24,20 +24,24 @@ import BraintreePayPal
     ///   - requestBillingAgreement: Optional: If set to `true`, this enables the Checkout with Vault flow, where the customer will be prompted to consent to a billing agreement during checkout.
     ///   - billingAgreementDescription: Optional: Display a custom description to the user for a billing agreement. For Checkout with Vault flows, you must also
     ///   set `requestBillingAgreement` to `true` on your `BTPayPalNativeVaultRequest`.
+    ///   - userAuthenticationEmail: Optional: Optional: User email that we want to pass through to PayPal Checkout to initiate a quicker authentication flow in
+    ///   case the merchant's user has a PayPal Account with the same email.
     public init(
         amount: String,
         intent: BTPayPalRequestIntent = .authorize,
         offerPayLater: Bool = false,
         currencyCode: String? = nil,
         requestBillingAgreement: Bool = false,
-        billingAgreementDescription: String? = nil
+        billingAgreementDescription: String? = nil,
+        userAuthenticationEmail: String? = nil
     ) {
         super.init(
             amount: amount,
             intent: intent,
             offerPayLater: offerPayLater,
             currencyCode: currencyCode,
-            requestBillingAgreement: requestBillingAgreement
+            requestBillingAgreement: requestBillingAgreement,
+            userAuthenticationEmail: userAuthenticationEmail
         )
 
         self.amount = amount
@@ -46,5 +50,6 @@ import BraintreePayPal
         self.currencyCode = currencyCode
         self.requestBillingAgreement = requestBillingAgreement
         self.billingAgreementDescription = billingAgreementDescription
+        self.userAuthenticationEmail = userAuthenticationEmail
     }
 }

Sources/BraintreePayPalNativeCheckout/BTPayPalNativeVaultRequest.swift

@@ -16,13 +16,16 @@ import BraintreePayPal
     /// Initializes a PayPal Native Vault request
     /// - Parameters:
     ///   - offerCredit: Optional: Offers PayPal Credit if the customer qualifies. Defaults to `false`.
+    ///   - userAuthenticationEmail: User email that we want to pass through to PayPal Checkout to initiate a quicker
+    ///    authentication flow in case the merchant's user has a PayPal Account with the same email.
     ///   - billingAgreementDescription: Optional: Display a custom description to the user for a billing agreement. For Checkout with Vault flows, you must also set
     ///   `requestBillingAgreement` to `true` on your `BTPayPalCheckoutRequest`.
     public init(
         offerCredit: Bool = false,
+        userAuthenticationEmail: String? = nil,
         billingAgreementDescription: String? = nil
     ) {
-        super.init(offerCredit: offerCredit)
+        super.init(offerCredit: offerCredit, userAuthenticationEmail: userAuthenticationEmail)
         self.billingAgreementDescription = billingAgreementDescription
     }
 }