Use this setup when your business already owns a Safaricom M-Pesa Till or PayBill number and wants KulmiPay to process collections through that shortcode. Once enabled, your customer-facing payment details use your shortcode, while KulmiPay handles payment processing, reconciliation, payment status updates, and webhooks.Documentation Index
Fetch the complete documentation index at: https://developers.kulmipay.com/llms.txt
Use this file to discover all available pages before exploring further.
What you need
Before configuring your shortcode, make sure you have:| Requirement | Description |
|---|---|
| Safaricom shortcode | Your live Till number or PayBill number. |
| M-Pesa portal access | Access to the organization that owns the shortcode. |
| Daraja live app | A live Safaricom Daraja app for the shortcode. |
| Consumer key and secret | Live Daraja app credentials. |
| Passkey | The shortcode passkey from Safaricom. |
| Shortcode type | Either Till or PayBill. |
Supported flow
This is an account configuration flow. It is not a public REST API for creating or editing M-Pesa shortcode integrations. After activation, your existing KulmiPay collection flows continue to work:| Flow | Endpoint or tool |
|---|---|
| M-Pesa STK Push | POST /api/v1/payment/collection/ with method: "M-PESA" |
| Hosted checkout | KulmiPay checkout SDK and hosted checkout sessions |
| WooCommerce | KulmiPay WooCommerce plugin |
The public
mpesa-paybill-accounts API is different. It provisions an account reference under the KulmiPay PayBill. This section is for businesses that want to use their own Safaricom shortcode.