Overview

Bank transfers form the backbone of modern financial services, enabling swift and secure movement of funds. You can initiate bank transfers effortlessly with our APIs. We prioritize the highest standards of security and compliance, ensuring your financial transactions are handled with the utmost care.

Quick Action

Bank account lookup

Use the Nomba API to do account lookups.

Perform bank transfer

Initiate account transfers with the Nomba API.

Perform account transfer

Initiate P2P transfers within Nomba.

To successfully execute bank transfers using our endpoints, it is necessary to undergo the following steps:

Fetch Banks

First get the bank code of the recepient using this endpoint.Request

curl --request GET \
    --url https://api.nomba.com/v1/transfers/bank \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --header 'accountId: <accountid>'

Response

{
"code": "00",
"description": "SUCCESS",
"message": "SUCCESS",
"status": true,
"data": [
    {
        "name": "First Bank of Nigeria",
        "code": "011",
        "nipCode": null,
        "logo": "https://firebasestorage.googleapis.com/v0/b/business-banking-93cc1.appspot.com/o/bankLogos%2FGroup%201.png?alt=media&token=06a3a300-dafe-49db-b3d3-049371bf1173"
    },
    {
        "name": "3LINE CARD MANAGEMENT LIMITED",
        "code": "110005",
        "nipCode": null,
        "logo": ""
    }
],
}

Perform a bank account lookup

Before initiating bank transfers, it’s advisable to inform your customers about the recipient. The bank account lookup endpoint requires an accountNumber and the associated bankCode (a unique code representing the bank) as input.Request

curl --request POST \
    --url https://api.nomba.com/v1/transfers/bank/lookup \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --header 'accountId: <accountid>' \
    --data '{
    "accountNumber": "3554772814",
    "bankCode": "011"
}'

Response

{
    "code": "00",
    "description": "Success",
    "data": {
        "accountNumber": "0554772814",
        "accountName": "M.A Animashaun"
    }
}

Perform a bank transfer

Initiate a bank transfer from Nomba to an external bank. This endpoint requires details such as the amount to be transferred, a merchantTxRef for later transaction reconciliation, as well as the recipient’s accountNumber and bankCode.Request

curl --request POST \
    --url https://api.nomba.com/v2/transfers/bank \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --header 'accountId: <accountid>' \
    --data '{
    "amount": 3500,
    "accountNumber": "3554772814",
    "accountName": "M.A Animashaun",
    "bankCode": "011",
    "merchantTxRef": "UNQ_123abGGhh5546",
    "senderName": "Nightly Post"
    }'

Response

{
    "code": "00",
    "description": "Success",
    "data": {
        "amount": 5502,
        "meta": {
        "merchantTxRef": "3JVW2xJCjj443oannREBuTaXDdji",
        "api_client_id": "6a7bed88-7c93-4a1c-a445-f88edbca6489",
        "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
        "rrn": "230908151711"
        },
        "fee": 50,
        "timeCreated": "2023-09-08T14:17:13.634Z",
        "id": "API-TRANSFER-C24AD-a6443bf0-011c-4bc2-b739-4a2e33e2a27b",
        "type": "transfer",
        "status": "SUCCESS"
    }
}

Introduction

Getting Started

Products

API Basics

Guides

Quick Action

Bank account lookup

Perform bank transfer

Perform account transfer

​Quick Action

Bank account lookup

Perform bank transfer

Perform account transfer

Quick Action