Skip to main content

Result Screen UI

The Entrupy Android SDK's Result Screen provides immediate feedback to users after they complete the Capture Flow. This screen displays the initial status of their authentication submission and is managed entirely by the SDK.

Overview​

By default, the Result Screen is a full-screen activity that appears automatically after a successful capture submission. It serves as a bridge between the capture process and the final authentication result, providing users with:

  • Immediate Confirmation: Visual confirmation that their submission was received.
  • Status Information: Current processing status and estimated completion time.
  • Next Steps: Clear guidance on what to expect and how to access results.

1. How It Works​

The Result Screen is displayed automatically by the SDK after the user completes the Capture Flow when you pass showResultScreen = true to startCapture. Your application does not need to trigger it — the SDK manages its presentation and lifecycle internally. To keep the user in your own UI instead, see Skipping the Result Screen.

import com.entrupy.sdk.app.EntrupyApp
import com.entrupy.sdk.listeners.CaptureCallback
import com.entrupy.sdk.model.METADATA_KEY_BRAND
import com.entrupy.sdk.model.METADATA_KEY_ITEM_TYPE
import com.entrupy.sdk.model.METADATA_KEY_CUSTOMER_ITEM_ID
import com.entrupy.sdk.model.configMetadataOf

val configMetadata = configMetadataOf(
METADATA_KEY_BRAND to "Nike",
METADATA_KEY_ITEM_TYPE to "Sneakers",
METADATA_KEY_CUSTOMER_ITEM_ID to "SKU-12345"
)

EntrupyApp.sharedInstance().startCapture(
configMetadata = configMetadata,
callback = object : CaptureCallback {
override fun onCaptureStarted() {
Log.d("Capture", "Capture flow launched — Result Screen will appear after submission")
}

override fun onCaptureError(errorCode: Int, description: String) {
Log.e("Capture", "Capture failed: $description (Code: $errorCode)")
}

override fun onCaptureTimeout() {
Log.w("Capture", "Capture session timed out")
}
},
showResultScreen = true,
)

After the user captures and submits images, the SDK automatically:

  1. Uploads the images and metadata to Entrupy.
  2. Presents the Result Screen showing submission confirmation and processing status.
  3. Provides the user with a path to the Detail View for tracking results.

2. Result Screen Content​

2.1 Submission Confirmation​

  • Success Message: Clear indication that the item was submitted.
  • Submission Time: When the item was submitted for processing.

2.2 Processing Status​

  • Current Status: Real-time status updates (e.g., "Processing", "Analyzing").
  • Estimated Time: ETA for completion.
  • Progress Indicators: Visual feedback while processing.

2.3 Next Steps​

  • Detail View Access: A path to the Detail View for the submitted item.
  • Support Information: Contact details or support options if needed.

3. Theming​

The Result Screen respects the same theming configuration as other SDK components. See UI Theme Customization for details on customizing its colors.

4. Transition to Detail View​

Once the authentication result becomes available, users can navigate to the Detail View for comprehensive result information:

import com.entrupy.sdk.app.EntrupyApp

fun showItemResult(entrupyId: String) {
EntrupyApp.sharedInstance().displayDetailViewForItem(entrupyId)
}

5. Skipping the Result Screen​

To keep the user in your own UI after submission, pass showResultScreen = false to startCapture. The SDK then behaves like the iOS SDK: it waits for the authentication's result, passes it to onCaptureCompleted, and returns to your app without showing the Result Screen.

import com.entrupy.sdk.app.EntrupyApp
import com.entrupy.sdk.listeners.CaptureCallback
import com.entrupy.sdk.listeners.CaptureResult

EntrupyApp.sharedInstance().startCapture(
configMetadata = configMetadata,
callback = object : CaptureCallback {
override fun onCaptureStarted() {
Log.d("Capture", "Capture flow launched")
}

override fun onCaptureError(errorCode: Int, description: String) {
Log.e("Capture", "Capture failed: $description (Code: $errorCode)")
}

override fun onCaptureCompleted(result: CaptureResult) {
// Present your own confirmation, or open the SDK's Detail View for the item.
result.authenticationId?.let(::showItemResult)
}
},
showResultScreen = false,
)

onCaptureCompleted receives a CaptureResult with:

PropertyDescription
sessionUuidThe capture session.
authenticationIdThe item's Entrupy ID, which displayDetailViewForItem opens.
statusThe result's ID, such as authentic, or needs_review while Entrupy is still reviewing the item. Make no assumption about when the final result arrives.
propertiesThe result's properties object (brand, function, mode, and model), with nested objects as maps.
note

If the result can't be read in time, onCaptureCompleted still fires, with only sessionUuid set, and the result reaches your backend through webhooks. Once the images are submitted, onCaptureCompleted is the callback you receive, even if the user leaves while the SDK is waiting for the result.

showResultScreen is the only way to skip the Result Screen: metadata passed to startCapture can't change it.

Next Steps​