Create Sub Account (Individual)

post https://api.sandbox.safehavenmfb.com/accounts/v2/subaccount

Sub-Accounts can be termed as reserved or static accounts, i.e virtual accounts which does not expires. For creating virtual accounts that expire after a certain period, you'll want to look into the "Virtual Accounts" section. To create sub-account you are required to Initiate Identity Verification using the Safe Haven Identity Verification endpoint.

To create sub-account you are required to Initiate Identity Verification using the Safe Haven Identity Verification endpoint.

Body Params

phoneNumber

string

required

Defaults to +2348032187654

This is the phone number of the account holder. It should begin with the country code.

emailAddress

string

required

Defaults to john.doe@mail.ng

This is the email address.

externalReference

string

required

This is an external reference to be attached to the account object.

identityType

string

required

Defaults to BVN

Identification method the account holder, should be either NIN, vNIN, BVN, BVNUSSD, or vID (if you are using Safe Haven Verification Service)).

identityNumber

string

It is required when using BVN, NIN, and BVNUSSD. Not required if you are using vID

identityId

string

The _id from the Safe Haven Verification Endpoint. It is required when vID, BVN, or NIN

otp

string

The OTP sent to the customer's phone number when you initiate verification using Safe Haven verification endpoint. This works for BVN and NIN or the OTP sent to customer's phone number when using BVNUSSD

callbackUrl

string

If not provided, the webhook URL on your Dashboard will be used.

autoSweep

boolean

Defaults to false

This should be set when creating a virtual account. It determines if auto sweep should be enabled or disabled.

autoSweepDetails

object

This contains the auto sweep details to be filled if creating a virtual account.

Headers

ClientID

string

required

This is your 'ibs_client_id' returned in the response when you generate an api token

Responses

Language

Credentials

OAuth2


xxxxxxxxxx
15
1
curl --request POST \
2
     --url https://api.sandbox.safehavenmfb.com/accounts/v2/subaccount \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "phoneNumber": "+2348032187654",
8
  "emailAddress": "john.doe@mail.ng",
9
  "identityType": "BVN",
10
  "autoSweep": false,
11
  "autoSweepDetails": {
12
    "schedule": "Instant"
13
  }
14
}
15
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400