Simplifin Flutter ONDC SDK

Official Flutter SDK for Mutual Fund Distribution via Simplifin on ONDC.

This SDK provides a secure, in-app WebView flow to complete ONDC investor onboarding and related workflows.


Installation

Add the dependency in your pubspec.yaml:

dependencies:
  simplifin_flutter_sdk: ^1.0.0

Run:

flutter pub get

Usage

import 'package:simplifin_flutter_sdk/simplifin_flutter_sdk.dart';

SimplifinOndcSdk(
  clientAuthToken: "<SDK_ACCESS_TOKEN>",
  accessToken: "<LOGIN_TOKEN>",
  domainName: "domain-name",
  userEmail: "user@example.com",
  phoneNumber: "9999999999",
  name: "User Name",
  webviewUrl: "https://domain-name",
  onSuccess: (data) {
    print("ONDC flow completed successfully");
  },
  onError: (error) {
    print(error.message);
  },
  onClose: () {
    Navigator.pop(context);
  },
);

Note:
clientAuthToken is issued by Simplifin to identify and authorize the SDK client. accessToken Represents the authenticated end user session.

Unauthorized domains or invalid tokens will be rejected automatically by the SDK.

UI Requirements

This widget should be rendered inside a full-screen page or modal to ensure a seamless onboarding experience.

File and image uploads

WebView file inputs (KYC photos, documents) require host-app permissions.

iOS — add to ios/Runner/Info.plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>Needed to upload photos during onboarding</string>
<key>NSCameraUsageDescription</key>
<string>Needed to capture photos during onboarding</string>
<key>NSMicrophoneUsageDescription</key>
<string>Needed if video capture is used during onboarding</string>

Android — add to android/app/src/main/AndroidManifest.xml if camera or gallery capture is used:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

License

This SDK is proprietary software licensed by Mindfinness Enterprises Private Limited.

Use of this SDK is restricted to authorized partners only and is governed by the terms of the accompanying Proprietary SDK License Agreement.