---
title: "Mobile Money Charge"
method: POST
path: "/api/b2b/fiat/deposit/momo"
---

# Mobile Money Charge

`POST /api/b2b/fiat/deposit/momo`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/fiat/deposit/momo`
- Auth: API key in header `Authorization`

Initiates a mobile money charge request for transactions. Charge initiation is asynchronous. A pending transaction may later report stepRequired: "ussd" via webhook or Get Transaction, with stepMetadata.ussdCode, an optional description, and optional expiry in Unix milliseconds. The customer dials the returned code and completes the prompts on their phone. No OTP validation or USSD confirmation request is required. Confirm final payment status before fulfillment.

## Request body

- object
  - `amount` integer, required
  - `phoneNumber` string: In ISO Format - '+' example: 254719624551
  - `currency` string, required
  - `externalReference` string, required: A unique ID of your liking to reconcile transactions internally.
  - `momoOperatorId` string: Some currencies require operator specification. This can be retrieved from the mobile money operators list found under here: https://docs.honeycoin.app/docs/mobile-money-operators
  - `otpCode` string: One-time payment code required by some operators before charge initiation. Follow the operator-specific customer instructions for the market you are collecting in and pass the generated code here.
  - `externalAccountId` string: Used to pass the information of an existing external account. See external accounts.
  - `walletCurrency` string: The currency to settle funds into. Defaults to currency.
  - `voucherPin` string: Required for Botswana (BWP) ott voucher charhes
  - `successRedirectUrl` string, uri: Optional URL to return the customer to after a successful payment redirect, where supported.
  - `failureRedirectUrl` string, uri: Optional URL to return the customer to after a failed payment redirect, where supported.
  - `walletCountry` string: Settlement wallet country. Required whenever walletCurrency is XOF. Optional otherwise, including USD. Send a two-letter country code; surrounding whitespace is trimmed and letters are uppercased.

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `transactionId` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `fcb58b0ef441`: 3 breaking, 2 info
  - added `subschema #1, subschema #2` to the request body `allOf` list
  - added the pattern `^https?://` to the request property `failureRedirectUrl`
  - added the pattern `^https?://` to the request property `successRedirectUrl`
  - added the new optional request property `walletCountry`
  - …1 more

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/fiat/deposit/momo/post.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)