---
title: "3.1 Settings"
space: "Frappe Mpesa Payments"
url: "https://docs.navari.co.ke/frappe-mpesa-payments/reference/31-mpesa-settings"
updated: "2026-05-24"
---

## Mpesa Settings

![](/files/image82de8e.png)
*Mpesa Settings DocType*

**Purpose:** Central configuration record for Daraja API credentials. One record is created per API type.


| Field                       | Description                                                              |
| --------------------------- | ------------------------------------------------------------------------ |
| API Type                    | Mpesa Express, C2B, or B2C                                               |
| Consumer Key                | API authentication key from Safaricom                                    |
| Consumer Secret             | Paired secret for API authentication                                     |
| Business Shortcode          | Your Paybill or Till number                                              |
| Online PassKey              | Used for Mpesa Express STK Push only                                     |
| Till Number                 | Used for C2B Buy Goods payments                                          |
| Initiator Name              | API Operator username from M-Pesa Org Portal                             |
| Initiator Password          | Password for the Initiator. Encrypted to generate Security Credential.   |
| Security Credential         | Encrypted credential for B2C transactions                                |
| Auto Reconcile C2B Payments | If enabled, auto-matches incoming C2B payments to invoices on submission |


**Notes:**

- Access tokens are auto-generated and cached in this record.
- Tokens are reused until expiry, then refreshed automatically.