Create Customer and Account

Overview

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.

🚧
This is a core API

Required Payload

Name	Data Type	Description	Mandatory/Optional
TransactionTrackingRef	String	A way to track that an account has already been created	Mandatory
AccountOpeningTrackingRef	String	A tracking reference tied to the account	Mandatory
ProductCode	String	Account unique product code	Mandatory
LastName	String	Customer's Last Name	Mandatory
OtherNames	String	Customer's Other Name	Mandatory
BVN	String	Customer's BVN	Optional
PhoneNo	String	Customer's Phone Number	Mandatory
Gender	String	Customer's Gender; Male - 0, Female 1	Mandatory
PlaceOfBirth	String	Customer's Place Of Birth	Optional
DateOfBirth	Date	Customer's Date Of Birth	Mandatory
Address	String	Customer's Address	Mandatory
NationalIdentityNo	String	Customer's National Identity Number(NIN)	Optional
NextOfKinPhoneNo	String	Customer's Next Of Kin phone number	Optional
NextOfKinName	String	Customer's Next Of Kin Name	Optional
ReferralPhoneNo	String	Number of who referred the customer	Optional
ReferralName	String	Name of who referred the customer	Optional
HasSufficientInfoOnAccountInfo	Boolean	Checks If Customer Has Sufficient Account Information	Optional
AccountInformationSource	Int	How the customer got to know about the institution	Optional
OtherAccountInformationSource	String	Customer's Other Account Information Source	Optional
AccountOfficerCode	String	Customer's Account Officer Code	Mandatory
Email	String	Customer's Email	Optional
NotificationPreference	String	Customer's preferred notification method	Mandatory
TransactionPermission	String	Customer's Transaction Permission	Mandatory
AccountTier	Int	Account Tier	Mandatory
CustomerImage	Base64	Customer's passport	Optional
IdentificationImage	Base64	Customer's identification image	Optional
CustomerSignature	Base64	Customer's signature	Optional

📘
NotificationPreference
Notification preference is how customers are notified on transactions
Account Transaction Notification preference
0=none
1=email
2=SMS
3=both email and SMS

📘
TransactionPermission
This refers to transaction access into the account.
Account Transaction Permission
0 = PostDebitAndCredit (This is the default if Null is passed)
1 = PostNoDebit

Expected Request

{
  TransactionTrackingRef: 'testaccount2',
  AccountOfficerCode: '001',
  AccountOpeningTrackingRef: 'testaccount2',
  ProductCode: 107,
  LastName: 'Image',
  OtherNames: 'Tester',
  BVN: '',
  PhoneNo: '08034345654',
  Gender: 0,
  PlaceOfBirth: '',
  DateOfBirth: '2001-10-05',
  Address: '',
  NationalIdentityNo: '',
  AccountInformationSource: 0,
  OtherAccountInformationSource: '' ,
  HasSufficientInfoOnAccountInfo: true,
  NextOfKinPhoneNo: '',
  NextOfKinName: '',
  ReferralPhoneNo: '',
  ReferralName: '',
  CustomerImage: '',
  CustomerSignature: '',
  IdentificationImage: '',
  NotificationPreference: 0,
  TransactionPermission: "0",
  AccountTier: 1
}

Expected Response

{
  IsSuccessful: true,
  Message: 'Individual Customer and account Created successfully.',
  TransactionTrackingRef: 'testaccount2,
}

If the request is successful, it returns a status code of 200 with a response body.

You can check out API reference to Create Customer and Account