---
title: "Mobile Money Collection"
method: POST
path: "/collections/momo"
---

# Mobile Money Collection

`POST /collections/momo`

This is for the momo collection for Kenya, Rwanda, Uganda and Ghana. The OTP object in the payload is an optional field, it's only needed when your business account isn't whitelisted for verifying phone numbers before collections, using the collection OTP endpoint. If you have a system in place to verify phone numbers in your app then reach out to us to whitelist your account so you can proceed to integrate this collection API without the need for a phone number verification endpoint(OTP collection)

## Request body

- object
  - `phone` string, required — Phone number in international format
  - `amount` integer, required — Amount as a number
  - `country` string, required — The country you are collecting from. Options are UG, KE, GH, RW, CM, CI, TZ
  - `currency` string, required — Currency you're collecting. Options are UGX, KES, GHS, RWF
  - `customer` string, json — An optional JSON object with customer information e.g. '{"email":"john@example.com"}'
  - `transactionRef` string — Optional unique alphanumeric string set by the client
  - `otp` object — A JSON object with pinId from Get Collection OTP and pin from customer e.g {"pinId":"132466gdfsfsrey1535", "pin":"123456"}. NB: This is an optional field
    - `pin` string, required
    - `pinId` string, required
  - `redirectUrl` string — This is required when your collection country is GH and currency is GHS. This is necessary so after phone number verification, it redirects the user back to your system after successful collection

## Response `200`

200

- object
  - `code` integer
  - `data` object
    - `transactionId` string
    - `transactionRef` string
    - `type` string
    - `currency` string
    - `amount` string
    - `customer` object
      - `email` string
    - `balanceBefore` unknown
    - `balanceAfter` unknown
    - `status` string
    - `createdAt` string
    - `updatedAt` string
  - `success` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.net/eversend/apis/authentication.md) · [All operations](https://skmtc.net/eversend/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eversend/authentication/revisions/7c1b8e2a0830/schema)
