Help Guide
M-pesa Hash Decoder
Safaricom M-Pesa now sends a hashed phone number instead of the actual customer phone number when a payment is made to your till or paybill. Our portal has implemented a Hash Decoder feature where you can query a phone number by simply providing the hash and clicking the query button.
(Note: If you integrate your till or paybill into our portal, you do not need to manually use the hash decoder. Our system automatically decodes customer phone numbers.)
Navigate to the Hash Decoder page on the side menu. Enter a hash value into the provided box and click the query button. Within a moment, the system will display the corresponding phone number if the hash is valid.
For developers, you can also decode hashes programmatically via our API. Make a POST request to our endpoint for example:
curl -X POST "https://transactions.prasams.com/api/v1/decode-hash"
-H "Content-Type: application/json"
-H "x-api-key: your_api_key_here"
-d '{"hash": "your_hash_key_here"}'
Successful response
{'status': 'success', 'phone': '+25472000000'}
Error response
{'status': 'error', 'description': 'The error message'}
If you encounter issues while using the Hash Decoder, ensure your hash values are correct and that you have the necessary API keys if using the API. For further assistance, consult our support team.