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
      • Client Notifications
        PUT
      • Activate Client Account
        POST
      • Add Client Address
        POST
      • Update Client Address
        PUT
      • Get Full Account Details
        GET
      • Get Full Account Details By NUBAN
        GET
      • Upload Client Passport
        POST
      • Update NIN
        POST
      • Create Client
        POST
      • Get Directors
        GET
      • Create Directors
        POST
      • Update Directors
        PUT
      • Delete Director
        DELETE
      • Get Genders
        GET
      • Get Signatories
        GET
      • Create Signatories
        POST
      • Delete Signatory
        DELETE
      • Get Template
        GET
    • KYC
      • Get KYC Info
      • Update KYC
      • Get KYC Level
      • Auto Verify KYC
      • Get KYC Comparison Details
      • Face Comparison
      • Get KYC Info
      • Get KYC Settings
      • Get KYC Info
      • Create Face Liveness Session
      • Get KYC Log Details
      • Get KYC Logs
      • Set KYC Level
      • Set KYC Log Status
    • Transaction
      • Payment Types
      • Debit Account
      • Credit Account
      • Transaction History
      • Transaction Details [Legacy]
      • Transaction Details
      • Get All Transactions
    • Transfer
      • Interbank Transfer
        • Get Institutions
        • Name Inquiry
        • Interbank Transfer
        • InterBank Transfer Query
        • Transfer Details
        • Bulk Interbank Transfer
      • Intrabank Transfer
        • IntraBank Transfer
        • Intrabank Transfer To Virtual Accounts
        • Query Intrabank Transfer Status
        • Intrabank Transfer To Virtual Accounts
        • Query Intrabank Transfer To Virtual Account Status
    • Account Restrictions
      • Block Debit
      • Unblock Debit
      • Hold Amount
      • Release Amount
      • Block Account
      • Block Account Credits
      • Unblock Account
      • Unblock Account Credits
    • Reporting
      • Report Types
      • Get Report Parameters
      • Create Report
      • Report Details
      • Get Reports
    • Organisation
      • Get Address Types
      • Get Offices
      • Get States
    • Schemas
      • Client
      • Product
      • ClientNotificationsRequest
      • ClientNotificationsResponse
      • ErrorDetail
      • ErrorResponse
      • ValidationErrorResponse

    Authentication

    Overview#

    The Core Banking API uses OAuth 2.0 Client Authentication to ensure secure access and protect customer data. This authentication method allows authorized applications to interact with the API while preventing unauthorized access.
    OAuth 2.0 provides a robust, token-based authentication mechanism that enables secure communication between clients and the banking system without exposing sensitive credentials.

    Authentication Flow#

    The OAuth 2.0 authentication process follows these steps:

    1. Credentials#

    Before accessing the API, developers must obtain the following from the financial institution:
    1.
    Client ID
    2.
    Client Secret Key
    3.
    Host URL
    4.
    Token URL
    To request these credentials, contact the financial institution.

    2. Token Request#

    A POST request must be sent to the token URL to obtain an access token. Below is an example of a token request.



    3. Token Response#

    If authentication is successful, the API returns an Access Token, which is required for subsequent requests.
    The token has an expiration time, after which a new token must be requested.



    4. Authorized Requests#

    Once an OAuth 2.0 access token is obtained, it must be included in API requests to authenticate and authorize access to protected resources. The Authorization header in the request must contain the access token in the Bearer Token format.

    Modified at 2026-06-17 08:30:00
    Previous
    Webhooks
    Next
    Product List
    Built with