@seontechnologies/seon-react-native-orchestration

React Native wrapper for the SEON Orchestration SDK, providing identity verification flows for iOS and Android. Built as a Turbo Module with backward compatibility for both Old and New React Native architectures.

Installation

React Native

npm install @seontechnologies/seon-react-native-orchestration
# or
yarn add @seontechnologies/seon-react-native-orchestration

For iOS, install the pods:

cd ios && pod install

Expo

npx expo install @seontechnologies/seon-react-native-orchestration

Add the config plugin to your app.json:

{
  "expo": {
    "plugins": [
      "@seontechnologies/seon-react-native-orchestration"
    ]
  }
}

Then run npx expo prebuild to generate native projects.

Quick Start

import { initialize, startVerification, SeonVerificationStatus } from '@seontechnologies/seon-react-native-orchestration';

// 1. Initialize the SDK
await initialize({
  baseUrl: 'https://your-api-endpoint.com',
  token: 'your-auth-token',
  language: 'en', // optional
});

// 2. Start the verification flow
const result = await startVerification();

switch (result.status) {
  case SeonVerificationStatus.completedSuccess:
    console.log('Verification passed!');
    break;
  case SeonVerificationStatus.completedFailed:
    console.log('Verification failed.');
    break;
  case SeonVerificationStatus.interruptedByUser:
    console.log('User cancelled.');
    break;
  case SeonVerificationStatus.error:
    console.log('Error:', result.errorMessage);
    break;
}

With Custom Theme

The theme parameter accepts a JSON string to customize the verification UI. Refer to the SEON workflow initialization docs for the full theme schema.

await initialize({
  baseUrl: 'https://your-api-endpoint.com',
  token: 'your-auth-token',
  language: 'en',
  theme: JSON.stringify({ /* your theme config */ }),
});

API Overview

| Function | Description | |----------|-------------| | initialize(config) | Initialize the SEON SDK with base URL, token, and optional language/theme | | startVerification() | Present the verification UI and return the result |

| Type | Description | |------|-------------| | SeonConfig | Configuration object for initialize() | | SeonVerificationResult | Result object from startVerification() | | SeonVerificationStatus | Enum of all possible verification outcomes | | SeonErrorCode | Enum of error codes thrown by the SDK |

For detailed documentation, see the Documentation Site.

Expo Config Plugin

Customize permission strings via plugin props:

{
  "expo": {
    "plugins": [
      [
        "@seontechnologies/seon-react-native-orchestration",
        {
          "cameraPermission": "We need camera access for identity verification",
          "microphonePermission": "We need microphone access for verification",
          "photoLibraryPermission": "We need photo library access for verification",
          "locationPermission": "We need location for fraud prevention (optional)"
        }
      ]
    ]
  }
}

Permissions

The SEON SDK requires camera, microphone, and storage permissions. Location is optional (only if your workflow uses geolocation-based fraud detection).

Expo: The config plugin handles this automatically (see above).

React Native: The library's Android manifest auto-merges the required permissions and hardware features. For iOS, add these to your Info.plist.

If your workflow uses geolocation-based fraud detection, also add ACCESS_FINE_LOCATION (Android) and NSLocationWhenInUseUsageDescription (iOS).

<key>NSCameraUsageDescription</key>
<string>Required for ID verification and selfie capture</string>
<key>NSMicrophoneUsageDescription</key>
<string>Required for video liveness checks</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Required for proof of address document upload</string>

Platform Requirements

| Platform | Minimum Version | |----------|----------------| | iOS | 13.0+ | | Android | SDK 26+ (Android 8.0) | | React Native | 0.71+ |

Documentation

Full documentation is available in the docs/ directory (powered by Mintlify):

• Getting Started -- Installation, quick start, and Expo setup
• API Reference -- initialize(), startVerification(), types, and enums
• Guides -- Architecture, platform notes, and testing
• Troubleshooting -- Common issues and solutions

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT

Made with create-react-native-library