curl --request POST \
  --url https://api.nomba.com/v1/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",
  "pin": "2222"
}'
{
  "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-P2P-C24AD-a6443bf0-011c-4bc2-b739-4a2e33e2a27b",
    "type": "p2p",
    "status": "SUCCESS"
  }
}

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 /v1/transfers/bank

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.

senderName
string
required

The sender’s name.

senderName
string
required

PIN.

Response body

code
string
required

Response code

description
string
required

Response description

data
object

The transfer data.

amount
number
required

The transfer amount.

meta
string
required

The transaction meta data.

merchantTxRef
string

Merchant transaction reference.

api_client_id
string

API client ID.

api_account_id
string

API account ID.

rrn
string

RRN (Retrieval Reference Number).

fee
number
required

The transfer fee.

timeCreated
string
required

The creation timestamp.

id
string
required

The transfer ID.

type
string
required

The transaction type.

status
string
required

The transaction status.

curl --request POST \
  --url https://api.nomba.com/v1/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",
  "pin": "2222"
}'
{
  "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-P2P-C24AD-a6443bf0-011c-4bc2-b739-4a2e33e2a27b",
    "type": "p2p",
    "status": "SUCCESS"
  }
}