M-Pesa Logs

M-Pesa Logs is the raw audit trail of every mobile-money callback received by the suite - successful and failed - with the full payload, result codes and timestamps. It is the technical reference for diagnosing why a deposit did or did not post and for reconciling against the mobile-money statement.

Workflow

Open Savings > Compliance > M-Pesa Logs.
Search by transaction reference, phone number or date.
Open a log entry to read the full callback payload and result code.
Trace whether the callback matched and posted or fell to the queue.
Use the result code to diagnose failed or stalled deposits.

Fields reference

Every field on this screen, drawn from the live data model.

Field	Type	Required	Description
M-Pesa Reference `mpesa_reference`	Text	—	TransID / ConversationID / CheckoutRequestID / MpesaReceiptNumber
Direction `direction`	Choice: Inbound (Callback), Outbound (API Call)	Yes	Direction
Type `type`	Choice: C2B Validation, C2B Confirmation, B2C Payment Request, B2C Result, B2C Queue Timeout, STK Push Request, STK Callback, OAuth Token	Yes	Type
Payload `payload`	Long text	—	Payload
Response `response`	Long text	—	Response
Result Code `result_code`	Text	—	Result Code
Result Description `result_desc`	Text	—	Result Description
Savings Account `account_id`	Link → mfi.savings.account	—	Savings Account
Savings Transaction `transaction_id`	Link → mfi.savings.transaction	—	Savings Transaction
Loan `loan_id`	Link → mfi.loan	—	Loan
Disbursement `disbursement_id`	Link → mfi.loan.disbursement	—	Disbursement
Repayment `repayment_id`	Link → mfi.loan.repayment	—	Repayment
Mobile Number `msisdn`	Text	—	Mobile Number
Amount `amount`	Money	—	Amount
Currency `currency_id`	Link → res.currency	—	Currency
HTTP Endpoint `endpoint`	Text	—	HTTP Endpoint
Idempotency Key `idempotency_key_id`	Link → mfi.mpesa.idempotency.key	—	Idempotency Key
Replay (idempotent hit) `is_replay`	Yes/No	—	Replay (idempotent hit)
Unmatched Queue Entry `unmatched_id`	Link → mfi.mpesa.unmatched.callback	—	Unmatched Queue Entry

Notes & rules

Records on mfi.mpesa.callback.log capturing every callback received.
Stores full payload, result codes and timestamps for audit.
First place to look when a mobile-money deposit fails to post.

Technical model: mfi.mpesa.callback.log · Record: M-Pesa Callback / API Log