Skip to content

smileidentity/android

Repository files navigation

Smile ID Android SDK

Build Maven Central Sonatype Nexus (Snapshots) Build Sample App

Smile ID provides the best solutions for Real Time Digital KYC, Identity Verification, User Onboarding, and User Authentication across Africa.

If you haven’t already, sign up for a free Smile ID account, which comes with Sandbox access.

Please see CHANGELOG.md or Releases for the most recent version and release notes

Get it on Google Play

Getting Started

Full documentation is available at https://docs.usesmileid.com/integration-options/mobile

Javadocs are available at https://javadoc.io/doc/com.smileidentity/android-sdk/latest/index.html

The sample app included in this repo is a good reference implementation

0. Requirements

  • Android 5.0 (API level 21) and above
  • Google Play Services

1. Dependency

The SDK is available on Maven Central. To use it, add the following to your build.gradle:

implementation("com.smileidentity:android-sdk:<latest-version>")

2. Smile Config

Please download your smile_config.json file from the Smile ID Portal and add it to your assets directory (e.g. app/src/main/assets). You may need to create the directory if it does not already exist.

3. Initialization

The SDK should be initialized within your Application class' onCreate:

SmileID.initialize(this) 

UI Components

All UI functionality is exposed via either Jetpack Compose or Fragments

Jetpack Compose

All Composables are available under the SmileID object.

e.g.

SmileID.SmartSelfieEnrollment()
SmileID.SmartSelfieAuthentication()
SmileID.DocumentVerification()
SmileID.BiometricKYC()

Fragment

All Fragments are available under the com.smileidentity.fragment package. (e.g. SmartSelfieEnrollmentFragment)

Theming

To customize the theme, you can pass in a custom ColorScheme to the SmileID composable, OR override the color resources defined in the SDK

API

To make raw API requests, you can use SmileID.api (requires coroutines)

Getting Help

For detailed documentation, please visit https://docs.usesmileid.com/integration-options/mobile

If you require further assistance, you can file a support ticket or contact us

Contributing

Bug reports and Pull Requests are welcomed. Please see CONTRIBUTING.md

License

MIT License