M-Pesa Reversals

M-Pesa Reversals manages requests to reverse a mobile-money deposit - for duplicate payments, wrong-account credits or fraudulent transactions. Each mfi.mpesa.reversal.request tracks the original payment, reason and the reversal's status through approval and settlement.

Workflow

Open Savings > Transactions > M-Pesa Transactions > M-Pesa Reversals.
Create a reversal request linked to the original M-Pesa transaction.
Record the reversal reason and supporting detail.
Submit for approval; an authorised officer reviews and authorises it.
Track the request until the reversal is confirmed settled.
Confirm the corresponding savings entry is backed out.

Fields reference

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

Field	Type	Required	Description
Reference `name`	Text	Yes	Reference
Reason `reason`	Long text	Yes	Reason
State `state`	Choice: Pending Approval, Approved, Submitted to Daraja, Confirmed Reversed, Declined	Yes	State
Original Payment `original_payment_id`	Link → mfi.savings.transaction	—	Original Payment
Original Callback Log `original_log_id`	Link → mfi.mpesa.callback.log	—	Original Callback Log
Original Receipt `original_receipt`	Text	—	Original Receipt
Amount `amount`	Money	—	Amount
Currency `currency_id`	Link → res.currency	—	Currency
Contra Suspense Entry `contra_suspense_id`	Link → mfi.suspense.ledger.entry	—	Contra Suspense Entry
Requested By `requested_by`	Link → res.users	—	Requested By
Approved By `approved_by`	Link → res.users	—	Approved By
Daraja Conversation ID `daraja_conversation_id`	Text	—	Daraja Conversation ID
Notes `notes`	Long text	—	Notes

Actions & buttons

Buttons available on this screen and what they do:

Approve
Submit to Daraja
Mark Confirmed
Decline

Status lifecycle

Records on this screen move through these statuses:

Pending Approval → Approved → Submitted to Daraja → Confirmed Reversed → Declined

Notes & rules

Requests on mfi.mpesa.reversal.request with approval workflow.
Used for duplicate, wrong-account or fraudulent mobile-money credits.
Approved reversals back out the related savings posting.

Technical model: mfi.mpesa.reversal.request · Record: M-Pesa Reversal Request