oneapp_sdk – Flutter Integration Guide

The OneApp Cobranding SDK provides secure mobile authentication, payments, device binding, user profile access, wallet balance inquiry, TPIN management, and more.

This SDK is designed for FinTech, Payments, and Wallet applications.


Important Note

Our company will provide the Organization ID and Secret Key to integrate this SDK.
Without these values, the SDK will not function.

  • Always call modesetup() first before any SDK action.
  • Do not call SDK methods without a valid BuildContext.
  • Organization credentials are required from the company.
  • SDK handles permission dialogs automatically.

Installation

Add this to your pubspec.yaml:

dependencies:
  oneapp_sdk:
    path: ./oneapp_sdk   # OR use git/path based on your setup

Import package:

import 'package:oneapp_sdk/oneapp_sdk.dart';

Android Setup

Add required permissions in your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>

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

<uses-permission android:name="android.permission.SEND_SMS"/>
<uses-permission android:name="android.permission.READ_SMS"/>

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

The SDK automatically requests these permissions when needed.


Initialize OneApp SDK

Call modesetup() before using any other SDK method.

bool status = await OneAppSdk.modesetup(
  context,
  "TEST",          // or "LIVE"
  "ORG_ID",        // Provided by company
  "SECRET_KEY",    // Provided by company
  "9999999999",    // User Mobile Number
  "TOKEN_HERE",    // Token from your backend
  false,           // isRegistration
  Colors.green,    // optional theme color
);

if (status) {
}

Runtime Permissions

SDK automatically handles required permissions:

  • Location
  • Camera
  • SMS
  • Phone

If the user permanently denies a permission, the SDK automatically shows an Open Settings dialog.


🌎 Environment Modes

Mode Description
TEST QA environment
LIVE Production environment

Use the correct ORG_ID and SECRET_KEY provided by the company.


🎨 Theme Customization

You can customize the SDK theme color:

OneAppSdk.modesetup(context, "TEST", ORG_ID, KEY, number, token, false, Colors.blue);

Libraries

bank_transfer/controller/BeneficiaryListViewController
bank_transfer/controller/BenificiaryAddIFSCController
bank_transfer/controller/BenificiaryAddIMMIDontroller
bank_transfer/controller/RecentTranController
bank_transfer/controller/SendMonyBankController
bank_transfer/model/BankListModel
bank_transfer/model/BankTransferIfscMmidModel
bank_transfer/model/BeneficiaryListModel
bank_transfer/model/BenificiaryAddIFSCModel
bank_transfer/model/FundLimitCheckModel
bank_transfer/model/IFSCDetailModel
bank_transfer/model/IMPSChargesModel
bank_transfer/model/RecentTransModel
bank_transfer/model/ValidatePaymentModel
bank_transfer/view/AccountValidationModel
bank_transfer/view/addbeneficiary_ifsc_screen
bank_transfer/view/addbeneficiary_mmid_screen
bank_transfer/view/AddedBenificiaryModel
bank_transfer/view/bank_transfer_screen
bank_transfer/view/BankMasterListScreen
bank_transfer/view/CustomTpinDialog
bank_transfer/view/recentransaction_screen
bank_transfer/view/SndMnyToBnkScreen
bank_transfer/view/tpinimps_screen
changeTpin/ChangeTPINController
changeTpin/ChangeTPinScreen
changeTpin/CreateTPINController
changeTpin/CreateTPINScreen
changeTpin/GenerateOTPModel
changeTpin/TpinOtpSreen
changeTpin/TpinSettings
changeTpin/TPINVerifyOtpController
common/apiservices
common/authrepository
common/ColorTheme
common/constants
common/kglobal
common/loadingscreen
common/ProgressDialog
common/sdk_theme
common/sdkapiservice
common/TranslatableText
common/url
createTpin/createTPIN
ExpenseManagement/CitizenInfoCell
ExpenseManagement/controller/CoupanHomeController
ExpenseManagement/controller/CoupanTransactionController
ExpenseManagement/CoupanHomeScreen
ExpenseManagement/CoupanTransactionDetail
ExpenseManagement/CoupanTransactionHistory
ExpenseManagement/ExpenseMainScreen
ExpenseManagement/model/CoupanTransModel
ExpenseManagement/model/WalletModel
model/AddmoneyModel
model/loginmodel
model/ncmcgetcardstatusmodel
model/TaPayBankListModel
model/TaPayInsertionModel
model/UserDataModel
model/userdatamodel
oneapp_sdk
payment/balanceenquirymodel
payment/BalanceEnquiryResult
payment/paymentscreen
payment/tpin_controller
payment/verifytpinmodel
profile/profileviewmodel
profile/ProfileViewResult
profile/UpdateProfileModel
profile/userdatamodel
registartion/devicebinding
registartion/Devicebindinggeneratemodel
registartion/model/AadhaarResponse
registartion/model/CreateTPINModel
registartion/model/GenerateOTPModel
registartion/model/RegistrationCompletion
registartion/model/RegistrationResult
registartion/model/RegOTPModel
registartion/model/RegValidateOTP
registartion/model/resendOTPModel
registartion/model/validatemobilenumbermodel
registartion/personaldetails
registartion/RegistrationVerifyTpin
registartion/RegistrationWithMobileNumber
registartion/review
registartion/TapaySDKContainer
registartion/ValidateMobResult
registartion/verifyotpcontroller
Rupay/apply_physical_card/RupayPhysicalCard
Rupay/block_unblock/controller/BlockCardPermanenetController
Rupay/block_unblock/controller/BlockUnblockController
Rupay/block_unblock/model/BlockUnblockModel
Rupay/block_unblock/model/BlockUnblockResModel
Rupay/block_unblock/view/BlockCardPermanentScreen
Rupay/block_unblock/view/BlockUnblockScreen
Rupay/consent/controller/RupayConsentController
Rupay/consent/model/RuPayCardGenerationResModel
Rupay/consent/model/RupaySecQuestionModel
Rupay/consent/view/RupayConsentScreen
Rupay/consent/view/SecurityQuestionScreen
Rupay/CustomPwdDialog
Rupay/CustomTpinDialog
Rupay/faq/FAQScreen
Rupay/GetVendorModel
Rupay/home/controller/RupayHomeController
Rupay/home/controller/UnblockCardOTPController
Rupay/home/model/GenerateCardPINResModel
Rupay/home/model/RuPayCardStatusResModel
Rupay/home/model/UnblockRupayCardModel
Rupay/home/model/ViewCardResModel
Rupay/home/view/RupayHomeScreen
Rupay/home/view/UnblockCardOTPScreen
Rupay/manage_pin/controller/ForgotPinController
Rupay/manage_pin/controller/ForgotPinOtpController
Rupay/manage_pin/controller/ManagePinController
Rupay/manage_pin/view/ForgotPinOtpScreen
Rupay/manage_pin/view/ForgotPinScreen
Rupay/manage_pin/view/ManagePINScreen
Rupay/MySingleton
Rupay/reportFruad/ReportFraudModel/ReportFraudModel
Rupay/reportFruad/reportfraudviewcontroller/FraudViewController
Rupay/reportFruad/ReportFruadScreen
Rupay/reportissue/ReportIssueScreen
Rupay/reportissue/reportviewmodel/FeedbackResponse
Rupay/reportissue/reportviewmodel/ReportViewController
Rupay/trans_limit/controller/ChangeTransLimitController
Rupay/trans_limit/model/RupayEncryption3DESModel
Rupay/trans_limit/model/RuPayTransactionLimitUpdateModel
Rupay/trans_limit/view/ChangeTransLimitScreen
Rupay/trans_limit/view/TransactionLimitScreen
Rupay/transactionHistory/RupayTransactionController
Rupay/transactionHistory/RupayTransactionDetail
Rupay/transactionHistory/RupayTransactionHistory
Rupay/transactionHistory/RupayTransModel
tapay/cardlistmodel
tapay/checkfundLimitModel
tapay/CoBrandingPGCreditRes
tapay/getcardinfomodel
tapay/savecardmodel
tapay/tapaybanklist
tapay/tapayscreen
tapay/tapaywebview
tapay_sdk_method_channel
tapay_sdk_platform_interface
TransactionHistroy/MiniStatement
TransactionHistroy/MiniStatementModel
TransactionHistroy/MiniStatementViewController
TransactionHistroy/StatementCell