---
title: "Payout to Bank in a supported Country."
method: POST
path: "/v0.2.4/payouts/bank"
tags: ["Payouts"]
---

# Payout to Bank in a supported Country.

`POST /v0.2.4/payouts/bank`

## Request body

- object
  - `subAccount` string — Subaccount (Wallet Account) to payout from, if any.
  - `turnOffNotification` boolean — disables email and other notifications from Chimoney.
  - `debitCurrency` string — Wallet Currency to debit from.
  - `banks` object[], required — Banks.
    - `countryToSend` string, required — Payout country.
    - `account_bank` string, required — Bank code.
    - `account_number` string, required — Recipient account number.
    - `valueInUSD` number — Payout value in USD.
    - `amount` number — Payout amount in specified currency. Defaults to valueInUSD.
    - `reference` string — Transaction reference.
    - `fullname` string — Full name of beneficiary. Required for all countries except Nigeria
    - `branch_code` string — branch_code from /info/bank-branches. Required for all countries except Nigeria
    - `narration` string — Narration/Description of payment to be included notification to user
    - `collectionPaymentIssueID` string — issue ID for the payment payout initiated.

## Response `200`

Success.

- object
  - `status` string — Status of the request.
  - `message` string — message of the request.
  - `data` object
    - `chimoneys` object[]
    - `payouts` object[]

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `403` — Access to this resource is forbidden.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/versions/227751df36a0/schema)