Create Sub Account (Corporate)

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

To create sub-account for corporate you are required to Initiate and Validate Identity of at least one director of the company 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 vID

Identification method the account holder, should be vID (Provided you have Validated the KYC of at least one director of the company).

identityId

string

required

The _id from the Safe Haven Verification Endpoint.

companyRegistrationNumber

string

required

Defaults to 1234567

The should be the company's RC or BN Number.

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
16
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": "vID",
10
  "companyRegistrationNumber": "1234567",
11
  "autoSweep": false,
12
  "autoSweepDetails": {
13
    "schedule": "Instant"
14
  }
15
}
16
'

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

application/json

200200

400400