---
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

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

## 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.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)