iOS, Android & React Native

Wrapper แบบเนทีฟสำหรับ iOS (Swift / Objective-C), Android (Kotlin / Java) และ React Native จะเปิด WebView เต็มจอที่รัน engine ตัวเดียวกับ Web SDK จากหน้าที่เราโฮสต์ไว้ การถ่ายจึงทำงานเหมือนกันทุกแพลตฟอร์ม และเมื่อ engine ปรับปรุง แอปของคุณจะได้ใช้โดยไม่ต้องออกเวอร์ชันใหม่ ตอนแอปทำงานต้องมีกล้อง และต่ออินเทอร์เน็ตไปที่ https://iapp.co.th/sdk/webview.html ได้

ทุก wrapper มี flow ชุดเดียวกัน:

• documentCapture ถ่ายเอกสารอัตโนมัติแล้วส่งเข้า OCR (บัตรประชาชน, หนังสือเดินทาง, บัตรราชการ) 0.75–1.25 IC
• activeLiveness ให้ผู้ใช้ทำท่าทางของ Face Active Liveness และคืนผลตัดสินที่เซิร์ฟเวอร์ลงนามรับรอง 1 IC
• faceCapture ถ่ายเซลฟี่หน้าตรงที่คมชัดโดยไม่ต้องทำท่าทาง สำหรับ Face Verification หรือ Passive Liveness ไม่มีค่าใช้จ่าย (ถ่ายภาพอย่างเดียว)

ติดตั้งและเปิด flow

iOS

1. ต้องใช้ iOS 15 ขึ้นไป และมี NSCameraUsageDescription ใน Info.plist
2. ใน Xcode เลือก File → Add Package Dependencies… ใส่ https://github.com/iapp-technology/iapp-ekyc-sdk แล้วเพิ่ม product IappEkyc
3. เปิด flow แล้วจัดการผลลัพธ์

import IappEkyc

let config = IappEkycConfig(apiKey: "YOUR_API_KEY", flow: .documentCapture)
config.documentType = .thaiIdFront   // .thaiIdBack .passport .thaiDriverLicense .bookBank .thaiIdWithSignature
config.locale = .th                  // .en / .th / .zh

IappEkycSdk.present(from: self, config: config) { result in
    switch result {
    case .success(let outcome):
        print(outcome.document?.rawJSON ?? [:])          // ผลลัพธ์ OCR เต็มรูปแบบ
    case .failure(let error as NSError)
    where error.code == IappEkycErrorCode.cancelled.rawValue:
        break                                            // ผู้ใช้ยกเลิก
    case .failure(let error):
        print(error.localizedDescription)                // error.code: IappEkycErrorCode
    }
}

Active liveness คืนผลตัดสินที่เซิร์ฟเวอร์ลงนามรับรอง:

let config = IappEkycConfig(apiKey: "YOUR_API_KEY", flow: .activeLiveness)
IappEkycSdk.present(from: self, config: config) { result in
    if case .success(let outcome) = result, let liveness = outcome.liveness {
        // ตรวจสอบ verdictJSON + ลายเซ็นบนแบ็กเอนด์ของคุณ — อย่าเชื่อถือ
        // `passed` เพียงอย่างเดียวบนอุปกรณ์
        upload(liveness.verdictJSON, liveness.signature, liveness.selfieImageData)
    }
}

Objective-C ใช้คลาสเดียวกันผ่าน delegate:

@import IappEkyc;

IappEkycConfig *config = [[IappEkycConfig alloc] initWithApiKey:@"YOUR_API_KEY"
                                                           flow:IappEkycFlowTypeDocumentCapture];
config.documentType = IappEkycDocumentTypeThaiIdFront;
[IappEkycSdk presentFrom:self config:config delegate:self];
// Implement IappEkycViewControllerDelegate: didFinishWithResult / didFailWithError / didCancel

Android

1. ต้องใช้ minSdk 24 และ Android System WebView เวอร์ชันล่าสุด (แนะนำ Chrome/WebView ≥ 100)
2. เพิ่ม JitPack และ dependency
3. ลงทะเบียน contract แล้วเปิด flow ใดก็ได้ ไลบรารีประกาศสิทธิ์ CAMERA และขอสิทธิ์ตอนแอปทำงานให้เอง

// settings.gradle.kts
dependencyResolutionManagement {
    repositories { google(); mavenCentral(); maven("https://jitpack.io") }
}
// app/build.gradle.kts
dependencies { implementation("com.github.iapp-technology:iapp-ekyc-sdk:v0.2.0") }

val config = IappEkycConfig.Builder("YOUR_API_KEY").locale(EkycLocale.TH).build()

private val ekyc = registerForActivityResult(IappEkycContract()) { result ->
    when (result) {
        is IappEkycResult.DocumentCaptured -> handleOcr(result.rawJson)
        is IappEkycResult.LivenessPassed ->
            // ตรวจสอบ verdictJson + ลายเซ็นบนแบ็กเอนด์ของคุณ
            upload(result.verdictJson, result.signature, result.selfieImage)
        is IappEkycResult.FaceCaptured -> useSelfie(result.image)
        is IappEkycResult.Failed -> show(result.error)   // error.code: EkycErrorCode
        IappEkycResult.Cancelled -> {}
    }
}

// เริ่มต้น Flow ใดก็ได้:
ekyc.launch(IappEkycRequest.DocumentCapture(config, EkycDocumentType.THAI_ID_FRONT))
ekyc.launch(IappEkycRequest.ActiveLiveness(config))
ekyc.launch(IappEkycRequest.FaceCapture(config))

Java ใช้ callback API:

IappEkyc.start(this,
        new IappEkycRequest.DocumentCapture(config, EkycDocumentType.THAI_ID_FRONT),
        new IappEkycCallback() {
            @Override public void onResult(IappEkycResult result) { /* ... */ }
            @Override public void onError(IappEkycError error) { /* ... */ }
            @Override public void onCancelled() { }
        });

React Native

1. ต้องใช้ React Native ≥ 0.72 และ react-native-webview ≥ 13.6 แพ็กเกจยังไม่ได้เผยแพร่บน npm จึงติดตั้งจาก repo ที่ clone มา
2. iOS: เพิ่ม NSCameraUsageDescription ส่วน Android: เพิ่มสิทธิ์ CAMERA และขอสิทธิ์ก่อน mount flow
3. แสดง IappEkycFlow ใน Modal แบบเต็มจอ

git clone https://github.com/iapp-technology/iapp-ekyc-sdk
npm install ./iapp-ekyc-sdk/react-native react-native-webview
cd ios && pod install

import { useState } from 'react';
import { Button, Modal, PermissionsAndroid, Platform } from 'react-native';
import { IappEkycFlow } from '@iapp-technology/react-native-ekyc-sdk';

function KycScreen() {
  const [active, setActive] = useState(false);

  const start = async () => {
    if (Platform.OS === 'android') {
      const granted = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.CAMERA);
      if (granted !== PermissionsAndroid.RESULTS.GRANTED) return;
    }
    setActive(true);
  };

  return (
    <>
      <Button title="Capture Thai ID" onPress={start} />
      <Modal visible={active} animationType="slide" presentationStyle="fullScreen">
        <IappEkycFlow
          flow="documentCapture"        // 'documentCapture' | 'activeLiveness' | 'faceCapture'
          documentType="thaiIdFront"
          apiKey="YOUR_API_KEY"
          locale="th"
          onResult={(result) => { setActive(false); console.log(result); }}
          onError={(error) => setActive(false)}     // error.code, e.g. 'INSUFFICIENT_CREDIT'
          onCancel={() => setActive(false)}
        />
      </Modal>
    </>
  );
}

สิ่งที่เหมือนกันทุกแพลตฟอร์ม

• API key: ส่ง apiKey: "" และตั้ง baseUrl เป็น backend ของคุณเอง เพื่อเก็บ key ไว้ฝั่งเซิร์ฟเวอร์ key จะถูกส่งเข้าหน้า bridge หลังโหลดเสร็จ ไม่ผ่าน URL SECURITY.md
• ธีมและภาษา: ใช้ token และ locale en / th / zh ชุดเดียวกับ Web SDK ตั้งผ่าน config object ของแต่ละแพลตฟอร์ม
• ผลตัดสิน liveness: ผลที่เซิร์ฟเวอร์ลงนามรับรองเท่านั้นที่ยืนยันว่าผ่าน ให้คำนวณ HMAC ใหม่บน backend ของคุณก่อนเชื่อค่า passed ดู Face Active Liveness
• การยกเลิก: ปุ่ม Cancel ใน flow, ปุ่มย้อนกลับของ Android และการปัดปิดบน iOS จะคืนผลเป็นการยกเลิกเหมือนกัน ส่วนการปิดหรือ unmount flow จะยุติการทำงานอย่างเรียบร้อย
• โปรโตคอล bridge: สัญญาระหว่าง wrapper กับ engine ฉบับเต็มอยู่ใน WEBVIEW_BRIDGE.md