Go Live

Prerequisites

First, submit your KYC forms to MTN here

Client APP credentials.

In production, client application credentials are managed through the partner portal.

Client APP ID

Also called; API User ID, appUser, X-Reference-Id

MOMO_COLLECTION_ID="..."

Client APP Secret

Also called; apiKey

MOMO_COLLECTION_SECRET="..."

Product Key

Also called; Subscription Key

MOMO_COLLECTION_SUBSCRIPTION_KEY="..."

Callback URI

Also called; providerCallbackHost

MOMO_COLLECTION_REDIRECT_URI="..."

Other credentials

Environment

Also called; targetEnvironment

- MOMO_ENVIRONMENT="sandbox"
+ MOMO_ENVIRONMENT="mtnuganda"

Base URI

- MOMO_API_BASE_URI="https://sandbox.momodeveloper.mtn.com/"
+ MOMO_API_BASE_URI="https://ericssonbasicapi1.azure-api.net/"

Currency

- MOMO_CURRENCY="EUR"
+ MOMO_CURRENCY="UGX"

Comparison

Setting	Sandbox	Live
Base URI	https://sandbox.momodeveloper.mtn.com/	https://ericssonbasicapi1.azure-api.net/
Environment	sandbox	mtnuganda
Currency	EUR	UGX
Documentation	https://momodeveloper.mtn.com/api-documentation	https://momoapi.mtn.com/api-documentation

Note:

• MSISDN (Phone number format)

  The right phone number is strictly numeric, preceded by the country code. For example, this: +256 772 485 678 would be 256772485678.

• Country

  This wiki is for MTN Uganda, the environment and currency will change per country.

• Product

  Examples are for collection but they apply to other products (disbursement and remittance) too.

  Be sure to replace the product name to match the product you subscribed to eg; the client ID for disbursement would be set using MOMO_DISBURSEMENT_ID.

• Callback URI

  This is not a redirect URI. MTN MoMo API won't redirect a request to this URI. Instead, they use it to notify a transaction once completed.