---
title: "POST /payout/send-funds"
method: POST
path: "/payout/send-funds"
tags: ["PAYOUTS"]
---

# POST /payout/send-funds

`POST /payout/send-funds`

## Headers

- `public-key` string, required
- `x-api-version` number, required
- `Accept-Language` 'en' | 'fr' | 'sw', required
- `secret-key` string, required

## Request body

- IPayoutRequestDTO
  - `merchant_reference` string, required — The unique reference for this request. It must be at least 8 characters long.
  - `transaction_method` 'BANK' | 'MOBILE_MONEY', required — The transaction method to be used.
  - `currency` string, required — The 3-character ISO currency code for the request currency.
  - `amount` number, required — The amount being requested
  - `provider_code` string, required — The provider code as obtained from the payment options
  - `account_number` string, required — The bank account or mobile money number of the recipient.
  - `customer_name` string, required — The name of the customer.
  - `description` string, required — The description/narration for the transaction. Between 10-30 characters
  - `extra_params` PayoutExtraParamsDto
    - `bank_code` string, required
    - `branch_code` string
    - `beneficiary_address` string
    - `beneficiary_country` string
    - `address_city` string
    - `swift_code` string

## Response `202`

Payout initiated successfully.

- IPayoutResponseDto
  - `code` number, required — HTTP Status code
  - `status` 'success' | 'accepted' | 'error', required — The status of the response
  - `message` string, required — The message of the response
  - `data` object, required — Response data

## Other responses

- `400` — The request is invalid
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — An error occurred while processing the request

---

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