Kcb Payments

KCB Payments is a custom frappe application that integrates with KCB's BUNI API. It is built to extend ERPNext, enabling seamless mobile payments

Install Kcb Payments

bench get-app https://github.com/Team-Web-Limited/KCB-Payments

Add the Frappe Gems badge to your README

Maintain Kcb Payments? Paste this into your README:

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=Team-Web-Limited%2FKCB-Payments)](https://frappegems.com/gems/apps/Team-Web-Limited/KCB-Payments)

About Kcb Payments

### KCB Payments KCB Payments is a custom [frappe](https://frappe.io/framework) application that integrates with [KCB's BUNI API](https://buni.kcbgroup.com/). It is built to extend [ERPNext](https://frappe.io/erpnext/ke), enabling seamless mobile payments.
It Integrates the following KCB Buni APIs to ERPNext: 1) MpesaExpressAPIService 2) InstantPaymentNotification ### Requirements 1. [ERPNext](https://github.com/frappe/erpnext) 2. [Payments](https://github.com/frappe/payments) ### Installation You can install this app using the [bench](https://github.com/frappe/bench) CLI: ```bash cd $PATH_TO_YOUR_BENCH bench get-app $URL_OF_THIS_REPO --branch develop bench install-app kcb_payments ``` ### Doctypes #### 1) KCB MPesa Settings Create this for each till/paybill through which we want to receive payments image #### 2) KCB Mpesa STK Request This will be created for each STK Push generated from the system

image
Successful STK request

image
Failed STK request

#### 3) KCB IPN Settings This document stores the public key that is used to verify payment notifications from KCB. image #### 4) KCB Payment Transaction All KCB Payments (made either by stk push, or customer initiated payments), made to a certain paybill/till number will be recorded here.
This document is system generated, user cannot create a new record for _KCB Payment Transaction_ image ### Usage #### a) STK Push ##### 1) Create a payment request from a submitted sales invoice/sales order image ##### 2) Confirm payment request details and submit

image
Confirm payment request details

image
Submit payment request

image
A sumbmitted payment request has the status Requested

image
Customer enters pin to confirm payment

image
Completed payment request

#### b) Paybill/Till Reconciliation

image
Click Get KCB Payments on a submitted invoice with an outstanding amount

image
Search for payments using any of the criteria in the dialog box that appears

image
CLick Reconcile, for any of the fetched payments.

### Contributing This app uses `pre-commit` for code formatting and linting. Please [install pre-commit](https://pre-commit.com/#installation) and enable it for this repository: ```bash cd apps/kcb_payments pre-commit install ``` Pre-commit is configured to use the following tools for checking and formatting your code: - ruff - eslint - prettier - pyupgrade ### License mit

Related Accounting apps for Frappe & ERPNext

  • Books — Free Accounting Software
  • Lending — Open Source Lending software
  • Payments — A payments app for frappe
  • Banking — Load your bank transactions into ERPNext and reconcile them with your vouchers.
  • Erpnext Quota — App to manage ERPNext Site, User, Company and Space limitations
  • Utility Billing — The Utility Billing & Property Management App is a powerful addition to ERPNext, designed to streamline utility billing, property leasing, and tenant management. Ideal for municipal utilities, real estate managers, and property developers.
  • Expense Request — ERPNext Expense Requests
  • Vendor Payments — A frappe app that has workflows and reports to make payments to vendors by a company and track them