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

Authorizations

Authorization
string
headerrequired

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId
string
required

The parent accountId of the business.

Path Parameters

accountId
string
required

The accountId to transfer from.

Body

application/json
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.

senderName
string
required

Sender name

Response

200 - application/json
code
string
required

Response Code

description
string
required

Response description

data
object
required

Transfer data

Perform bank account transfer from the parent accountPerform wallet transfer from the parent account