⏺ Add callback-based start function with PayPalWebCheckoutCallback interface

  - Create PayPalWebCheckoutCallback fun interface following CardApproveOrderCallback pattern
  - Add overloaded start() function accepting PayPalWebCheckoutCallback

Author: kgangineni

CorePayments/src/main/java/com/paypal/android/corepayments/APIClientError.kt

@@ -9,9 +9,10 @@ import androidx.annotation.RestrictTo
 object APIClientError {
 
     // 0. An unknown error occurred.
-    fun unknownError(correlationId: String?) = PayPalSDKError(
+    fun unknownError(correlationId: String? = null, throwable: Throwable? = null) = PayPalSDKError(
         code = PayPalSDKErrorCode.UNKNOWN.ordinal,
         errorDescription = "An unknown error occurred. Contact developer.paypal.com/support.",
+        reason = throwable,
         correlationId = correlationId
     )
 
@@ -37,12 +38,6 @@ object APIClientError {
         correlationId = correlationId
     )
 
-    // 4. There was an error constructing the URLRequest.
-    val invalidUrlRequest = PayPalSDKError(
-        code = PayPalSDKErrorCode.INVALID_URL_REQUEST.ordinal,
-        errorDescription = "An error occurred constructing an HTTP request. Contact developer.paypal.com/support."
-    )
-
     // 5. The server's response body returned an error message.
     fun serverResponseError(correlationId: String?) = PayPalSDKError(
         code = PayPalSDKErrorCode.SERVER_RESPONSE_ERROR.ordinal,
@@ -58,28 +53,6 @@ object APIClientError {
             correlationId = correlationId
         )
 
-    val payPalCheckoutError: (description: String) -> PayPalSDKError = { description ->
-        PayPalSDKError(
-            code = PayPalSDKErrorCode.CHECKOUT_ERROR.ordinal,
-            errorDescription = description
-        )
-    }
-
-    val payPalNativeCheckoutError: (description: String, reason: Exception) -> PayPalSDKError =
-        { description, reason ->
-            PayPalSDKError(
-                code = PayPalSDKErrorCode.NATIVE_CHECKOUT_ERROR.ordinal,
-                errorDescription = description,
-                reason = reason
-            )
-        }
-
-    fun clientIDNotFoundError(code: Int, correlationId: String?) = PayPalSDKError(
-        code = code,
-        errorDescription = "Error fetching clientId. Contact developer.paypal.com/support.",
-        correlationId = correlationId
-    )
-
     fun graphQLJSONParseError(correlationId: String?, reason: Exception): PayPalSDKError {
         val message =
             "An error occurred while parsing the GraphQL response JSON. Contact developer.paypal.com/support."

CorePayments/src/main/java/com/paypal/android/corepayments/PayPalSDKErrorCode.kt

@@ -15,5 +15,6 @@ enum class PayPalSDKErrorCode {
     SERVER_RESPONSE_ERROR,
     CHECKOUT_ERROR,
     NATIVE_CHECKOUT_ERROR,
-    GRAPHQL_JSON_INVALID_ERROR
+    GRAPHQL_JSON_INVALID_ERROR,
+    NO_ACCESS_TOKEN_ERROR,
 }

CorePayments/src/main/java/com/paypal/android/corepayments/api/AuthenticationSecureTokenServiceAPI.kt

@@ -0,0 +1,65 @@
+package com.paypal.android.corepayments.api
+
+import androidx.annotation.RestrictTo
+import com.paypal.android.corepayments.APIClientError
+import com.paypal.android.corepayments.APIRequest
+import com.paypal.android.corepayments.CoreConfig
+import com.paypal.android.corepayments.HttpMethod
+import com.paypal.android.corepayments.PayPalSDKError
+import com.paypal.android.corepayments.PayPalSDKErrorCode
+import com.paypal.android.corepayments.RestClient
+import com.paypal.android.corepayments.base64encoded
+import org.json.JSONObject
+
+@RestrictTo(RestrictTo.Scope.LIBRARY_GROUP)
+class AuthenticationSecureTokenServiceAPI(
+    private val coreConfig: CoreConfig,
+    private val restClient: RestClient = RestClient(configuration = coreConfig),
+) {
+    suspend fun createLowScopedAccessToken(): CreateLowScopedAccessTokenResult {
+        val requestBody = "grant_type=client_credentials&response_type=token"
+
+        val headers = mutableMapOf(
+            "Authorization" to "Basic ${coreConfig.clientId.base64encoded()}:",
+            "Content-Type" to "application/x-www-form-urlencoded"
+        )
+
+        val apiRequest = APIRequest(
+            path = "v1/oauth2/token",
+            method = HttpMethod.POST,
+            body = requestBody,
+            headers = headers
+        )
+
+        return runCatching {
+            val httpResponse = restClient.send(apiRequest)
+            val correlationId = httpResponse.headers["paypal-debug-id"]
+            if (httpResponse.isSuccessful && httpResponse.body != null) {
+                val jsonObject = JSONObject(httpResponse.body)
+                val token = jsonObject.optString("access_token")
+                if (token.isNotEmpty()) {
+                    CreateLowScopedAccessTokenResult.Success(token)
+                } else {
+                    val error = PayPalSDKError(
+                        code = PayPalSDKErrorCode.NO_ACCESS_TOKEN_ERROR.ordinal,
+                        errorDescription = "Missing access_token in response",
+                        correlationId = correlationId
+                    )
+                    CreateLowScopedAccessTokenResult.Failure(error)
+                }
+            } else {
+                val error = httpResponse.run {
+                    PayPalSDKError(
+                        code = status,
+                        errorDescription = body ?: "Unknown error",
+                        correlationId = correlationId
+                    )
+                }
+                CreateLowScopedAccessTokenResult.Failure(error)
+            }
+        }.getOrElse { throwable ->
+            val error = APIClientError.unknownError(throwable = throwable)
+            CreateLowScopedAccessTokenResult.Failure(error)
+        }
+    }
+}

CorePayments/src/main/java/com/paypal/android/corepayments/api/CreateLowScopedAccessTokenResult.kt

@@ -0,0 +1,21 @@
+package com.paypal.android.corepayments.api
+
+import androidx.annotation.RestrictTo
+import com.paypal.android.corepayments.PayPalSDKError
+
+@RestrictTo(RestrictTo.Scope.LIBRARY_GROUP)
+sealed class CreateLowScopedAccessTokenResult {
+    /**
+     * The request to get client token was successful.
+     *
+     * @property token the access token from the response
+     */
+    data class Success(val token: String) : CreateLowScopedAccessTokenResult()
+
+    /**
+     * There was an error with the request to get client token.
+     *
+     * @property error the error that occurred
+     */
+    data class Failure(val error: PayPalSDKError) : CreateLowScopedAccessTokenResult()
+}