v1

latestOpenAPI 3.1.02026-07-24620123.6 KB

Mobile Money Charge

Initiates a mobile money charge request for transactions.

post/api/b2b/fiat/deposit/momo

Request body

amountinteger required

phoneNumberstring required

In ISO Format - '+' example: 254719624551

currencystring required

externalReferencestring required

A unique ID of your liking to reconcile transactions internally.

momoOperatorIdstring

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

otpCodestring

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.

externalAccountIdstring

Used to pass the information of an existing external account. See external accounts.

walletCurrencystring

The currency to settle funds into. Defaults to currency.

voucherPinstring

Required for Botswana (BWP) ott voucher charhes

successRedirectUrlstring uri

Optional URL to return the customer to after a successful provider-hosted redirect, where supported.

failureRedirectUrlstring uri

Optional URL to return the customer to after a failed provider-hosted redirect, where supported.

Response

200

successboolean

messagestring

transactionIdstring

Example response

{
  "success": true,
  "message": "Initiated request.",
  "transactionId": "123456789"
}