Create Customer and Account

This creates a customer and the customer account

This is a Core API

To create a customer and account you need to first build the complete create customer and account endpoint by passing authtoken and version to the url query params.

Then you make a post request to the complete create customer and account endpoint 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/CreateCustomerAndAccount/{{version}}?authtoken={{your_authtoken}}

Staging URL

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

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

POST http://staging.mybankone.com/BankOneWebAPI/api/Account/CreateCustomerAndAccount

Path Parameters

Name	Type	Description
version*	String	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
PlaceOfBirth	String	Customer's Place Of Birth
Gender	String	Customer's Gender
DateOfBirth	String	Customer's Date Of Birth
Address	String	Customer's Address
NationalIdentityNo*	String	Customer's National Identity Number
NextOfKinPhoneNo	String	Customer's Next Of Kin Number
NextOfKinName	String	Customer's Next Of Kin Name
ReferralPhoneNo	String	Number of who referred the customer
ReferralName	String	Name of who referred the customer
HasSufficientInfoOnAccountInfo*	Boolean	Checks If Customer Has Sufficient Account Information
AccountInformationSource	Int	How the customer got to know about the institution
OtherAccountInformationSource	String	Customer's Other Account Information Source
AccountOfficerCode	String	Customer's Account Officer Code
Email*	String	Customer's Email
NotificationPreference	String	Customer's preferred notification method
TransactionPermission	String	Customer's Transaction Permission
AccountTier	Int	Account Tier

200: OK

{
    "Payload": {
        "AccountNumber": "00550012000001820",
        "CustomerID": "001820",
        "FullName": "Odu David",
        "CreationMessage": "Account has already been created."
    },
    "Errors": [],
    "HasErrors": false,
    "Code": 0,
    "Description": "SUCCESS",
    "IsSuccessful": true
}