---
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 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.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/revisions/227751df36a0/schema)