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 Account

This creates account for an already existing customer.

PreviousAccount APINextAccount Enquiry

Last updated 3 years ago

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

Staging URL

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

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