Description

Frappe Mpesa Payments is a custom Frappe application that integrates with Safaricom’s Daraja API. It is built to extend ERPNext enabling seamless mobile money payments from customers, and payment disbursements to suppliers and employees. Hence it implements the following APIs: Mpesa Express (STK Push), C2B (Customer to Business), B2C (Business to Customer) and Transaction Status (Query status of payment). Supported APIs: 1. ✅ Mpesa Express (STK Push) This is a feature that allows suppliers/vendors to initiate a payment prompt on a customer’s phone, prompting them to enter their M-Pesa PIN to authorize the transaction. It’s a convenient and secure way for customers to pay, as it eliminates the need for customers to remember paybill/account numbers. It also reduces the time taken to receive payment Use Cases Request payment from:Sales Invoice (Credit),Sales Order,POS (Point of Sale),Webshop (E-Commerce),Sales Invoice (of type POS) 2. ✅ C2B (Customer to Business) In ERPNext, C2B integration allows you to automatically receive and reconcile payments made by customers through M-Pesa to your Paybill or Till number. These payments are linked to payment entries, enabling real-time updates of outstanding balances and reducing manual data entry. 3. ✅ B2C (Business to Customer) M-Pesa B2C integration enables businesses disburse payments directly to customers, employees or suppliers directly to their M-Pesa accounts. Through seamless API integration, ERPNext users can initiate bulk payments such as salaries, expense claims, supplier payouts or even loans directly from the system. This enhances efficiency, reduces errors and ensures secure, traceable disbursements, all while maintaining accurate financial records within ERPNext. Use Cases Disburse payments to suppliers,B2CPurchases,Disburse to employees,B2CEmployee,Disburse Loans,B2CLoanDisbursement 4. ✅ Transaction Status (Query status of payment) In the case a customer has paid via M-Pesa but the payment is not reflecting in your ERPNext instance, this API becomes essential. This integration allows ERPNext to query Safaricom’s systems using the transaction receipt number and retrieve real-time details such as transaction status (Success, Failed or Pending). It helps resolve issues caused by network delays, missed callbacks, or unregistered C2B transactions by enabling manual verification.

Product Features

Full Name: Customer’s full name as recorded in the Mpesa transaction. Transaction Type: Type of transaction (typically “Pay Bill” or “Buy Goods”). Trans ID: Unique transaction ID generated by Mpesa. Trans Time: Timestamp of the transaction. Trans Amount: Amount transferred by the customer. Business Short Code: The business shortcode involved in the transaction. Bill Ref Number: Reference number associated with the transaction. Invoice Number: Associated invoice for easy reconciliation. Org Account Balance: Account balance at the time of the transaction. Third Party Trans ID: Identifier from any third-party integration. Posting Date & Time: Date and time when the transaction was recorded in your system. Company: The company receiving the payment. Default Currency: The currency in which the transaction was processed. Customer: Links to the customer making the payment. Mode of Payment: Type of payment method used. Currency: The currency in which the transaction was processed.

Tech Stack

Python
Javascript
Html

Link To Youtube Demo Video

Link To Your Github Repo

https://github.com/navariltd/frappe-mpsa-payments.git

Link To Demo Website

How To Install

Login to your Frappe Cloud account. Navigate to your Sites/Bench Groups dashboard. Go to the Apps tab and select + Install APP / + Add APP. Search for Frappe Mpesa Payments application in the Marketplace section. Or select Add from Github then add this github url https://github.com/navariltd/frappe-mpsa-payments.git. Install Application or Fetch Branches