Support & Feedback

General Reporting Guidelines

When reporting issues or bugs, please include the following details:

• SDK version and platform (React Native, Web, or Flutter)
• Platform version (React Native version, browser version, or Flutter/Dart version)
• Operating System (iOS/Android for mobile, browser for web)
• Steps to reproduce the issue, along with a minimal configuration payload
• Relevant logs (e.g., network errors, validation messages, debug output)
• Device/browser information

Common Issues (Cross-Platform)

1. Camera permissions: Ensure your app requests appropriate camera permissions for the target platform
2. Network connectivity: Verify internet connection for API communication
3. API keys: Confirm you're using the correct public key for your environment (sandbox vs production)
4. Platform-specific setup: Follow platform-specific installation and build instructions

React Native Specific Issues

• iOS build issues: Make sure to run pod install after installation
• Android permissions: Verify camera permissions in AndroidManifest.xml
• Metro bundler: Clear cache if experiencing import issues
• Webview integration: Ensure react-native-webview is properly installed and linked

Web Specific Issues

• Browser permissions: Handle camera permission prompts appropriately
• HTTPS requirement: Ensure your application is served over HTTPS for camera access
• Cross-browser compatibility: Test across different browsers
• Container element: Ensure target container element exists in DOM

Flutter Specific Issues

• Webview integration: Ensure webview_flutter plugin is properly configured
• Platform channels: Verify proper native bridge configuration
• Widget integration: Follow Flutter widget composition patterns
• Dart version compatibility: Verify Dart version requirements
• iOS/Android permissions: Configure camera permissions in native platform files

Universal Example Configuration

{
  publicKey: 'pk_test_xxxxx',
  user: {
    firstName: 'Test',
    email: '[email protected]'
  },
 debugMode: true,
  sandboxEnvironment: true
}

Platform Documentation Links

• React Native: https://github.com/korapay/kora-identity-react-native
• Web: https://github.com/korapay/identity-web-sdk
• Flutter: https://github.com/korapay/kora-identity-flutter-sdk-sdk