Mpesa Settings
Overview
Mpesa Settings – Business Overview
Mpesa Settings is a core business configuration document used to enable and manage Mpesa mobile money payments within Dafater. It acts as the central place where a business defines how Mpesa transactions are received, identified, and controlled across daily operations.
What Mpesa Settings Is Used for
Mpesa Settings is used to:
- Connect Dafater with the business’s Mpesa payment channel
- Define how customer payments made via Mpesa are recognized and processed
- Ensure incoming Mpesa payments are correctly matched to sales, invoices, fees, or other collections
- Control whether Mpesa is available as an active payment option for customers
In simple terms, this document allows a business to accept Mpesa payments in an organized, traceable, and reliable way.
Prerequisites and Setup Requirements
Before using Mpesa Settings, the business should ensure:
- An active Mpesa merchant or paybill/till arrangement is already in place
- The business understands how Mpesa payments are received and referenced (e.g., transaction codes, customer identifiers)
- Internal approval has been given to accept mobile money as an official payment method
- Accounting or finance teams agree on how Mpesa collections will be tracked and reconciled
Mpesa Settings should only be completed by authorized users, typically from finance or operations.
Typical Workflow and Business Fit
Initial Setup
Mpesa Settings is created and filled once the business decides to accept Mpesa payments.Activation
Mpesa is enabled as a payment option within Dafater.Daily Operations
- Customers make payments using Mpesa
- Payments are recorded against invoices, sales, or accounts
- Finance teams review Mpesa collections as part of daily cash management
Reconciliation and Reporting
Mpesa payments are reviewed and matched with bank or Mpesa statements to ensure accuracy.
Mpesa Settings sits at the foundation of all Mpesa-related payment activities and supports smooth financial operations.
Key Business Scenarios Where Mpesa Settings Is Essential
- Retail and service businesses collecting customer payments via mobile money
- Schools or training institutions receiving fees through Mpesa
- Loan or installment-based businesses collecting repayments digitally
- Field-based or remote operations where cash or card payments are impractical
- High-volume payment environments requiring fast, reliable collections
Without Mpesa Settings, Mpesa payments cannot be consistently managed within Dafater.
Important Considerations for Users
- Mpesa Settings should be reviewed whenever Mpesa merchant details change
- Only trusted users should update this document, as it affects all Mpesa payments
- Incorrect setup can lead to unmatched payments or reconciliation delays
- Regular monitoring helps ensure all Mpesa payments are properly accounted for
- Finance teams should align Mpesa Settings with internal accounting and audit practices
Summary
Mpesa Settings is a critical business document that enables, controls, and standardizes Mpesa payments in Dafater. It ensures mobile money collections are accurate, traceable, and aligned with the organization’s financial processes, making it essential for any business relying on Mpesa as a payment channel.
Basic Information
- Module: Payment Gateways
- Document Type: Other
Fields
| Field Name | Label | Type | Required | Options | Description |
|---|---|---|---|---|---|
| paymentgatewayname | Payment Gateway Name | Data | ✓ | - | Payment gateway identifier used by Dafater for Mpesa transactions |
| consumer_key | Consumer Key | Data | ✓ | - | API consumer key for authenticating Mpesa requests in Dafater |
| consumer_secret | Consumer Secret | Password | ✓ | - | API consumer secret used by Dafater for secure authentication |
| initiator_name | Initiator Name | Data | - | Authorized initiator name for Mpesa operations configured in Dafater | |
| till_number | Till Number | Data | ✓ | - | Mpesa till number linked to business payments in Dafater |
| transaction_limit | Transaction Limit | Float | - | Maximum allowed Mpesa transaction amount enforced by Dafater | |
| sandbox | Sandbox | Check | - | Enable sandbox mode for testing Mpesa integration in Dafater | |
| business_shortcode | Business Shortcode | Data | - | Official Mpesa business shortcode used by Dafater | |
| online_passkey | Online PassKey | Password | ✓ | - | Online passkey for Mpesa STK transactions in Dafater |
| security_credential | Security Credential | Small Text | - | Encrypted security credential for Mpesa API access in Dafater | |
| getaccountbalance | Get Account Balance | Button | - | Button to fetch current Mpesa account balance in Dafater | |
| account_balance | Account Balance | Long Text | - | Displays latest retrieved Mpesa account balance in Dafater |
Permissions
| Role | Read | Write | Create | Delete | Submit | Cancel |
|---|---|---|---|---|---|---|
| Accounts Manager | ✓ | ✓ | ✓ | ✓ | ||
| Accounts User | ✓ | ✓ | ✓ | ✓ | ||
| System Manager | ✓ | ✓ | ✓ | ✓ |