AppZone API Documentation
  • Overview
    • Welcome
    • Getting Started
    • Enterprise User Oauth
  • Account
    • Account API
      • Create Account
      • Account Enquiry
      • Freeze Account
      • Unfreeze Account
      • Check Freeze Status
      • Place Lien on Account
      • Remove Lien on Account
      • Check Lien Status
      • Activate Post-No-Debit on Account
      • Deactivate Post-No-Debit on Account
      • Check Post-No-Debit Status
      • Retrieve BVN Details
      • Create Customer and Account
      • Update Account Tier2
      • Get Bank One Balance Enquiry
      • Generate Account Statement
      • Get Active Savings Accounts by CustomerID
      • Search Transactions
      • Get Transactions
  • Customer
    • Customer API
      • Create Customer
      • Update Customer
      • Get Customer by Account Number
  • Loans
    • Loan API
      • Get Loans By Customer Id
      • Get Loan Repayment Schedule
      • Loan Creation Application 2
      • Get Loan Account Balance 2
  • Account Officer
  • Standing Order
    • Standing Order API
      • Standing Order Creation Application2
      • Get Standing Orders By Debit Account Number
      • Cancel Standing Order
  • Fixed Deposit
    • Fixed Deposits API
      • Create Fixed Deposit Account
      • Get Fixed Deposit Account By Account Number
      • Get Fixed Deposit Account By Liquidation Account
      • Get Fixed Deposit Account By Phone Number
  • Transfers
    • Transfer API
      • Name Enquiry
      • Intra Bank (Local) Fund Transfer
      • Intra Bank Transfer
  • Cards
    • Cards API
      • Retrieve Institution Configurations
      • Card Request
      • Get Customer Cards
      • Hotlist Customer Card
      • Check Card Generation Status
      • Link Card to Customer Account
      • Freeze Cards
      • Unfreeze Cards
      • Add Transaction Limit to Customer Card
      • View Transaction Limit on Customer Card
      • Update Transaction Limit on Customer Card
      • Disable channel for customer card
      • Get Card Delivery Options
      • Re-Enable Channel for Customer Card
  • Overdraft
    • Overdraft API
      • Create Overdraft
      • Get Overdraft Interests
      • Get Overdraft Fees
  • Transactions
    • Transactions API
      • Transaction Status Confirmation
      • Credit Customer Account
      • Debit Customer Account
      • Reversals
  • Bills Payment
    • Bills Payment API
      • Get Commercial Bank
      • Get Billers
      • Get Billers Category
      • Get Payment Items
      • Initiate Bills Payment Transaction
  • Messaging
    • Save Bulk SMS
    • Save Email
Powered by GitBook
On this page
  1. Account
  2. Account API

Create Customer and Account

This creates a customer and the customer account

PreviousRetrieve BVN DetailsNextUpdate Account Tier2

Last updated 3 years ago

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

Staging URL

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

{
    "Payload": {
        "AccountNumber": "00550012000001820",
        "CustomerID": "001820",
        "FullName": "Odu David",
        "CreationMessage": "Account has already been created."
    },
    "Errors": [],
    "HasErrors": false,
    "Code": 0,
    "Description": "SUCCESS",
    "IsSuccessful": true
}
http://api.mybankone.com/BankOneWebAPI/api/Account/CreateCustomerAndAccount/{{version}}?authtoken={{your_authtoken}}
http://staging.mybankone.com/BankOneWebAPI/api/Account/CreateCustomerAndAccount/{{version}}?authtoken={{your_authtoken}}