okra_widget 2.0.2-beta

Okra widget wrapper SDK, used to implement Okra widgets for both IOS and Android applications written in flutter.

okra_widget

This is an flutter library for implementing okra widget

Getting Started

This library would help you add Okra widget to your hybrid android/ios application in no time. All you need to do is ...

Install

To use this plugin, add okra_widget as a dependency in your pubspec.yaml file.

dependencies:
  okra_widget: ^2.0.2-beta

On iOS, opt-in to the embedded views preview by adding a boolean property to the app's Info.plist file with the key io.flutter.embedded_views_preview and the value true.

<dict>  
  <key>io.flutter.embedded_views_preview</key>
  <true/>  
</dict>

Usage

var banks = [
                    "ecobank-nigeria",
                    "fidelity-bank",
                    "first-bank-of-nigeria",
                    "first-city-monument-bank",
                    "guaranty-trust-bank",
                    "access-bank",
                    "unity-bank",
                    "alat",
                    "polaris-bank",
                    "stanbic-ibtc-bank",
                    "standard-chartered-bank",
                    "sterling-bank",
                    "union-bank-of-nigeria",
                    "united-bank-for-africa",
                    "wema-bank",
                    "rubies-bank",
                    "kuda-bank"
                  ];


                  var okraOptions = {
                    "key": "public key",
                    "token": "client token",
                    "products": [
                      "auth",
                      "balance",
                      "identity",
                      "transactions"
                    ],
                    "environment": "production",
                    "clientName": "Bassey",
                    "color" : "#9013FE",
                    "limit" : "3",
                    "isCorporate" : false,
                    "connectMessage" : "Which account do you want to connect with?",
                    "callback_url" : "",
                    "redirect_url" : "",
                    "logo" : "https://dash.okra.ng/static/media/okra-logo.514fd943.png",
                    "widget_success" : "Your account was successfully linked to SwipeNG",
                    "widget_failed" : "An unknown error occurred, please try again.",
                    "currency" : "NGN",
                    "noPeriodic" : true,
                    "exp" : "",
                    "success_title" : "null",
                    "success_message" : "null",
                    "guarantors" : {
                      "status": false,
                      "message": "Okra requires you to add guarantors",
                      "number": 3,
                    },
                    "filter" : {
                      "industry_type": "all",
                      "banks": banks
                    }
                  };

                  OkraHandler reply = await Okra.create(context, okraOptions);

OkraOptions

Name	Type	Required	Default Value	Description
isWebview	boolean	true	true
key	String	true	undefined	Your public key from Okra.
token	String	true	undefined	Your pubic Key from Okra dashboard. Use test key for test mode and live key for live mode
products	ArrayList<Enums.Product>	true	undefined	The Okra products you want to use with the widget.
env	Enums.Environment	true	undefined
clientName	String	true	undefined	Name of the customer using the widget on the application
webhook	String	true	undefined	The Url that Okra send the client's data to.

Data Dictionary

Auth

Field	Required	Description
id ObjectID	Yes	Unique Auth ID (Unique Okra Identifier)
validated Boolean	Yes	Customer authentication status
bank ObjectID	Yes	Unique Bank ID (Unique Okra Identifier)
customer ObjectID	Yes	Unique Customer ID (Unique Okra Identifier)
record ObjectID	Yes	Unique Record ID (Unique Okra Identifier)
owner ObjectID	Yes	Unique Company ID (Unique Okra Identifier) (Your Client Token)
created_at Object	Yes	Date Auth was fetched
last_updated Object	Yes	Last Date Auth was fetched

Balance

Field	Required	Description
id ObjectID	Yes	Unique Balance ID (Unique Okra Identifier)
available_balance Integer	Yes	Amount of available funds in account
ledger_balance Integer	Yes	Closing balance of account
currency String	Yes	The currency of the account
connected Boolean	Yes	Customer connection status (Did they choose to connect this account to you)
env String	Yes	Okra API Env the transaction was pulled from production or production-sandbox
bank ObjectID	Yes	Unique Bank ID (Unique Okra Identifier)
accounts ObjectID	Yes	Unique Account ID (Unique Okra Identifier)
customer ObjectID	Yes	Unique Customer ID (Unique Okra Identifier)
record Array of ObjectID	Yes	Unique Record ID (Unique Okra Identifier)
created_at Object	Yes	Date Balance was fetched
last_updated Object	Yes	Last Date Balance was fetched

Identity

Field	Required	Description
id ObjectID	Yes	Unique Identifier ID (Unique Okra Identifier)
firstname String	Yes	Customer First Name
middlename String	Yes	Customer Middle Name
lastname String	Yes	Customer Last Name
next_of_kins Identity Object	Yes	Customer Next of Kins
dob Date	Yes	Customer Date of Birth
verified String	Yes	BVN Validation status
score String	Yes	Unique Okra Score
dti String	Yes	Customer Debt to Income Score
fullname String	Yes	Customer Fullname
company_name String	**Yes	Company Name if Corporate Identity
nin String	Yes	Customer NIN Number
national_id String	Yes	Customer National ID Number
drivers_lisence String	Yes	Customer Driver's License Number
nimc String	Yes	Customer National Identity Management Commission (NIMC) Number
voters_id String	Yes	Customer Voter's ID Number
rc_number String	Yes	Company's Registered Company Number if Corporate Identity
phone Array of String	Yes	Customer Phone Number
last_login String	Yes	Customer Last Login via Okra
email Array of String	Yes	Customer Email address
address Array of String	Yes	Customer
mothers_maiden String	Yes	Customer Mother's Maiden Name
photo_ids Array of Object	Yes	Customer's photo ID
env String	Yes	Okra API Env the transaction was pulled from production or production-sandbox
bank ObjectID	Yes	Unique Bank ID (Unique Okra Identifier)
accounts ObjectID	Yes	Unique Account ID (Unique Okra Identifier)
customer ObjectID	Yes	Unique Customer ID (Unique Okra Identifier)
record Array of ObjectID	Yes	Unique Record ID (Unique Okra Identifier)
created_at Object	Yes	Date Balance was fetched
last_updated Object	Yes	Last Date Balance was fetched

Transaction

Field	Required	Description
id ObjectID	Yes	Unique Transaction ID (Unique Okra Identifier)
debit Integer	No	Amount deducted from account
credit Integer	No	Amount credited to account
trans_date Date	Yes	Date transaction occurred
cleared_date Date	Yes	Date transaction cleared at bank
unformatted_trans_date String	Yes	Date transaction occurred (from bank)
unformatted_cleared_date String	Yes	Date transaction cleared (from bank)
branch String	No	Branch transactions occurred
ref String	No	Bank reference ID (from bank)
env String	Yes	Okra API Env the transaction was pulled from production or production-sandbox
code String	No	Bank Code (from bank)
benefactor ObjectID	No	Customer ID of sender (within Okra)
code String	No	Bank Code (from bank)
notes Object	Yes	Breakdown of Narrative from bank
bank ObjectID	Yes	Unique Bank ID (Unique Okra Identifier)
account ObjectID	Yes	Unique Account ID (Unique Okra Identifier)
record Array of ObjectID	Yes	Unique Record ID (Unique Okra Identifier)
created_at Object	Yes	Date transactions was fetched
last_updated Object	Yes	Last Date transactions was fetched

Notes Data Dictionary

Field	Required	Description
desc String	Yes	Narrative / Description of transaction (combination of bank and user entered information)
topics Array of String	Yes	Topics within the desc
places Array of String	Yes	Places mentioned within the desc
people Array of String	Yes	People mentioned within the desc
actions Array of String	Yes	Actions mentioned within the desc
subject Array of String	Yes	Subject of the desc
preposition Array of String	Yes	Prepositions within desc to understand intent