M-Pesa & Daraja error codes

A dedicated, linkable page for every Safaricom M-Pesa result code and Daraja API error — what causes it, how to fix it, and how paylod handles it for you. Prefer to search? Use the searchable reference.

STK Push result codes

0Success 1Insufficient M-Pesa balance 17M-Pesa system internal error 26M-Pesa system busy 1001A transaction is already in process for this number 1019Transaction expired 1025Error sending the STK prompt 9999Error sending the STK prompt 1032Payment cancelled by the customer 1037Timeout — the customer could not be reached 2001Wrong M-Pesa PIN 2028Payment amount exceeds the M-Pesa limit 2029Buy Goods till sent as a Paybill request (or vice versa)

Daraja API errors

400.002.02Bad Request — invalid amount or shortcode 400.002.05Invalid request payload 400.008.02Invalid phone number 401.002.01Unauthorized — invalid or expired access token 404.001.03Invalid access token 404.001.04Invalid authentication header Bad Request - Invalid Initiator InformationInvalid initiator information 500.001.1001Server error — merchant does not exist or insufficient funds 500.002.1001Service temporarily unavailable / under maintenance

C2B / B2C result codes

0Success / Accepted 2001Invalid initiator information C2B00011Invalid MSISDN (Reject)C2B00012Invalid Account Number (Reject)C2B00013Invalid Amount (Reject)C2B00014Invalid KYC Details (Reject)C2B00015Invalid Shortcode (Reject)C2B00016Other Error (Reject)