Create Account

This creates account for an already existing customer.

To create a new account you have to be sure the customer has already been created, then you build your complete endpoint by passing authtoken and version in create account url query params

You then make a post request by passing TransactionTrackingRef, ProductCode, HasSufficientInfoOnAccountInfo and some other required payload in the request body.

A successful request will return AccountNumber and a success message in the response.

We have a Production URL and Staging URL you are advised to use the staging during development.

Production URL

http://api.mybankone.com/BankOneWebAPI/api/Account/CreateAccount/{{version}}?authtoken={{your_authtoken}}

Staging URL

https://staging.mybankone.com/BankOneWebAPI/api/Account/CreateAccount/{{version}}?authtoken={{your_authtoken}}

Here is an example request with sample payload to the staging endpoint.

POST https://staging.mybankone.com/BankOneWebAPI/api/Account/CreateAccount

Path Parameters

Name	Type	Description
version*		Version for this API is 2
authtoken *	String	Authorization token for this request

Request Body

Name	Type	Description
TransactionTrackingRef*	String	A way to track that an account has already been created
AccountOpeningTrackingRef*	String	A tracking reference tied to the account
ProductCode*	String	Account unique product code
LastName*	String	Customer's last name
OtherNames	String	Customer's other name
BVN*	String	Customer's BVN
PhoneNo*	String	Customer's phone number
Gender	String	Customer's Gender
PlaceOfBirth	String	Customer's place of birth
DateOfBirth*	String	Customer's Date of birth in date time
Address*	String	Customer's Address
NationalIdentityNo*	String	Customer's NIN
NextOfKinPhoneNo*	String	Customer's Next of kin phone
NextOfKinName*	String	Customer's next of kin name
HasSufficientInfoOnAccountInfo*	Boolen	Checks if the account has sufficient information
AccountOfficerCode*	String	Gotten from API response GetAccountOfficer
AccountInformationSource	Int	How the customer got to know about the institution
Email*	String	Customer's Email
NotificationPreference	Int	Customer's preferred notification method
TransactionPermission	Int	Customer's transaction permission
AccountTier*	Int	Account tier
FirstName*	String	Customer's First name

200: OK

{
    "Payload": {
        "AccountNumber": "00550012000001820",
        "CustomerID": "001820",
        "FullName": "Odu David",
        "CreationMessage": null
    },
    "Errors": [],
    "HasErrors": false,
    "Code": 0,
    "Description": "SUCCESS",
    "IsSuccessful": true
}