1. Account
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • Update Account
      PUT
    • Find Client
      POST
    • Accounts
      GET
    • Create Additional Account
      POST
    • Account Details By BVN
      GET
    • Get Client Addresses
      GET
    • Get Account Details
      GET
    • Get Account Summary
      GET
    • Client Images
      GET
    • Update BVN
      POST
    • Update Transaction Limit
      POST
  • KYC
    • Get KYC Info
      POST
    • Update KYC
      POST
    • Get KYC Level
      GET
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • InterBank Transfer Query
      GET
    • Transfer Details
      GET
    • IntraBank Transfer
      POST
    • Intrabank Transfer To Virtual Accounts
      POST
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Schemas
    • Client
    • Product
  1. Account

Update Account

PUT
/core/account
This endpoint updates the deteails of an account. The accounts are classified as either BUSINESS or PERSON

Request Body#

For PERSONAL Accounts:
Field NameTypeRequiredDescription
clientIdIntegertrueClient id of the existing account
clientTypestringtrueMust be set to PERSON for personal accounts.
firstnamestringtrueAccount opener's first name.
lastnamestringtrueAccount opener's last name.
emailstringtrueAccount opener's email address.
mobileNostringtrueAccount opener's mobile phone number.
bvnstringtrueAccount opener's Bank Verification Number (BVN).
ninstringfalseAccount opener's National Identity Number (NIN).
productIdintegertrueTransaction Point Product ID (e.g., Savings Account, Current Account).
For BUSINESS Accounts:
Field NameTypeRequiredDescription
clientIdIntegertrueClient id of the existing account
clientTypestringtrueMust be set to BUSINESS for business accounts.
dateOfBirthstringtrueClient's date of birth (format: DD-MM-YYYY).
fullNamestringtrueAccount opener's full name.
emailstringtrueAccount opener's email address.
mobileNostringtrueAccount opener's mobile phone number.
bvnstringtrueAccount opener's Bank Verification Number (BVN).
ninstringfalseAccount opener's National Identity Number (NIN).
productIdintegertrueTransaction Point Product ID (e.g., Savings Account, Current Account).

Response Body#

For PERSONAL Accounts:
Field NameTypeDescription
idintegerUnique identifier for the account record.
firstnamestringAccount opener's first name.
lastnamestringAccount opener's last name.
emailstringAccount opener's email address.
mobileNostringAccount opener's mobile phone number.
nubanstringGenerated NUBAN (bank account number).
productIdintegerTransaction Point Product ID (e.g., Savings Account, Current Account).
clientIdintegerUnique identifier for the client.
For BUSINESS Accounts:
Field NameTypeDescription
idintegerUnique identifier for the account record.
emailstringAccount opener's email address.
mobileNostringAccount opener's mobile phone number.
nubanstringGenerated NUBAN (bank account number).
productIdintegerTransaction Point Product ID (e.g., Savings Account, Current Account).
clientIdintegerUnique identifier for the client.
subLedgerActivatedbooleanIndicates whether the Sub Ledger Account has been activated for this account.

Request

Body Params application/json

Example
{
    "clientId":1851488,
    "clientType": "BUSINESS",
    "dateOfBirth": "01-01-1990",
    "fullName": "TPGateway Business",
    "email": "user1@gmail.com",
    "mobileNo": "373737999312",
    "bvn": "838121211122",
    "productId": 100
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/core/account' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientId":1851488,
    "clientType": "BUSINESS",
    "dateOfBirth": "01-01-1990",
    "fullName": "TPGateway Business",
    "email": "user1@gmail.com",
    "mobileNo": "373737999312",
    "bvn": "838121211122",
    "productId": 100
}'

Responses

🟢200PERSON
application/json
Bodyapplication/json

Examples
{
    "id": 69,
    "firstname": "Sample",
    "lastname": "Account 1",
    "email": "sampleaccount1@gmail.com",
    "mobileNo": "373737322",
    "nuban": "0000000355",
    "productId": 100,
    "clientId": 70
}
🟢200BUSINESS
Modified at 2026-06-09 11:37:19
Previous
Create Account
Next
Find Client
Built with