Wi5stars-Vodacom M-Pesa
Administrator Manual
Vodacom M-Pesa

Configuration Details of the Account

Using Vodacom M-Pesa as a gateway for payments in Ghana, Tanzania, Lesotho, and the Democratic Republic of the Congo requires, you need to register an App as follows:

  • Open the internet browser and digit https://openapiportal.m-pesa.com
  • Select “DEVELOPER”
  • Click on “Sign Up” on the bottom
  • Enter the required data and follow the wizard

After registration, you will get access to the developers’ Portal where you can create your own test App for payments.

To create the App, follow the procedure:

  • Click “Applications” on the left
  • Enter a Name and Description
  • Click “Currencies” and select all the currencies
  • Click “C2B SINGLE PAYMENT” and activate it using the relevant check
  • Activate “Asynchronous Flow”
  • In “Response URL”, enter: https://DomainName/payments/vodacommpesa (Instead of DomainName enter the name of the domain assigned to the Wi5stars).
  • On the left, you will find the API Key, copy and paste it into the “Currency and Payment Systems” session, “Payment Systems for the Users” > “Vodacom M-Pesa” in the “Test API Key” and “API Key” fields.
  • Then click Save on the bottom right.

To run integration tests, in addition to the API Key, in the “Currency and Payment Systems” session, in the “Service Provider Test Code” field, enter the value “000000”. At this point you can test the integration from the Welcome Portal by registering a new user who has to enter “000000000001” as mobile number.

If you want to upgrade to the Live version, you need to connect an organization to the App.
The documentation states:
Linking Process
To link a developer account with an organisation, the organisation user will send an invitation to the developer’s e-mail account from within the Portal. If the developer user already has an account, a notification will be sent to the Developer user to accept the new link.

The prerequisites for this type of payment are:

In the domain, define “Yes” in the field “Request mobile number”

The international country calling codes accepted are: 00233 (Ghana); 00255 (Tanzania); 00266 (Lesotho); 00242 (Democratic Republic of Congo).

In the domain, on “Options for the Country Calling Codes”, enable “Consider Country Calling Codes”, and on “Accepted Country Calling Codes”, you need to enter the area codes according to the desired and accepted countries for payments.

Product prices are automatically converted from the manager’s currency to the currency of the country expressed by the international country calling code of the mobile phone number with the following logic:

  • Ghana -> GHS
  • Tanzania -> TZS
  • Lesotho -> LSL
  • Democratic Republic of the Congo -> USD