---
title: "Payouts"
method: POST
path: "/api/b2b/fiat/payout"
---

# Payouts

`POST /api/b2b/fiat/payout`

This endpoint is a universal endpoint, below are schemas for different payouts such as mobile money or bank accounts and this endpoint allows you to payout to these destinations through this single endpoint.

## Request body

- object
  - `amount` integer, required
  - `currency` string, required
  - `country` string, required — ISO 3166-1 alpha-2 country code
  - `payoutMethod` object
    - `accountName` string, required — e.g Clark Kent
    - `accountNumber` string, required — 254712345678
    - `code` string — Might be required depending on the currency and destination. All bank payouts require the bank code which can be retrieved from the get banks api. For mobile money payouts, some currencies require a mobile operator code which can be retrieved from the mobile money providers api.
    - `businessNumber` string — Only applies for Mpesa paybill payouts
  - `destination` string, required — MoMo / Bank Account
  - `externalReference` string, required — A unique ID of your liking to reconcile transactions internally.
  - `externalAccountId` string
  - `debitCurrency` string — The wallet you want to be debited from. If missing, we will default to the currency passed.
  - `debitCountry` string — ISO 3166-1 alpha-2 country scope of the wallet being debited. Required when debitCurrency is different from currency and the debit wallet currency can exist in multiple country scopes, such as USD or XOF.

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `transactionId` string

## Other responses

- `400` — 400

---

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