How to Connect Your WordPress WooCommerce Site with MPESA Till Number or Paybill Number

For all API integrations, Safaricom recommends you have a Paybill or Till Number issued by Safaricom and you must settle (withdraw monies from the Till or Paybill number) to bank.

Assumption for this guide – You already have a Paybill or Till number from Safaricom.

Summary:

• Login to MPESA Portal https://org.ke.m-pesa.com/ and create WEB Operator & API Operator
• Login to Daraja Portal https://developer.safaricom.co.ke and create a GOLIVE app
• Enter your your Consumer Key, Secret Key, Pass Key, Paybill or Till number under plugin settings

STEP 1 – Access MPESA Portal and Create Two Operators

a) Request Admin Access to MPESA Portal – https://org.ke.m-pesa.com

• Fill in the below MPESA Business Admin Activation Request Template with your company details, let all directors sign it, (in case of Sole Proprietorship, the single director will sign it), stamp it
  MPESA Business Admin Account Activation Request Template – Word Format
  Mpesa Business Admin Account Activation Request Tempate – PDF Format
• Make sure you attach copies of national ID or passport for all the directors who sign the letter
• Send the above documents to M-PESABusiness@safaricom.co.ke

b) Getting and Installing MPESA Certificate

Once you get the above admin login details to MPESA portal, you need to login to the MPESA portal and create two operators (API and Web). Before we can access the MPESA Portal https://org.ke.m-pesa.com/, we need to install an MPESA Certificate. Please note that the certificate only works for Windows OS systems

• Send a blank email to M-PESACertpassword@safaricom.co.ke

• You will receive an email from Safaricom with Subject M-PESA Certificate Password [Automatic Response], which has the username and password you need to apply for the MPESA Certificate
  

• Open this url https://vmtke.ca.vodafone.com/certsrv on Internet Explorer browser on your Windows OS computer – and enter the username and password provided on the email

• Click on the Settings icon, then select Compatibility View Settings

Next click on Settings Icon, Go to Internet Options, choose Advanced and scroll down to ensure your settings are shown as below

Next Click on Settings Icon, select Internet Options, then Select the Advanced tab, scroll down and ensure your settings are as shown below

• Click on *Apply* and then OK.

• Close and then open internet explorer to proceed smoothly without a hitch. Open the URL again https://vmtke.ca.vodafone.com/certsrv and this time you will be prompted with the below dialog box, select on Yes

• Fill in the details exactly as they appear on your ID card, and on the Paybill or Till number forms that you sent to Safaricom. Your certificate application shall be denied if you fill incorrect or invalid details e.g. a single name, invalid email or incorrect organization name.

• After submitting, you’ll get a response saying your certificate is pending. You are supposed to return to the site – https://vmtke.ca.vodafone.com/certsrv – after about 2 – 24 hours and check whether your certificate has been approved

• Click on Client Authentication Certificate to proceed

If the Certificate is issue, you will see a screen like below, click on Install this Certificate to proceed

• A Web Access confirmation warning will appear asking you to confirm the operation. Click on „yes’

• Click on “install this CA certificate’

• It will prompt you to open or save the file. Click on open.

• Once open, select ‘install certificate’

• A window will open as below. Click next.

• Click on ‘place all certificates in the following store‟ then select ‘Trusted Root Certification Authorities

• Click on ‘next’

• Then finish the process
  

• You will then get a prompt asking you if you are sure you want to install the certificate. Click in „yes‟

The certificate is now imported. Next Final Step is to install it…
Go back to the certificate request website and click on install the certificate as below

You will be directed to the page below.

You will be able to login to the M-PESA Portal site via the below URL; https://org.ke.m-pesa.com

STEP 2. CREATING WEB AND API OPERATORS

• Visit the MPESA Portal url https://org.ke.m-pesa.com/ and login with the username and password you received from Safaricom after sending them the letter on Step 1 above. Note that Shortocode refers to either Paybill Number or Store number (use Store number if you have a Till Number
  

• Enter the One Time Passcode (OTP) that is sent to your phone number

• Once logged in, click on Browse Organization

• Next, click on Operators, then click on the Add icon
  

Create an API Operator

• Start by creating an API operator. Select API under Access Channel

• Enter an appropriate API username and click on Next

• Under Rule Profile, select Web Operator Rule Profile

• Then click on the *Add* icon, and select the following options under the Select Role dialog, then click on OK

• After that, you’ll see screen of the roles you just select, you can add more roles here or just hit the Next button

• The next option is the *Know Your Customer – KYC* fields, enter the details and click on next. Make sure under Preferred Notification Channel, you select SMS and your phone number follows the format 2547xxyyyyyy e.g 254746490042. After that click on next and finish

Create a Web Operator

• Click on Operators then on the Add icon

• Then select Web under Access Channel

• Enter an appropriate username and note it down as you will need it to login back to the MPESA portal later
  

• Under Rule Profile, Select Web Operator Rule Profile

• Then click on Add button and select the options shown below under Role

• Then hit next after that

• Fill in the KYC details as shown below

• Finally submit to create your Web Operator. Immediately you submit, you will receive a SMS on the number you entered under KYC information. The SMS contains the username and password for your Web Operator. Logout and log back in using the details on sent the SMS to activate the Web Operator. In order for the plugin to work, the web operator must be active

STEP 3. Creating Consumer and Secret Keys on Daraja

• Go to https://developer.safaricom.co.ke/ and create an account (or login if you already have an account )

• Click on GO LIVE menu option

• Download this testcases excel file to your computer, then choose it Upload Test Results, then hit the *Upload* button to ensure the file is uploaded to Safaricom servers, check the Terms and Conditions and hit on Next to proceed

• Fill in the details as below and click on Verify

• On the next screen, choose all the products as shown, enter the OTP code that will be sent to your phone number and submit

• That is it, you have successfully applied for your consumer and secret keys

• Click on Company name to switch the company to the one you just created
  

• Make sure you are inside the company you just created, then select the *MY APPS* menu option. You will see the app you just created and it’s status as pending. Safaricom API team will activate it after some time

• After your app has been approved, log back in and get the consumer key and secret key, which you’re gonna paste on the Mpesa WooCommerce Plugin settings

• Finally, copy the app name on to the below MPESA GO Live and Pass Key Request template, edit the other details as desired, have all directors sign the document, stamp it and send to apisupport@safaricom.co.ke
  – MPESA GO Live and Pass Key Request template – Word Format
  – MPESA GO Live and Pass Key Request template – PDF Format

STEP 4 – How to Configure the MPESA WordPress WooCommerce Plugin for Paybill and Till Numbers

• Head over to https://futurevh.com shop section and purchase the appropriate plugin depending on whether you have a Paybill or Till number
  For Till Numbers, buy this – Mpesa WooCommerce Plugin for Till Numbers – Single Site License – (if you are a developer and would like to re-use the plugin on multiple websites, then purchase this one MPESA WooCommerce Plugin for Till Numbers – Multiple Sites License)
  
  For Paybill numbers, buy this – M-PESA WooCommerce Plugin Paybill Numbers – Single Site License -(developers who have multiple clients and would like to reuse the plugin, can purchase this one – MPESA WooCommerce Plugin for Paybill Numbers – Multiple Sites License )
  
• Go to your WordPress admin dashboard, then select the Plugins menu from the side and click on Add New

• Select Upload Plugin, then choose the plugin file that you downloaded from our website and hit Install Now, and activate it

• Go to WooCommerce, Settings and select the Payments tab. You will see MPESA as a payment option. Click on manage to open up the configuration page

• Under API settings, enter the consumer key, consumer secret (these two you get from Daraja – developer.safaricom.co.ke) and Passkey (this is sent to your email by Safaricom API team)

• Under MPESA Merchant, enter your details, select either Paybill or Till number. If you have a till number, make sure you enter the Store Number as this is needed for the plugin to work . Save the changes and your website is ready to accept Mpesa Payments straight to your Till Number or Paybill Number.

• For any queries, email info(at)futurevh.com
• To have us do all the above for you , call us on 0746490042. It will cost KSh. 4,500