Skip to main content
POST
Request M-Pesa reversal

Authorizations

Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer sk_live_...

Headers

Idempotency-Key
string<uuid>

Unique key to safely retry POST without duplicates. Required in live environment.

Body

application/json
transactionId
string
required

Original transactionId (public ID) to reverse.

Example:

"txn_01j7b6f9p5y9h"

narration
string

Optional narration for the reversal request. Maximum 140 characters.

Maximum string length: 140
Example:

"Customer refund"

Response

Accepted — reversal will be processed asynchronously.

status
string
required
Example:

"success"

message
string
required
Example:

"Reversal initiated successfully"

data
object
required