---
title: "Redeem mobile money."
method: POST
path: "/v0.2.4/redeem/mobile-money"
tags: ["Redeem"]
---

# Redeem mobile money.

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

## Request body

- object
  - `subAccount` string — Subaccount if any.
  - `chiRef` string, required — Chi reference.
  - `redeemOptions` object, required — Data needed to redeem.
    - `phoneNumber` string
    - `countryToSend` string
    - `momoCode` string

## Response `200`

Success.

- object
  - `status` string
  - `message` string
  - `data` object
    - `payoutLink` string
    - `error` string
    - `id` integer
    - `account_number` string
    - `bank_code` string
    - `full_name` string
    - `created_at` string
    - `currency` string
    - `debit_currency` string
    - `amount` number
    - `status` string
    - `reference` string
    - `meta` object[]
      - `Sender` string
      - `EmailAddress` string
      - `MobileNumber` string
      - `SenderCountry` string
      - `SenderIdType` string
      - `SenderIdNumber` string
    - `narration` string
    - `complete_message` string
    - `requires_approval` integer
    - `is_approved` integer
    - `bank_name` 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.
- `404` — Error indicating that the transaction was not found.
- `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)