---
title: "POST /payouts/create-bank-payout"
method: POST
path: "/payouts/create-bank-payout"
tags: ["Payouts", "Initiate"]
---

# POST /payouts/create-bank-payout

`POST /payouts/create-bank-payout`

## Request body

- object
  - `amount` number, required
  - `accountNumber` string, required
  - `accountName` string, required
  - `currency` 'TZS' | 'USD', required — Account currency to pay out from (TZS or USD)
  - `accountCurrency` 'TZS' — Receiving currency for the payout (TZS)
  - `orderReference` string, required — Your unique Order reference
  - `bic` string, required — Beneficiary bank BIC. You can fetch the list of bank BICs from the [banks list endpoint.](/api-reference/list/get-bank-list)
  - `transferType` 'ACH' | 'RTGS', required
  - `checksum` string — If enabled, this is the generated checksum of the payload. Refer to the [documentation](/home/checksum) for more details.

## Response `200`

Create bank payout response

- CreateBankPayoutResponse
  - `updatedAt` string, date-time
  - `createdAt` string, date-time
  - `id` string
  - `orderReference` string
  - `amount` string — Total amount deducted from your account balance (includes fee)
  - `currency` string
  - `fee` string — Transaction fee deducted from source currency (included in amount)
  - `exchanged` boolean — Indicates if currency conversion was applied (true when source currency differs from receiving currency)
  - `exchange` object — Exchange rate details (only present when exchanged is true)
    - `sourceCurrency` string — Source currency for the exchange
    - `targetCurrency` string — Target currency for the exchange
    - `sourceAmount` number — Amount in source currency
    - `rate` number — Exchange rate used for conversion
  - `status` 'AUTHORIZED' | 'SUCCESS' | 'REVERSED'
  - `channel` 'BANK TRANSFER'
  - `channelProvider` string
  - `transferType` 'ACH' | 'RTGS', nullable
  - `order` object
    - `amount` string — Amount added during order creation/payload
    - `currency` string
  - `beneficiary` object
    - `accountNumber` string
    - `accountName` string
  - `clientId` string — Application Client ID associated with the payout

## Other responses

- `400` — Validation Error
- `401` — Invalid or Expired Token
- `409` — Conflict Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/clickpesa/apis/core-api-openapi-specification.md) · [All operations](https://skmtc.dev/clickpesa/apis/core-api-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickpesa/core-api-openapi-specification/revisions/9f70f35c5590/schema)