Configure your M-Pesa shortcode after Safaricom has issued the live Till or PayBill number and Daraja credentials. This setup is handled as an account configuration flow in KulmiPay. The backend supports processing custom M-Pesa callback traffic, but there is no public REST endpoint for merchants to create or update shortcode credentials directly.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.
Configuration steps
Log in to KulmiPay
Sign in at
https://app.kulmipay.com with an account that can manage integrations and payment settings.Prepare your M-Pesa credentials
Collect the live Daraja
consumer_key, consumer_secret, passkey, shortcode, and shortcode type. The shortcode type must match the Safaricom product: Till or PayBill.Share or enter the configuration
Add the credentials in the KulmiPay M-Pesa configuration flow for your account. If the setting is not visible on your account, KulmiPay support must enable it before activation.
Activate the shortcode
Confirm the configuration and activate the integration. After activation, KulmiPay can process M-Pesa collections through your shortcode.
Required details
| Field | Description |
|---|---|
| Shortcode | Your Safaricom Till or PayBill number. |
| Shortcode type | Till or PayBill. |
| Consumer key | Live Daraja app consumer key. |
| Consumer secret | Live Daraja app consumer secret. |
| Passkey | Live shortcode passkey from Safaricom. |
| Business account | KulmiPay business account that should receive collections. |
Callback handling
KulmiPay handles callback processing for activated custom M-Pesa shortcodes. After setup, payment status updates continue to use the same KulmiPay invoice status and webhook flows documented for collections. Use these existing integration points:| Need | Where to look |
|---|---|
| Create an M-Pesa collection | M-Pesa STK Push |
| Check invoice status | Payment Status |
| Receive asynchronous updates | Payment Collection Events |
| Use the WooCommerce plugin | WooCommerce |
Keep your live Daraja credentials in sync with KulmiPay. If Safaricom rotates your credentials or changes callback settings, update the KulmiPay configuration before processing live payments.