{"id":28547275,"url":"https://github.com/ekycsolutions/ekyc-id-android","last_synced_at":"2026-03-10T23:04:45.001Z","repository":{"id":39833109,"uuid":"507213985","full_name":"EKYCSolutions/ekyc-id-android","owner":"EKYCSolutions","description":"An easy to use SDK for developing Identity Verification for KYC process. With this SDK, developers can quickly integrate KYC process into their Android apps.","archived":false,"fork":false,"pushed_at":"2025-02-14T09:20:58.000Z","size":80701,"stargazers_count":13,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-07T17:43:05.858Z","etag":null,"topics":["cambodia","document-scanner","ekyc","kotlin","kotlin-android","liveness-detection"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EKYCSolutions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-25T04:35:52.000Z","updated_at":"2025-04-12T05:42:29.000Z","dependencies_parsed_at":"2024-04-10T11:27:08.326Z","dependency_job_id":"94790b01-b2a0-4e2b-ac90-886e6874dd3e","html_url":"https://github.com/EKYCSolutions/ekyc-id-android","commit_stats":null,"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"purl":"pkg:github/EKYCSolutions/ekyc-id-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EKYCSolutions%2Fekyc-id-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EKYCSolutions%2Fekyc-id-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EKYCSolutions%2Fekyc-id-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EKYCSolutions%2Fekyc-id-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EKYCSolutions","download_url":"https://codeload.github.com/EKYCSolutions/ekyc-id-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EKYCSolutions%2Fekyc-id-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30360676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"ssl_error","status_checked_at":"2026-03-10T21:40:59.357Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cambodia","document-scanner","ekyc","kotlin","kotlin-android","liveness-detection"],"created_at":"2025-06-10T00:10:10.132Z","updated_at":"2026-03-10T23:04:44.996Z","avatar_url":"https://github.com/EKYCSolutions.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![ekyc-logo](https://user-images.githubusercontent.com/81238558/175898689-22d5a275-45ec-4a5e-89c7-988dbbb073b0.png)\n\n\u003ch1\u003eEkycID SDK for Android\u003c/h1\u003e\u003cbr\u003e\n\n![](https://img.shields.io/badge/platform-android-blue) ![](https://img.shields.io/github/v/tag/EKYCSolutions/ekyc-id-android?label=version)\n\n\nThe EkycID Android SDK lets you build a fantastic OCR and Face Recognition experience in your Android app.\n\nWith one quick scan, your users will be able to extract information from their identity cards, passports, driver licenses, license plates, vehicle registration, COVID-19 vaccination card, and any other government-issued document.\n\n\nEkycID is:\n* Easy to integrate into existing ecosystems and solutions through the use of SDKs that support both native and hybrid applications.\n* Better for user experience because the document detection and liveness checks are done directly offline on the device.\n* Great for cutting down operations costs and increasing efficiency by decreasing reliance on human labor and the time needed for manual data entry. \n\n\nEkycID can:\n* Extract information from identity documents through document recognition \u0026 OCR.\n* Verify whether an individual is real or fake through liveness detection, and face recognition. \n* Verify the authenticity of the identity documents by combining the power of document detection, OCR, liveness detection, and face recognition. \n\n\nTo see all of these features at work, download our free demo app:\n\n\u003ca href='https://play.google.com/store/apps/details?id=com.ekyc.demo_app\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'\u003e\u003cimg alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width=\"300\" \n     height=\"100\"/\u003e\n\u003c/a\u003e\n\n# 1. Requirements\n- minSdkVersion: 21\n- targetSdkVersion: 33\n- compileSdkVersion: 33\n\n# 2. Installation\n**Step 1:** Add the JitPack repository to your root build.gradle at the end of repositories.\n\n```gradle\nallprojects {\n     repositories {\n          ...\n          maven { url 'https://jitpack.io' }\n     }\n}\n```\n**Step 2:** Add the dependency.\n```gradle\ndependencies {\n     implementation 'com.github.EKYCSolutions:ekyc-id-android:1.0.21'\n}\n```\n\n# 3. Usage\n\n## 3.1. Document Scanner\n\n**Step 1:** Initialize `Initializer` class and called `initializer.start()` in onResume.\n```kotlin\nclass MainActivity : AppCompatActivity() {\n    val initializer = Initializer(this)\n\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n    }\n\n    @RequiresApi(Build.VERSION_CODES.N)\n    override fun onResume() {\n        super.onResume()\n        \n        // Start initializer here\n        initializer.start {\n            \n        }\n    }\n}\n```\n\n**Step 2:** Add DocumentScannerCameraView to your `layout.xml`\n```xml\n\n\u003ccom.ekycsolutions.ekycid.documentscanner.DocumentScannerCameraView\n      android:id=\"@+id/documentScannerCameraView\n      android:layout_width=\"match_parent\"\n      android:layout_height=\"match_parent\" /\u003e\n\n```\n\n**Step 3:** Initialize `DocumentScannerCameraView` and implements `DocumentScannerEventListener`.\n```kotlin\nclass MainActivity : AppCompatActivity(), DocumentScannerEventListener {\n    val initializer = Initializer(this)\n\n    lateinit var documentScannerView: DocumentScannerCameraView\n\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n    }\n\n    @RequiresApi(Build.VERSION_CODES.N)\n    override fun onResume() {\n        super.onResume()\n        initializer.start {\n            runOnUiThread {\n                setContentView(R.layout.activity_main)\n                documentScannerView = findViewById(R.id.documentScannerView)\n                documentScannerView.addListener(this)\n                documentScannerView.setWhiteList(arrayListOf(ObjectDetectionObjectType.NATIONAL_ID_0.name))\n                documentScannerView.start()\n            }\n        }\n    }\n\n    override fun onInitialize() {\n        Log.d(TAG, \"onInitialize\")\n    }\n\n    override fun onFrame(frameStatus: FrameStatus) {\n        if (frameStatus != FrameStatus.PROCESSING) {\n            Log.d(TAG, \"onFrame: $frameStatus\")\n        }\n    }\n\n    override fun onDetection(detection: DocumentScannerResult) {\n        Log.d(TAG, \"onDetection\")\n    }\n}\n```\n\n## 3.2. Liveness Detection\n\n**Step 1:** Initialize `Initializer` class and called `initializer.start()` in onResume.\n```kotlin\nclass MainActivity : AppCompatActivity() {\n    val initializer = Initializer(this)\n\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n    }\n\n    @RequiresApi(Build.VERSION_CODES.N)\n    override fun onResume() {\n        super.onResume()\n        \n        // Start initializer here\n        initializer.start {\n            \n        }\n    }\n}\n```\n\n**Step 2:** Add DocumentScannerCameraView to your `layout.xml`\n```xml\n\n\u003ccom.ekycsolutions.ekycid.livenessDetection.LivenessDetectionCameraView\n      android:id=\"@+id/livenessDetectionCameraView\n      android:layout_width=\"match_parent\"\n      android:layout_height=\"match_parent\" /\u003e\n\n```\n\n**Step 3:** Initialize `LivenessDetectionCameraView` and implements `LivenessDetectionEventListener`.\n```kotlin\nclass MainActivity : AppCompatActivity(), LivenessDetectionEventListener {\n    val initializer = Initializer(this)\n\n    lateinit var livenessDetectionCameraView: LivenessDetectionCameraView\n\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n    }\n\n    @RequiresApi(Build.VERSION_CODES.N)\n    override fun onResume() {\n        super.onResume()\n        initializer.start {\n            runOnUiThread {\n                setContentView(R.layout.activity_main)\n                livenessDetectionCameraView = findViewById(R.id.documentScannerView)\n                livenessDetectionCameraView.addListener(this)\n                livenessDetectionCameraView.setOptions(\n                    LivenessDetectionOptions(\n                         arrayListOf(LivenessPrompt.LOOK_LEFT, LivenessPrompt.LOOK_RIGHT, LivenessPrompt.BLINKING)\n                    )\n                )\n                livenessDetectionCameraView.start()\n            }\n        }\n    }\n\n    override fun onInitialize() {\n        Log.d(TAG, \"onInitialize\")\n    }\n\n    override fun onFrame(frameStatus: FrameStatus) {\n        if (frameStatus != FrameStatus.PROCESSING) {\n            Log.d(TAG, \"onFrame: $frameStatus\")\n        }\n    }\n\n    override fun onPromptCompleted(completedPromptIndex: Int, success: Boolean: progress: Float) {\n        Log.d(TAG, \"onPromptCompleted\")\n    }\n    \n    override fun onAllPromptsCompleted(detection: LivenessDetectionResult) {\n        Log.d(TAG, \"onAllPromptsCompleted\")\n    }\n    \n    override fun onFocus() {\n        Log.d(TAG, \"onFocus\")\n    }\n    \n    override fun onFocusDropped() {\n        Log.d(TAG, \"onFocusDropped\")\n    }\n    \n    override fun onCountDownChanged(current: Int, max: Int) {\n        Log.d(TAG, \"onCountDownChanged\")\n    }\n}\n```\n\n## 3.3. Perform Face Compare and OCR\n\nTo perform face compare and ocr, you can call your server that integrated with our [NodeSDK]() to get face compare score and ocr response respectively.\n\n# 4. Contact\n\u003cp\u003eFor any other questions, feel free to contact us at \n  \u003ca href=\"https://ekycsolutions.com/\"\u003eekycsolutions.com\u003c/a\u003e\n\u003c/p\u003e\n\n# 5. License\n© 2022 EKYC Solutions Co, Ltd. All rights reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fekycsolutions%2Fekyc-id-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fekycsolutions%2Fekyc-id-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fekycsolutions%2Fekyc-id-android/lists"}