Transfers

Perform bank account transfer from the sub account

Changed on Nov 3, 2026

You can use this endpoint to perform bank account transfer using a sub account. To use this, please reach out to us to profile you for sub account transfer.

post/v2/transfers/bank/{subAccountId}

Request

Base URL
https://api.nomba.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/nomba/apis/vendor-api/docs/v2/transfers/bank/:subAccountId/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

subAccountIdstring required

The sub accountId to transfer from.

Headers

accountIdstring uuid required

Example:890022ce-bae0-45c1-9b9d-ee7872e6ca27

The parent accountId of the business.

Request body

amountnumber double required

The amount to be transferred.

accountNumberstring required

The destination bank account number.

accountNamestring required

The name on the account.

bankCodestring required

The code of the recipient bank.

merchantTxRefstring required

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

This is an idempotency key and must be unique per transaction.

senderNamestring

Sender name

narrationstring

The payment narration

Example request

{
  "amount": 3500,
  "accountNumber": "0554772814",
  "accountName": "M.A Animashaun",
  "bankCode": "058",
  "merchantTxRef": "UNQ_123abGGhh5546",
  "senderName": "Nightly Post",
  "narration": "Testing Payment"
}

Response

OK - your request was successful.

code'200' | '201' | '400' | '401' | '403' | '429' | '500' required

Response code. This reflects the HTTP status code of the response, e.g. 200 when the request completed successfully and 201 when it was accepted and is still being processed.

descriptionstring required

Response description

Example response

{
  "code": "200",
  "description": "Success",
  "data": {
    "amount": "1.0",
    "source": "api",
    "sourceUserId": "11ec45a1-1fe5-44f5-8baf-cxxxxxxxxxx",
    "customerBillerId": "010784xxxx",
    "productId": "058",
    "meta": {
      "api_rrn": "2309081xxxxxx",
      "narration": "Testing",
      "recipientName": "John doe",
      "sender_name": "Nightly Post",
      "merchantTxRef": "3JVW2xJCjj443oannREBuTaXDdji",
      "api_client_id": "6a7bed88-7c93-4a1c-a445-f88edbca6489",
      "currency": "NGN",
      "hooksEligible": "true",
      "banking_entity_id": "842f2b4320f",
      "banking_entity_user_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
      "banking_entity_type": "9842f2b4320f",
      "self_transaction": "true",
      "transactionCategory": "128735648",
      "accountNumber": "0127667384",
      "bankName": "GTbank",
      "bankCode": "058",
      "user_referral_code": "HABI76745",
      "amount_charged": "21.0",
      "paymentVendor": "Wallet",
      "wallet_balance": "5.38",
      "wallet_currency": "NGN",
      "paymentVendorReference": "01a10aeb-d989-460a-bbde-9840f",
      "agent_commission": "0.0",
      "useV2Fulfilment": "true"
    },
    "fee": 50,
    "timeCreated": "2026-03-08T14:17:13.634Z",
    "id": "API-TRANSFER-C24AD-a6443bf0-011c-4bc2-b739-4a2e33e2a27b",
    "type": "transfer",
    "status": "SUCCESS"
  }
}

Changes

Nov 3, 2026278a25dccfe5 Revision changes
- warning
  added the new 200 enum value to the response property for the response status
- warning
  added the new 200 enum value to the response property for the response status
- warning
  added the new 201 enum value to the response property for the response status
- warning
  added the new 201 enum value to the response property for the response status
- warning
  added the new 400 enum value to the response property for the response status
- warning
  added the new 400 enum value to the response property for the response status
- warning
  added the new 401 enum value to the response property for the response status
- warning
  added the new 401 enum value to the response property for the response status
- warning
  added the new 403 enum value to the response property for the response status
- warning
  added the new 403 enum value to the response property for the response status
- warning
  added the new 429 enum value to the response property for the response status
- warning
  added the new 429 enum value to the response property for the response status
- warning
  added the new 500 enum value to the response property for the response status
- warning
  added the new 500 enum value to the response property for the response status

Operation history