iOS React Wrapper

Integrate IDmission's IDentity SDK into your iOS React Native application.

Setup

  1. 1

    Set up the React Native development environment based on your development and target OS.

    Setting up the development environment →
  2. 2

    Download and unzip the React Native Resources archive. It contains the react-native, ios_code directories, and a Podfile.

    Download ReactNativeSDK2iOSResources →
  3. 3

    Create an empty React Native application.

    Shell
    npx @react-native-community/cli init IDMTest
  4. 4

    Add JavaScript code. Copy and paste the contents of the react-native folder into the main project folder. Overwrite files if required.

  5. 5

    Add React Native dependencies. In package.json, update the dependencies node with the following.

    JSON
    "dependencies": {
  "@react-native/new-app-screen": "0.83.1",
  "@react-navigation/native": "^7.1.28",
  "@react-navigation/native-stack": "^7.12.0",
  "@react-navigation/stack": "^7.7.1",
  "native-base": "^3.4.28",
  "react": "19.2.0",
  "react-dom": "^19.2.0",
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^1.9.0",
  "react-native-safe-area-context": "^5.6.2",
  "react-native-screens": "^4.23.0",
  "react-native-svg": "^15.15.3"
},
  6. 6

    Delete the node_modules folder, then rebuild the application.

    Shell
    npm install
  7. 7

    Set up pods. Navigate to the ios directory and uninstall the existing pods.

    Shell
    pod deintegrate

    Delete Podfile.lock and IDMTest.xcworkspace. Replace the Podfile with the one from the ReactNativeSDK2iOSResources archive, then install pods.

    Shell
    pod install
  8. 8

    Add iOS code. Review the permissions in the Info.plist file from ios_code and add any missing permissions to your project's Info.plist.

  9. 9

    Launch IDMTest.xcworkspace in Xcode.

  10. 10

    In the ios_code folder, rename YourProjectName-Bridging-Header.h to match your project name. Then drag and drop all files from ios_code into IDMTest in Xcode. In the popup, select Copy items if needed, Create groups, and the IDMTest target. When prompted, select Create Bridging Header.

  11. 11

    Navigate to Product → Scheme → Edit Scheme. Select the Run Action. Under the Info tab, set Build Configuration to Release. Uncheck the Debug Executable checkbox.

  12. 12

    Configure code signing. Select the target, then go to Signing & Capabilities. Add your Team and Provisioning Profile.

  13. 13

    Build and run the application from Xcode.

Available Functions

The following functions are available after initializing the SDK.

InitIDMissionSDK.initializeSDK

Initializes the SDK. Must be called before any other function.

JavaScript
IDMissionSDK.initializeSDK(String apiBaseUrl, String authUrl, String debug, String accessToken)
ServiceIDMissionSDK.serviceID20

Initiates the ID Validation (Service ID 20) flow.

JavaScript
IDMissionSDK.serviceID20()
ServiceIDMissionSDK.serviceID10

Initiates the ID Validation and Match Face (Service ID 10) flow.

JavaScript
IDMissionSDK.serviceID10()
ServiceIDMissionSDK.serviceID185

Initiates the Identify Customer (Service ID 185) flow.

JavaScript
IDMissionSDK.serviceID185()
ServiceIDMissionSDK.serviceID660

Initiates the Live Face Check (Service ID 660) flow.

JavaScript
IDMissionSDK.serviceID660()
ServiceIDMissionSDK.serviceID50

Initiates the ID Validation and Customer Enroll (Service ID 50) flow.

JavaScript
IDMissionSDK.serviceID50(String uniqueCustomerNumber)
ServiceIDMissionSDK.serviceID175

Initiates the Customer Enroll Biometrics (Service ID 175) flow.

JavaScript
IDMissionSDK.serviceID175(String uniqueCustomerNumber)
ServiceIDMissionSDK.serviceID105

Initiates the Customer Verification (Service ID 105) flow.

JavaScript
IDMissionSDK.serviceID105(String uniqueCustomerNumber)
SubmitIDMissionSDK.submitResult

Submits the form and finalizes the current service flow.

JavaScript
IDMissionSDK.submitResult()