Skip to main content

Perform wallet transfers from the parent account

The movement of funds between accounts, commonly known as P2P, refers to the internal transfer of funds within the network. This direct transfer bypasses external processors, ensuring rapid and efficient handling solely by Nomba.

​
POST /v2/transfers/wallet

curl --request POST \
  --url https://api.nomba.com/v2/transfers/wallet \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
    "amount": 3500,
    "receiverAccountId": "890022ce-bae0-45c1-9b9d-ee7872e6ca27",
    "merchantTxRef": "UNQ_123abGGhh5546",
    "narration": "Nice one"
  }'

​
Request body

​
amount
number
required
The amount to be transferred.
​
receiverAccountId
string
required
The receiver’s accountId.
​
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

​
code
string
required
Response code
​
description
string
required
Response description
​
data
object
The transfer data.