Skip to main content

M-Pesa Payments

M-Pesa Payments

Navigate to Sales & Inventory → M-Pesa Payments.

Manage incoming M-Pesa payments, verify transactions, and link payments to sales.

Payment Methods

NuSaaS supports multiple M-Pesa payment flows:

MethodDescription
STK PushSystem sends payment prompt to customer's phone
Paybill/TillCustomer pays manually to your business number
QR CodeCustomer scans to pay (Lipa na M-Pesa)

Unreconciled Payments

When a customer pays directly to your Paybill or Till number, the payment arrives via C2B (Customer-to-Business) webhook. These payments appear in the Unreconciled tab until linked to a sale.

To reconcile a payment:

  1. Find the payment in the Unreconciled tab
  2. Click Link to Sale
  3. Select the matching pending sale
  4. Confirm the reconciliation

Verify Transaction Code

If a customer claims they've paid but the payment hasn't appeared:

  1. Go to the Verify Code tab
  2. Enter the M-Pesa receipt code (e.g., SLT7A1B2C3)
  3. Click search to verify with Safaricom
  4. View transaction details if found

GSM Modem (Desktop POS)

For offline payment confirmation, connect a USB GSM modem:

  1. Insert a SIM card with your M-Pesa receiving number
  2. Connect the modem to your computer via USB
  3. Go to the GSM Modem tab
  4. Click Connect Modem and select the device
  5. Incoming M-PESA messages appear automatically

Compatible modems: SIM800, SIM900, Huawei E303, and similar USB modems.

Note: GSM Modem requires Chrome, Edge, or Opera on desktop.

C2B Setup (Admin)

To receive automatic payment notifications:

  1. Go to Settings → M-Pesa Configuration
  2. Enter your Paybill/Till credentials
  3. Click Register C2B URLs
  4. Safaricom will now notify your system of incoming payments