GuidesAPI ReferenceHelp CenterStatus PageBlogGet API Keys

Account Holder

Learn how to create and manage an account holder.

Suggest Edits

Overview

An Account-Holder resource must exist before a virtual account, a virtual card or bank account issuing operation can occur. It represents an individual or business entity, which is required to get a bank account, virtual account or virtual card.

There are three types of account holders that can be created and managed, which are:

  1. Individual Account holder.
  2. Business Account holder.
  3. International Account holder.

Individual Account Holder

To get started with an individual account holder, you must provide the first name, last name, address, BVN, phone number and specify the entity to an Individual. Other optional fields include the email and the address of the individual or customer.

📘

Quick Note on Identity

a. For NGA Account holders, NIN, Int'l Passport or Driver's license are accepted.
b. For Int'l Account holders, only Int'l passport is accepted.

N.B: If your user has only their Driver's license as an identity type, dob.date is required to be passed.

API Reference ➡

curl --location --request POST 'https://api.withmono.com/issuing/v1/accountholders' \
--data-raw '{
    "first_name": "ifeoluwa", 
    "last_name": "olanipekun",
    "bvn": "00000000",
    "phone": "2348209840585",
    "entity": "INDIVIDUAL",
    "email": "[email protected]", //optional
    "address": {
        "address_line1": "12 banana island",
        "lga": "lag",
        "city": "lagos",
        "state": "lagos"
    }, // optional
    "dob": {
        "date": "22-10-1991" // the format is dd-mm-yyyy e.g 01-12-1960
    }, // required only if the identity type is a DRIVERS_LICENSE
    "identity": {
        "type": "INTERNATIONAL_PASSPORT",
        "number": "00000000"
    }
}'

{
  "status": "success",
  "message": "Account holder created successfully",
  "data": {
    "id": "61a73645c2d313658ce82d44"
  }
}

Business Account Holder

To create a business account holder, you're required to provide the first name, last name, address, BVN, phone number, identity (i.e. Identity type and number), business details (i.e. business type, industry type, CAC ID, company name & registration date) and the entity specified to Business.

📘

Note

Kindly note that the first name, last name, identity and BVN information, must be a director/shareholder of the business details been provided for.

API Reference ➡

curl --request POST \
     --url https://api.withmono.com/issuing/v1/accountholders \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'mono-sec-key: live_sk_sdqyu123712wy12' \
     --data '
{
     "entity": "BUSINESS",
     "first_name": "ifeoluwa",
     "last_name": "olanipekun",
     "bvn": "00000000",
     "phone": "2348209840585",
     "email": "[email protected]", // optional
     "identity": {
          "type": "NIN",
          "number": "452521423121"
     },
     "business_details": {
          "business_type": "limited_company",
          "industry_type": "education",
          "rc_number": "2312312",
          "company_name": "Bison PLC",
          "registration_date": "10-12-2005"
     },
    "address": {
          "address_line1": "12 banana island",
          "lga": "lag",
          "city": "lagos",
          "state": "lagos"
    } // optional
}
'

{
  "status": "success",
  "message": "Account holder created successfully",
  "data": {
    "id": "61a73645c2d313658ce82d44"
  }
}

International Account Holder

Account holders based in Ghana, Kenya, South Africa, Uganda, and Rwanda now have access to our Issuing service to obtain virtual cards. For account holders based in these countries, you are required to pass in the country field (if not, the country will default to NGA); the identification type, number and URL (n.b only INTERNATIONAL_PASSPORT is valid to use as an id type, not NIN) and the INDIVIDUAL sent to the entity type. Please note that BVN is not required.

API Reference ➡

curl --request POST \
     --url https://api.withmono.com/issuing/v1/accountholders \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'mono-sec-key: live_sk_sdqyu123712wy12' \
     --data '
{
    "entity": "INDIVIDUAL",
    "first_name": "adjo",
    "last_name": "olanipekun",
    "country": "GHA", // new field
    "phone": "0302786749",
    "address": {
        "address_line1": "No 7. Intex Street, Lagos Town",
        "lga": "Takoradi",
        "city": "West Tanokrom",
        "state": "Takoradi"
    },// required
    "identity": {
        "type": "INTERNATIONAL_PASSPORT",
        "number": "A01212321",
        "url": "https://my.passport.org/1112122"
    } // required
}
'

{
  "status": "success",
  "message": "Account holder created successfully",
  "data": {
    "id": "61a73645c2d313658ce82d44"
  }
}

🚧

Quick Note

  1. All businesses with account holders based outside Nigeria are required to sign an indemnity agreement.
  2. Businesses yet to sign the agreement will not have access to create account holders outside of Nigeria.

Updated 4 months ago