---
title: "Payout Mobile Money (Momo)."
method: POST
path: "/v0.2.4/payouts/mobile-money"
tags: ["Payouts"]
---

# Payout Mobile Money (Momo).

`POST /v0.2.4/payouts/mobile-money`

## Request

- Base URL: `https://api.chimoney.io`
- URL: `https://api.chimoney.io/v0.2.4/payouts/mobile-money`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/chimoney/apis/chimoney-api-docs/docs/v0.2.4/payouts/mobile-money/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `subAccount` string: Subaccount (Wallet Account) to payout from, if any.
  - `turnOffNotification` boolean: disables email and other notifications from Chimoney.
  - `momos` object[], required: Mobile Money.
    - `countryToSend` string, required: Payout country.
    - `phoneNumber` string, required: Recipient phone Number.
    - `valueInUSD` number, required: Payout value in USD.
    - `reference` string: Transaction reference.
    - `momoCode` string, required: Mobile money code.
    - `narration` string: Narration/Description of payment to be included notification to user
    - `collectionPaymentIssueID` string: issue ID for the payment payout initiated.
    - `senderIdType` string: The sender's ID document type (See Info section for Identfication Types)
    - `senderIdNumber` string: This is the number found on the sender's identification document.

## Response `200`

Success.

- object
  - `status` string: Status of the request.
  - `message` string: Message describing the outcome.
  - `data` object
    - `chimoneys` object[]
    - `payouts` object[]
    - `data` object[]
    - `paymentLink` string
    - `error` string

## 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.dev/chimoney/apis/chimoney-api-docs.md) - [All operations](https://skmtc.dev/chimoney/apis/chimoney-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/chimoney/apis/chimoney-api-docs/revisions/227751df36a0?raw)