Skip to main content

​
MTN Mobile Money (MoMo)

MTN_MOMO collects through MTN’s MoMo Collections API: a payment request is sent to the payer’s MoMo number, the payer approves it on their handset, and the request’s status is polled until it settles. The backend country catalog offers MTN MoMo in Uganda, Ghana, Côte d’Ivoire, Zambia, Benin, and Cameroon.
This version has no credential form for MTN MoMo. The gateway appears in the country catalog, but Settings → Payments renders no fields for it, so there is no supported way to enter or verify the credentials it needs.Do not select MTN MoMo for an account that is not already running on it. Choose PawaPay — which reaches MTN wallets in every one of those countries — or, in Ghana, Hubtel.If an existing account is already configured on MTN MoMo, contact support before changing anything; the values below cannot be re-entered through the interface once they are cleared.

​
What the integration needs

These are the values the backend requires. They are documented for support and upgrade planning — not as an instruction to set them another way. Requests go to https://momodeveloper.mtn.com in production and to https://sandbox.momodeveloper.mtn.com elsewhere.

​
How a payment would complete

1

Request

Centipid Billing authenticates with the API user and key, then posts a request-to-pay against the payer’s MoMo number with a unique reference id.
2

Authorization

The payer approves the request on their handset.
3

Confirmation

The reference id’s status is queried back from MTN. A successful status records the payment and applies the package; a failed one is stored with the reason MTN returned.

​
Troubleshooting

For the gateways that are configurable today, see Payment gateways, and for their fields, the credential reference.