# Support Items

Support items define the ways in which your users will be prompted to contact you on the Support screen. By default the SDK uses the following item:

private val DEFAULT_SUPPORT_ITEM = SNSSupportItem(
    R.string.sns_support_EMAIL_title,
    R.string.sns_support_EMAIL_description,
    R.drawable.sns_ic_email,
    SNSSupportItem.Type.Email,
    "[email protected]")

if you want to change the support items you should create a new list:

val supportItems = listOf(SNSSupportItem(
    R.string.google_title,
    R.string.google_subtitle,
    R.drawable.ic_google,
    SNSSupportItem.Type.Email,
    "[email protected]")
)
val snsSdkBuilder = SNSMobileSDK.Builder(this, apiUrl).withSupportItems(supportItems)

Each item must have a mandatory title, icon, subtitle, type and value. onClick listener is optional. By default the SDK handles clicks if a support item were an email or a url, but if you want to change this behavior you can implement your own onClick listener and handle it by yourself. For example:

val supportItems = listOf(SNSSupportItem(
    R.string.google_title,
    R.string.google_subtitle,
    R.drawable.ic_google,
    SNSSupportItem.Type.Email,
    "[email protected]", onClick = { item ->
        // to do something
    })
)

val snsSdkBuilder = SNSMobileSDK.Builder(this, apiUrl).withSupportItems(supportItems)

The support item can be one of three types:

enum class Type {
  Url,
  Email,
  Custom
}

If, for some reason, you wish to use Type.Custom, please make sure that you have implemented the onClick listener.

# Localization

If you want to localize the SDK, please, override the following keys in your resources:

For more information refer to the official documentation)

<string name="sns_please_wait">Please wait …</string>
<string name="sns_continue">Continue</string>
<string name="sns_cancel">Cancel</string>
<string name="sns_general_poweredBy">Powered by Sumsub</string>
<string name="sns_iddoc_type_PASSPORT">Passport</string>
<string name="sns_iddoc_type_DRIVERS">Driver License</string>
<string name="sns_iddoc_type_ID_CARD">ID Card</string>
<string name="sns_iddoc_type_BANK_CARD">Bank Card</string>
<string name="sns_iddoc_type_SNILS">Pension Card (SNILS)</string>
<string name="sns_iddoc_type_UTILITY_BILL">Utility Bill</string>
<string name="sns_iddoc_type_BANK_STATEMENT">Bank Statement</string>
<string name="sns_iddoc_type_TRAVEL_PASSPORT">Travel Passport</string>
<string name="sns_iddoc_type_SELFIE">Selfie</string>
<string name="sns_iddoc_type_ID_DOC_PHOTO">ID Doc Photo</string>
<string name="sns_iddoc_type_AGREEMENT">Agreement</string>
<string name="sns_iddoc_type_PROFILE_IMAGE">Profile Image</string>
<string name="sns_iddoc_type_EMPLOYMENT_CERTIFICATE">Employment Certificate</string>
<string name="sns_iddoc_type_DRIVERS_TRANSLATION">Driver License Translation</string>
<string name="sns_iddoc_type_VEHICLE_REGISTRATION_CERTIFICATE">Vehicle Registration Certificate</string>
<string name="sns_iddoc_type_INVESTOR_DOC">Investor Document</string>
<string name="sns_iddoc_type_INCOME_SOURCE">Income Source</string>
<string name="sns_iddoc_type_COMPANY_DOC">Company Document</string>
<string name="sns_iddoc_type_CONTRACT">Contract</string>
<string name="sns_iddoc_type_RESIDENCE_PERMIT">Residence Permit</string>
<string name="sns_iddoc_type_PROOF_OF_PAYMENT">Proof of Payment</string>
<string name="sns_iddoc_type_MRZ_DOCUMENT">MRZ Document</string>
<string name="sns_iddoc_type_LEGAL_ENTITY">Legal Entity Document</string>
<string name="sns_iddoc_type_OTHER">Other</string>
<string name="sns_iddoc_listing_join">\u0020•\u0020</string>
<string name="sns_iddoc_listing_join_details">\n•\u0020</string>
<string name="sns_oops_fatal_title">Oops! Something went wrong at our end.</string>
<string name="sns_oops_fatal_html"><![CDATA[We\'re sorry about that. You could go back and try again or contact <a href=\'support\'>support</a>.]]></string>
<string name="sns_oops_network_title">Oops! Seems like the network is down.</string>
<string name="sns_oops_network_html">Please check your internet connection and try again.</string>
<string name="sns_oops_action_goBack">Go back</string>
<string name="sns_oops_action_retry">Try again</string>
<string name="sns_step_defaults_scan_frontSide_title">Scan the document</string>
<string name="sns_step_defaults_scan_frontSide_brief">Make sure that all the details on the document are visible, free of blur and glare.</string>
<string name="sns_step_defaults_scan_frontSide_details" />
<string name="sns_step_defaults_scan_backSide_title">Scan the next page of the document</string>
<string name="sns_step_defaults_scan_backSide_brief">Make sure that all the details on the document are visible, free of blur and glare.</string>
<string name="sns_step_defaults_scan_backSide_details" />
<string name="sns_step_IDENTITY_title">Identity document</string>
<string name="sns_step_IDENTITY_prompt">Take a photo of your ID</string>
<string name="sns_step_IDENTITY_scan_frontSide_title">Front of ID</string>
<string name="sns_step_IDENTITY_scan_frontSide_brief">Scan the front of your ID document.</string>
<string name="sns_step_IDENTITY_scan_frontSide_details">Scan the front of your ID. It can be one of the following documents:
\n
\n• %s
\n
\nMake sure that the whole document is in the screen area.
\n
\nAll the information should be readable, without any reflections or blur.</string>

<string name="sns_step_IDENTITY_scan_backSide_title">Back of ID</string>
<string name="sns_step_IDENTITY_scan_backSide_brief">Flip your document over and scan the back side.</string>
<string name="sns_step_IDENTITY_scan_backSide_details">Scan the back of your ID. Make sure that the whole document is in the screen area.\nAll the information should be readable, without any reflections or blur.</string>
<string name="sns_step_PROOF_OF_RESIDENCE_title">Proof of Address</string>
<string name="sns_step_PROOF_OF_RESIDENCE_prompt">Take a photo of a Proof of Address</string>
<string name="sns_step_PROOF_OF_RESIDENCE_scan_frontSide_title">Proof of address</string>
<string name="sns_step_PROOF_OF_RESIDENCE_scan_frontSide_brief">Scan your Proof of address. The document should contain your full name, date of birth and be no older than 3 months.</string>
<string name="sns_step_PROOF_OF_RESIDENCE_scan_frontSide_details">
\n✅ We accept:
\n
\n• Bank statements
\n• Utility bills
\n• Internet/Cable TV/House phone line bills
\n• Tax returns
\n• Council tax bills
\n• Government-issued certifications of residence
\n
\n🚫 We don\'t accept:
\n
\n• Screenshots
\n• Mobile phone bills
\n• Medical bills
\n• Receipts for purchases
\n• Insurance statements
\n
\nMake sure that the document contains your full name, date of birth and is not older than 3 months.</string>
<string name="sns_step_SELFIE_title">Video selfie</string>
<string name="sns_step_SELFIE_prompt">Take a Selfie</string>
<string name="sns_step_SELFIE_recording_header">Record a Video selfie</string>
<string name="sns_step_SELFIE_recording_instructions">Read the green text aloud</string>
<string name="sns_step_SELFIE_recording_readAloudText">“I\'m not a robot”;“I confirm that I uploaded my own documents“</string>
<string name="sns_camera_permission_dialog_title">Access to the camera and the microphone</string>
<string name="sns_camera_permission_dialog_message">We need access to your camera and microphone. Please, go to Settings and enable it</string>
<string name="sns_camera_permission_dialog_ok_button">Ok</string>
<string name="sns_support_title">Support</string>
<string name="sns_support_subtitle">You can contact us in one of the following ways:</string>
<string name="sns_support_EMAIL_description">We\'ll be happy to help.\nJust send us your question.</string>
<string name="sns_support_EMAIL_title"><u>Email us</u></string>
<string name="sns_iddoc_status_notSubmitted">Not submitted</string>
<string name="sns_iddoc_status_submitted">Submitted</string>
<string name="sns_iddoc_status_reviewing">Under review</string>
<string name="sns_status_INITIAL_title">Verify your identity</string>
<string name="sns_status_INITIAL_subtitle">It will only take about 2 minutes</string>
<string name="sns_status_INITIAL_footerHtml"><![CDATA[By tapping Continue, you accept our <a href=\'gtc\'>Terms and Conditions</a> and agree to our processing of your personal data, as described in the <a href=\'pp\'>Consent to Personal Data Processing</a>]]></string>
<string name="sns_status_INITIAL_action_continue">Continue</string>
<string name="sns_status_INCOMPLETE_title">Complete your verification</string>
<string name="sns_status_INCOMPLETE_subtitle">It will only take about 2 minutes</string>
<string name="sns_status_INCOMPLETE_footerHtml"><![CDATA[To complete the verification process, you need to submit all the documents. If you experience any issues, please contact <a href=\'support\'>support</a>.]]></string>
<string name="sns_status_INCOMPLETE_action_continue">Continue</string>
<string name="sns_status_PENDING_title">Verification status</string>
<string name="sns_status_PENDING_subtitle">The system is reviewing your documents.\nThis usually takes about 2 minutes.</string>
<string name="sns_status_PENDING_footerHtml"><![CDATA[The verification status will change automatically once the review is complete. If you experience any issues, please contact <a href=\'support\'>support</a>.]]></string>
<string name="sns_status_REJECT_title">Verification status</string>
<string name="sns_status_REJECT_subtitle">Unfortunately, there is a problem with your documents. Find the details below to see what the issue is and how you can resolve it.</string>
<string name="sns_status_REJECT_footerHtml"><![CDATA[If you experience any issues, please contact <a href=\'support\'>support</a>.]]></string>
<string name="sns_status_FINAL_REJECT_title">Verification status</string>
<string name="sns_status_FINAL_REJECT_subtitle">Unfortunately, we couldn\'t verify your identity.</string>
<string name="sns_status_FINAL_REJECT_footerHtml"><![CDATA[If you have any questions, please contact <a href=\'support\'>support</a>.]]></string>
<string name="sns_status_APPROVED_title">Verification status</string>
<string name="sns_status_APPROVED_subtitle">Successfully completed</string>
<string name="sns_status_APPROVED_footerHtml" />
<string name="sns_tos_GTC_url">https://test-msdk.sumsub.com/legal/en/gtc.html</string>
<string name="sns_tos_PP_url">https://test-msdk.sumsub.com/legal/en/pp.html</string>
<string name="sns_tos_PP_html"/>
<string name="sns_tos_GTC_html"/>
<string name="sns_tos_action_accept">Got it!</string>
<string name="sns_prompt_doubleSide_text">Is the document you scanned double-sided?"</string>
<string name="sns_prompt_doubleSide_action_yes">Yes</string>
<string name="sns_prompt_doubleSide_action_no">No</string>
<string name="sns_preview_photo_title">Photo preview</string>
<string name="sns_preview_photo_subtitle">Make sure that all the information on the document is visible and easy to read</string>
<string name="sns_preview_photo_action_accept">Document is readable</string>
<string name="sns_preview_photo_action_retake">Retake photo</string>
<string name="sns_preview_video_title">Video preview</string>
<string name="sns_preview_video_subtitle">Make sure that the video is not blurred or otherwise defected and that the sound is clear</string>
<string name="sns_preview_video_action_accept">Video is acceptable</string>
<string name="sns_preview_video_action_retake">Retake video</string>

# Liveness 3D

For the liveness3d you also should override the following keys:

 <string name="sns_liveness_title">Liveness detection</string>
 <string name="sns_liveness_initializing">Starting…</string>
 <string name="sns_liveness_prepareForRetake">Just a second…</string>
 <string name="sns_liveness_processing">Processing…</string>
 <string name="sns_liveness_action_cancel">Cancel</string>
 <string name="sns_liveness_action_continue">Continue</string>
 <string name="sns_liveness_action_retry">Resume</string>
 <string name="sns_liveness_check_success">Successful!</string>
 <string name="sns_liveness_check_failed">Check failed, please try again.</string>
 <string name="sns_liveness_fail_deviceLocked">Device is locked, please try again later.</string>
 <string name="sns_liveness_fail_networkFailure">Please check your internet connection and try again.</string>
 <string name="sns_liveness_fail_wrongOrientation">Please turn your device so that it is in portrait mode and try again.</string>
 <string name="sns_liveness_fail_sessionTimeout">You\'ve been inactive for a while. Tap Resume to continue.</string>
 <string name="sns_liveness_fail_contextSwitch">Please neither lock the screen nor switch to other apps during the process.</string>
 <string name="sns_liveness_fail_cameraInitialization">Unable to start the front camera. Please make sure that your camera is functioning properly.</string>
 <string name="zoom_accessibility_cancel_button">Cancel</string>
 <string name="zoom_action_ok">OK</string>
 <string name="zoom_action_im_ready">I\'m ready</string>
 <string name="zoom_camera_permission_header">Turn on camera</string>
 <string name="zoom_camera_permission_message_enroll">Please turn on your selfie camera.</string>
 <string name="zoom_camera_permission_message_auth">The app needs access to your camera. Tap below to allow it in Settings.</string>
 <string name="zoom_camera_permission_enable_camera">Turn on camera</string>
 <string name="zoom_camera_permission_launch_settings">Open Settings</string>
 <string name="zoom_feedback_center_face">Center your face</string>
 <string name="zoom_feedback_face_not_found">Center your face</string>
 <string name="zoom_feedback_face_not_looking_straight_ahead">Look at the camera</string>
 <string name="zoom_feedback_face_not_upright">Hold your head straight</string>
 <string name="zoom_feedback_hold_steady">Don\'t move</string>
 <string name="zoom_feedback_move_phone_away">Move back</string>
 <string name="zoom_feedback_move_phone_closer">Move closer</string>
 <string name="zoom_feedback_move_phone_even_closer">Even closer</string>
 <string name="zoom_feedback_move_phone_to_eye_level">Raise your chin</string>
 <string name="zoom_feedback_use_even_lighting">Too dark</string>
 <string name="zoom_instructions_header_ready">Get ready for\nyour video selfie</string>
 <string name="zoom_instructions_message_ready">Fit your face in\nthe small oval, and then the big oval</string>
 <string name="zoom_result_facemap_upload_message">Processing</string>
 <string name="zoom_retry_header">Let\'s try that again</string>
 <string name="zoom_retry_subheader_message">Please take a look at your photo and see what needs to be corrected.</string>
 <string name="zoom_retry_instruction_message_1">Neutral expression, no smiling</string>
 <string name="zoom_retry_instruction_message_2">No glare or poor lighting</string>
 <string name="zoom_retry_instruction_message_3" />
 <string name="zoom_retry_your_image_label">Your selfie</string>
 <string name="zoom_retry_ideal_image_label">Sample image</string>

# Theme

The SDK uses material components theme for the widgets. If you want to change a color, typeface, etc., you should override the following theme:

# Base Theme

<style name="Theme.SNSCore" parent="Theme.MaterialComponents.DayNight.NoActionBar">
 <item name="colorAccent">@color/sns_blue</item>
 <item name="android:windowBackground">@color/sns_white</item>
 <item name="android:colorBackground">@color/sns_white</item>
 <item name="android:textViewStyle">@style/Widget.SNSTextView</item>
 <item name="materialButtonStyle">@style/Widget.SNSButton</item>
 <item name="materialAlertDialogTheme">@style/Widget.SNSMaterialDialogAlert</item>
</style>

# Base Widgets

# TextView

<style name="Widget.SNSTextView" parent="@style/Widget.MaterialComponents.TextView">
 <item name="android:textColorLink">@color/sns_blue</item>
</style>

# Button

# Filled
<style name="Widget.SNSButton" parent="Widget.MaterialComponents.Button.UnelevatedButton">
 <item name="android:fontFamily">sans-serif-light</item>
 <item name="android:textSize">16sp</item>
 <item name="android:textColor">@color/sns_white</item>
 <item name="android:textAllCaps">false</item>
 <item name="cornerRadius">8dp</item>
 <item name="backgroundTint">@color/sns_blue</item>
</style>
# Outlined
<style name="Widget.SNSButton.Outlined" parent="Widget.MaterialComponents.Button.OutlinedButton">
 <item name="android:fontFamily">sans-serif-light</item>
 <item name="android:textSize">16sp</item>
 <item name="android:textColor">@color/sns_blue</item>
 <item name="android:textAllCaps">false</item>
 <item name="cornerRadius">8dp</item>
 <item name="strokeColor">@color/sns_blue</item>
</style>
# Text
<style name="Widget.SNSButton.Text" parent="Widget.MaterialComponents.Button.TextButton">
 <item name="android:fontFamily">sans-serif-light</item>
 <item name="android:textSize">16sp</item>
 <item name="android:textColor">@color/sns_blue</item>
 <item name="android:textAllCaps">false</item>
</style>

# Alert Dialog

<style name="Widget.SNSMaterialDialogAlert" parent="ThemeOverlay.MaterialComponents.Dialog.Alert">
 <item name="materialAlertDialogBodyTextStyle">@style/TextAppearance.SNSMaterialDialogAlert.Body</item>
 <item name="buttonBarPositiveButtonStyle">@style/Widget.SNSMaterialDialogAlert.Button.Positive</item>
 <item name="buttonBarNegativeButtonStyle">@style/Widget.SNSMaterialDialogAlert.Button.Negative</item>
</style>

<style name="Widget.SNSMaterialDialogAlert.Button.Positive" parent="@style/Widget.MaterialComponents.Button.TextButton.Dialog">
 <item name="android:textColor">@color/sns_blue</item>
 <item name="android:fontFamily">sans-serif-light</item>
 <item name="fontFamily">sans-serif-light</item>
</style>

<style name="Widget.SNSMaterialDialogAlert.Button.Negative" parent="@style/Widget.MaterialComponents.Button.TextButton.Dialog">
 <item name="android:textColor">@color/sns_blue</item>
 <item name="android:fontFamily">sans-serif-light</item>
 <item name="fontFamily">sans-serif-light</item>
</style>

<style name="TextAppearance.SNSMaterialDialogAlert.Body" parent="@style/TextAppearance.MaterialComponents.Body2">
 <item name="android:textColor">@color/sns_black</item>
 <item name="android:textSize">16sp</item>
 <item name="android:fontFamily">sans-serif-light</item>
 <item name="fontFamily">sans-serif-light</item>
</style>

# BottomSheet Dialog

<style name="Widget.SNSBottomSheet.Modal" parent="@style/Widget.Design.BottomSheet.Modal">
 <item name="android:background">@drawable/sns_bg_bottom_sheet_dialog_fragment</item>
</style>

<style name="Widget.SNSBottomSheetDialog" parent="@style/Theme.Design.Light.BottomSheetDialog">
 <item name="android:windowIsFloating">false</item>
 <item name="bottomSheetStyle">@style/Widget.SNSBottomSheet.Modal</item>
</style>
Last Updated: 6/9/2020, 8:20:24 AM