Skip to main content

Perform bank transfers from the parent account

Perform bank transfers from the sub-account

​
POST /v2/transfers/bank

⚠️ Rate Limit Notice:
Users are restricted to 5 bank transfers to the same recipient per minute. 
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": "055472814",
    "accountName": "M.A Animashaun",
    "bankCode": "058",
    "merchantTxRef": "UNQ_123abGGhh5546",
    "senderName": "Nightly Post",
    "narration": "Nice One"
  }'

​
POST /v2/transfers/bank/{subAccountId}

If your usecase requires transferring funds from a specific sub-account, you can use the sub-account transfer endpoint. This is useful where you manage multiple balances or wallets under your main account. Sub-accounts can only be created from your Nomba dashboard.
📢 Feature Notice:
Sub-account transfers must be enabled by us before you can use this endpoint. 
curl --request POST \
  --url https://api.nomba.com/v2/transfers/bank/{subAccountId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
    "amount": 3500,
    "accountNumber": "055472814",
    "accountName": "M.A Animashaun",
    "bankCode": "058",
    "merchantTxRef": "UNQ_123abGGhh5546",
    "senderName": "Nightly Post",
    "narration": "Nice One"
  }'

​
Request body

​
amount
number
required
The amount to be transferred.
​
accountNumber
string
required
The destination bank account number.
​
accountName
string
required
The name on the account.
​
bankCode
string
required
The code of the recipient bank.
​
merchantTxRef
string
required

Unique reference used to track a transaction from an external process.

This is an idempotency key and must be unique per transaction. It cannot be reused once a transfer has been initiated.

​
senderName
string
required
The sender’s name.
​
narration
string
The narration for this transfer (NB: This will be appended to the normal system generated narration).

​
Response body

​
id
string
required
The transfer ID.
​
status
string
required
The transaction status.
​
type
string
required
The transaction type.
​
amount
number
required
The transfer amount.
​
fee
number
The transfer fee.
​
source
string
Payment source (e.g., “api”).
​
sourceUserId
string
The user who initiated the transfer.
​
customerBillerId
string
The biller account ID.
​
productId
string
Product code for the transfer.
​
meta
object
required
Additional transaction metadata.
​
userId
string
Associated user ID.
​
timeCreated
string
required
Creation timestamp.