Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.nomba.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
1

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": ""
    }
],
}
2

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"
    }
}
3

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"
    }
}