Introduction
Welcome to this Empress guide on how to integrate M-Pesa with your Empress business system. This integration enables you to process payments between the M-Pesa application and Empress, designed to work efficiently with Point of Sale (POS) transactions.
Please note: This feature does not support shopping cart transactions.
How to Obtain Your M-Pesa Credentials
Before you can integrate M-Pesa with Empress, you’ll need to get your M-Pesa API credentials. Here’s how:
- Log into your M-Pesa account.
- Navigate to the ‘Go Live’ section and follow the instructions to gain approval for the app.
- After ensuring all test results are satisfactory, submit the documentation and follow the subsequent steps to get your application’s final credentials.
- You’ll find the needed credentials in the ‘Production URL and Credentials’ section.
Setting Up M-Pesa in Empress
To enable M-Pesa Express, fill in all the mandatory parameters provided by M-Pesa. If you want to use the integration’s staging environment, select the ‘staging’ option and use the staging credentials provided.
Once you’ve enabled the M-Pesa integration, Empress will create a ‘Payment Gateway’ record and an ‘Account Head’ in the ‘Chart of Accounts’, with the account type set as ‘Bank.’ The system also creates a ‘Mode of Payment’ with the same name and account as the payment gateway’s and adds some custom fields in ‘POS Settings’ to handle the POS payments.
At this point, you’re ready to start accepting online payments via M-Pesa.
Making M-Pesa POS Payments
Once you’ve set up the POS profile with the M-Pesa mode of payment, the POS checkout will display an additional information section. This section contains two fields that are set up when adding M-Pesa settings.
When a POS user enters the customer’s mobile number, they can initiate a payment request. This sends a request to the customer’s M-Pesa mobile application linked to that number. After the customer processes the payment, a confirmation dialog prompts the user to submit the payment.
Checking Your M-Pesa Account Balance
You can check the account balance linked with an individual M-Pesa account using the ‘Get Account Balance’ button. This will display the M-Pesa account balance details in the dashboard.
Supported Transaction Currencies
Please note that the M-Pesa integration only works for businesses operating with the Kenyan Shilling (KSH) as the Company Currency.
In summary, M-Pesa integration with Empress streamlines your POS transactions, making it simple and efficient to process payments. It’s a beneficial feature for businesses operating with the Kenyan Shilling. For further support or information, you can visit our Help Center or contact our Support Team.