NGX-MONO

ngx-mono is an angular library to securely and quickly link bank accounts to Mono from within your app. It is built around Mono Connect.js. Mono Connect is a drop-in framework that handles connecting a financial institution to your app.

Visit Mono Docs for the detailed documentation.

REQUIREMENTS

Node 10 or higher

INSTALLATION

To install the latest version of ngx-mono, simply run the command

npm install --save ngx-mono

USAGE

1. Import the module

Import the library in your module:

import { NgxMonoModule } from 'ngx-mono'

2. Implement in your project

<ngx-mono
    [options]="options"
    (onSuccess)="onSuccess($event)"
>Connect</ngx-mono>

import { IMonoOptions } from 'ngx-mono'

  options:IMonoOptions = {
    key: <public_key>,
    data: {
      type: 'one-time-debit', // recurring-debit or one-time-debit
      amount: 150000, //amount in kobo
      description: "payment for light bill"
    }
  }

  onSuccess(data:any){
    console.log(data);
  }

OPTIONS

S/N	Option	Data Type	Required	Description
1	key	string	yes	The public key of your app. It can be gotten from the Mono dashboard.
2	reauthToken	string	no	This is only applicable to token re-authentication. Once this is present, a token re-authentication is initiated.
3	scope	string	no	This should be set to ‘payments’ when integrating to Direct Debit
4	data.type	string	no	Used when integrating to Direct Debit. Possible values are ‘one-time-debit’ and ‘recurring-debit’.
5	data.amount	integer	no	Amount to be debited in kobo.
6	data.description	string	no	Details of what payment is being made for.

CALLBACKS

	Callback	Required	Description
1	onSuccess	yes	Called after the successful onboarding of an account. It should take a single String argument containing the token that can be exchanged for an account id.
2	onLoad	no	Called when the widget has been mounted unto the DOM.
3	onClose	no	Called when a user has specifically exited the Mono Connect flow (i.e. the widget is not visible to the user). It does not take any arguments.
4	onEvent	no	Called when certain events in the Mono Connect flow have occurred, for example, when the user selected an institution. This enables your application to gain further insight into the Mono Connect onboarding flow.

EVENTS

Below are the possible events that can be raised by the onEvent callback:

Event Name	Description
OPENED	Triggered when the user opens the Connect Widget.
EXIT	Triggered when the user closes the Connect Widget.
INSTITUTION_SELECTED	Triggered when the user selects an institution.
AUTH_METHOD_SWITCHED	Triggered when the user changes authentication method from internet to mobile banking, or vice versa.
SUBMIT_CREDENTIALS	Triggered when the user presses Log in.
ACCOUNT_LINKED	Triggered when the user successfully links their account.
ACCOUNT_SELECTED	Triggered when the user selects a new account.
ERROR	Triggered when the widget reports an error.

SAMPLE SNIPPETS

1. Link Account

This is to link a user's account

<ngx-mono
    [options]="options"
    (onSuccess)="onSuccess($event)"
>Connect</ngx-mono>

import { IMonoOptions, IEventOptions } from 'ngx-mono';
 options:IMonoOptions = {
   key: '<public_key>'
 }
onSuccess(data:IEventOptions){
    console.log(data);
}

2. Reauthorization

<ngx-mono
    [options]="options"
    (onSuccess)="onSuccess($event)"
>Re-authorize</ngx-mono>

options:IMonoOptions = {
key: '<public_key>',
reauthToken: 'code_tPL0FVbsFuCqrBfMV4Vh'
}
onSuccess(data:IEventOptions){
    console.log(data);
}

3. Direct Debit

<ngx-mono
    [options]="options"
    (onSuccess)="onSuccess($event)"
>Direct debit</ngx-mono>

  options:IMonoOptions = {
    key: '<public_key>',
    scope: 'payments',
    data: {
       type: 'one-time-debit', // recurring-debit or one-time-debit
       amount: 150000, //amount in kobo
       description: "payment for electricity"
     }
  }

CONTRIBUTING

Please feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.

Star

I'd love you star this repo. Also follow me on twitter

License

The MIT License (MIT). Please see License File for more information.