Documentation

Daraja Setup Guide

How to go live with your M-PESA shortcode

To take your shortcode live on the Safaricom Daraja API, you must have a registered Safaricom Paybill or Till number, and a Safaricom M-Pesa organization portal account. The process involves two main stages: preparation and submitting the "Go Live" request on the Daraja Portal.

Prerequisites

Go Live Steps

  1. Log in to the Daraja Portal: Access your account on the Safaricom Developer Portal.
  2. Navigate to "Go Live": Click on the "Go Live" option in the side-menu.
  3. Fill in Organization Details: A form will appear where you must provide your organization's information.
    • Verification Type: Select "Shortcode".
    • Organization Shortcode: Enter your actual Paybill or Till number.
    • Organization Name: Enter the exact name of your registered company as it appears on the M-Pesa Organization Portal (it is sometimes best to use a single word version if the official name has spaces, as per some reports).
    • M-Pesa User Name: Enter the username of the M-Pesa Organization Portal user with the Business Manager role that was sent to your email during the admin creation process. The email address used by Safaricom is M-PESABusiness@safaricom.co.ke. If you have not received this email from them, reach out to them for more information as to why.
    • Accept Terms and Conditions: Read and agree to the terms and conditions.
    • Enter OTP: An OTP (One-Time Password) will be sent to the contact number associated with the Business Manager user on the organization portal. Enter this OTP to verify your request.
    • Receive Live Credentials: Once your application is reviewed and approved by Safaricom (usually within 1-3 working days), you will receive new production credentials via email. These include:
      • A new Consumer Key and Consumer Secret for your live app.
      • A live Passkey (for STK Push).
← Back to onboarding