Setup

After installation, You will have "Settings" and "Transaction logs" link next to the activate link on the module. Click on the "Settings" to configure the mpesa gateway.

Action links

Configuration

  1. Click on the "settings" link on the module.

  2. Get your mpesa keys and fill on the settings form.  

    Use follow credential for test or obtain a test credential from you Mpesa dashboard:  

    • Consumer key: 9fLxriPxb1Xp788qeOKtaC0hZRnqp8WI
    • Consumer secret: lU2XmNXfAjlMmZQe
    • STK pass key: bfb279f9aa9bdbcf158e97dd71a467cd2e0c893059b10f78e6b72ada1ed2c919
    • Short code: 174379
    • Phone number: Your mpesa phone number

     

    You should contact Mpesa team for support regarding this and launching to production for live credentials.

     

    Settings

  3. This module only support KES and USD, leave as default or remove USD if your platform is not in USD.

  4. Provide the rate of USD to KES if you support USD. The rate will be used for conversion when making a payment for an invoice in USD.

Live mode

To launch to production, you will need to contact Mpesa team for approval and they will provide you all neccessary credentials including the STK pass keay and short code.

Optional: translation of texts

Our module contains a localized file with all necessary strings in it, so you can translate them to your own language if its needed or change them. This file can be found under module's folder and /language/english/ subfolder.

You can create your own language folders there or override the language strings directly from your custom language file of Perfex's installation ( link )