Help Guide
Integration
To integrate your M-pesa shortcodes into our system, follow these steps:
-
Step 1: Ensure you have the following: (These details can be obtained by contacting Safaricom at M-PESABusiness@safaricom.co.ke. or you can contact us at support@prasams.com to assist in obtaining them.)
- Shortcode Number: The unique number assigned by Safaricom.
- Shortcode Type: Specify whether it is a Till or Paybill.
- TILL Number: Required only if the shortcode type is TILL.
- Passkey: Secure key provided by Safaricom.
- Consumer Key: Used for API access, obtained from Safaricom.
- Consumer Secret: Secret associated with the consumer key for API access.
- Initiator: API user created on the Safaricom business account portal with basic permissions (check balance, initiate STK push, check transaction status).
- Security Credentials: Generated on https://developer.safaricom.co.ke/TestCredentials using the initiator password.
-
Step 2: Add Shortcode to Property
- Navigate to the Properties section in your account.
- Select the property to which you want to add the shortcode.
- Go to the Shortcodes tab and click on Add Shortcode.
- Input the shortcode details as prompted. Ensure that all information is accurate and complete.
- Save your settings to complete the integration process.
Note: Once entered, these details are automatically hidden to ensure your security and privacy.
Once your shortcode is integrated, you can manage and troubleshoot it via the Properties section:
- Monitor integration logs to ensure data sync correctness.
- Update shortcode settings if changes occur.
- Review error logs for troubleshooting tips if issues arise.
- Contact support for persistent problems or additional assistance.
Q1: Where can I obtain the necessary shortcode integration information?
You can obtain all required information by contacting Safaricom at M-PESABusiness@safaricom.co.ke. You can also contact us at support@prasams.com for assistance.
Q2: What permissions should be granted to the API user (Initiator)?
The initiator should only be granted basic permissions. These includes: Check balance, initiate STK push, and check transaction status. Avoid granting elevated privileges.
Q3: Are my integration details secure?
Yes, once you save your integration details they are hidden and not visible to any other user to ensure your data remains secure.
You can obtain all required information by contacting Safaricom at M-PESABusiness@safaricom.co.ke. You can also contact us at support@prasams.com for assistance.
Q2: What permissions should be granted to the API user (Initiator)?
The initiator should only be granted basic permissions. These includes: Check balance, initiate STK push, and check transaction status. Avoid granting elevated privileges.
Q3: Are my integration details secure?
Yes, once you save your integration details they are hidden and not visible to any other user to ensure your data remains secure.