Widget Properties

📘

Not a developer?

Check out the Okra App Builder for a no-code way to get started with Okra's Widget and API.

Here's a breakdown of all the Okra Widget properties you can use to customize your widget. To use these options in your app you must first integrate an Okra Widget.

Name

Description

Default Value

token
ObjectId

The Client Token associated with your account; available from the Dashboard.

none

key
String

The key associated with your account; available from the Dashboard.

none

clientName
String

Displayed on the User Agreement and once a user has successfully linked their Record.

'This Client'

env
String

The Okra API environment on which to create user accounts. Use production-sandbox for Sandbox and for Production, use production.

Note: all Production requests apart from the 100 Records on our Startup Plan are billed.

production or production-sandbox

countries
Array

Countries to support. Will show banks from this country

['NG']

Please contact [email protected] for access to our ZA, and KY (South Africa and Kenya) banks.

products
Array

A list of Okra products you wish to use.

['auth', 'balance', 'identity']

Valid products are: transactions, auth, identity, balance, payments and income. Only banks that support all requested products will be shown.

In Production, you will be billed for each product that you specify when initializing the Okra Widget.

Example: ['auth', 'transactions']. Auth is free and automatically selected as users must be authenticated before accessing other products.

source
String

The integration type you are using. Options Include:

android
ios
rn-ios
rn-android
ionic
wordpress
vue
flutter
integration
laravel
react

link

mode
String

Widget background color

Options Include:
primary - Primary Color
light - Light transparent
dark - Dark transparent

primary

callback_url
String

Specify a callback to associate with a Record. Okra fires a callback when the Record requires updated credentials, when new data is available, or when Auth numbers have been successfully verified.

none

redirect_url
String

Specify a callback to associate with a Record. Okra fires a callback when the Record requires updated credentials, when new data is available, or when Auth numbers have been successfully verified.

none

color
String

Color theme on the widget

#3AB795

logo
String

Your App or Company logo

Okra's Logo

options
Object

You can pass a object custom values to the widget, view Special Widget Options below

none

enableAutoConnect
Boolean**

Allow users to automatically connect their accounts. This will automatically connect all accounts your customer has at the bank they are connecting with.

false

debitLater
Boolean

Authenticate users for debit access at a later date.

false

debitType
String

Choose whether to debit user on a recurring basis or one-time

Options Include:
one-time
recurring
garnish

'one-time'

showBalance
Boolean

Allow users to see their account balance

false

enhancedBalance
Boolean

See your your users enhanced balance (point in time balance) at every transaction line

false

selfie
Boolean

Allow users verify their identity with selfies to determine if the person holding device is the same person verifying their account.

See more information on Selfie's here

false

geoLocation
Boolean

See your users transaction location

false

continue_cta
String

The message on the button when a user completes linking

Continue

link_again
Boolean

Allow user's the ability to quickly return to the bank search screen and link another account.

true

manual
Boolean

Allow users login by entering their NUBAN and a unique identifier of your choice e.g. BVN

false

manalType

Unique identifier to check NUBAN against. This is to minimize fraud around NUBAN only identity verification

Options Include:
bvn
dob
email
phone

bvn

manualUpload
Boolean

Allow users to upload a bank statement that will be analyzed via OCR and available on your Okra dashboard.

manual must be true to use

false

ussd
Boolean

Allow users login with USSD

You must be using a compatible Android SDK that supports USSD.

false

success_title
String

Landing Page Success Title

You've successfully linked to Okra!

success_message
String

Landing page success page

With your bank account linked, you would be able to access the best financial services & products.

widget_success
String

Customize the messages your users see when they successfully link their bank accounts to your app.

'You successfully linked your account to clientName'

widget_failed
String

Customize what your users see if the widget fails.

'Uh oh, an error occurred'

currency
String

Okra Wallet to Charge from

NGN

identity_type
String

Unique Customer Identifier

BVN

limit
Number

Statement length (3-24)

24

corporate
Boolean

Should only display corporate bank's as well

Options Include:
null - Show both Ind & Corp
true - Show only Corp
false - Show only Ind

null

institutions
Array

The banks you would like to display to your user's, the remaining will be searchable

min of 4

      'first-bank-of-nigeria',
      'united-bank-for-africa',
      'guaranty-trust-bank',
      'access-bank',
      'zenith-bank',
      'diamond-bank',
      'stanbic-ibtc-bank',
      'first-city-monument-bank'
    ]```

geoLocation
Boolean

Access your customer's transaction locations

false

filter
Object

Filter the banks you would like to show users. If nothing is sent all will be available.

E.g.

{filter: {banks: [...bank-slugs...]}}

none

noPeriodic
Boolean

When true we will always pull all transactions from the user once (when Transactions is used as a product) once from the customer. on subsequent pulls (or when transactions is not used) we will not pull any.

isWebview
Boolean

Set true if launching OkraJS within a WebView.

false

connectMessage
Boolean****

Customize the messages your users see when they are about to connect their accounts.

e.g. 'Select your Salary Account'

'Select your account to connect'


What's Next
Did this page help you?