---
title: "Perform bank account transfer from the parent account"
method: POST
path: "/v2/transfers/bank"
tags: ["Transfers"]
---

# Perform bank account transfer from the parent account

`POST /v2/transfers/bank`

You can use this endpoint to perform bank account transfer.

## Headers

- `accountId` string, uuid, required

## Request body

- BankAccountTransferRequest — A structure representing an object required to post a bank account transfer.
  - `amount` number, double, 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.
  - `senderName` string — Sender name
  - `narration` string — The payment narration

## Response `200`

OK - your request was successful.

- object
  - `code` string, required — Response Code
  - `description` 'SUCCESS' | 'PROCESSING' | 'FAILED' | 'BAD_REQUEST' | 'INSUFFICIENT_BALANCE' | 'ACCOUNT_NOT_FOUND' | 'INVALID_TRANSACTION' | 'WALLET_NOT_FOUND' | 'BLACKLISTED', required — Response description
  - `message` string — Returned response message
  - `status` boolean — Response status
  - `data` BankAccountTransferResult, required — Transfer data
    - `amount` string, required — Amount to be transfer
    - `source` string — Trnsfer source could be web, api etc..
    - `sourceUserId` string — Source user ID
    - `customerBillerId` string — Customer biller ID
    - `productId` string — A unique number for the product
    - `meta` BankAccountTransferMetaObject, required — Transaction meta data
      - `api_rrn` string — API RRN
      - `narration` string — Transfer naration
      - `recipientName` string — Fund recipient name
      - `sender_name` string — Name of transfer initiator
      - `merchantTxRef` string — Merchant transaction reference
      - `api_client_id` string — API client ID
      - `currency` string — Currency code
      - `hooksEligible` string — Hooks eligible
      - `banking_entity_id` string — API account ID
      - `banking_entity_user_id` string — API account ID
      - `banking_entity_type` string — Bank entity type
      - `self_transaction` string — Self transaction
      - `transactionCategory` string — Family and Kids
      - `accountNumber` string — API account ID
      - `bankName` string — Recipient bank name
      - `bankCode` string — Bank code
      - `sessionId` string — Session ID
      - `user_referral_code` string — Referral code
      - `amount_charged` string — Amount charged
      - `paymentVendor` string — Paytment vendor type
      - `wallet_balance` string — Wallet balance
      - `wallet_currency` string — Currency code for the payment
      - `paymentVendorReference` string — Payment vendor reference
      - `agent_commission` string — Agent commision
      - `useV2Fulfilment` string — check fulfulment value
    - `fee` number, double, required — Transfer fee
    - `timeCreated` string, date-time, required — Creation timestamp
    - `id` string, required — Transfer ID
    - `type` 'withdrawal' | 'purchase' | 'transfer' | 'p2p' | 'online_checkout' | 'qrt_credit' | 'qrt_debit', required — Transaction type
    - `status` 'SUCCESS' | 'PENDING_BILLING', required — Transaction status

## Other responses

- `201` — Transfer is being processed — the final status will be delivered via webhook. Mark the transaction as pending and do not retry with a new reference.
- `400` — The request body sent by merchant did not pass the validation checks
- `401` — The access_token provided to access the resource is missing or invalid.
- `403` — The client does not have the permissions to access this resource
- `404` — The record that the client is trying to access does not exist.
- `429` — The client has maxed out the number of calls within a time period on this resource.
- `500` — Downstream system error.

---

[API](https://skmtc.net/nomba/apis/vendor-api.md) · [All operations](https://skmtc.net/nomba/apis/vendor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nomba/vendor-api/revisions/41727ac9be5f/schema)