Reverse Transaction
Reverse Transaction message is used to send a reversal advice to MMO. The HTTP method is POST
Reverse Transaction
The following describes the important element required to be sent for Reverse Transaction request.
| S/N | Data Element (DE) | Description | |
| 1 | subscriberId | Mandatory | Customer ID. E.g. 2348012233220 |
| 2 | transactionId | Mandatory | Unique ID for the transaction |
| 3 | originalTransactionId | Mandatory | Unique ID for the original transaction |
| 4 | paycode | Mandatory | PayWithMobile Token |
| 5 | macdata | Mandatory | See macdata computation in the appendix |
Request Headers
| S/N | Data Element (DE) | Description | |
| 1 | Authorization | Mandatory | Basic Authentication will be used. E.g Basic dXNlcm5hbWU6cGFzc3dvcmQ= |
| 2 | Content-Type | Mandatory | The API should support “application/json” media type |
Sample Reverse Transaction Request (Sent from Interswitch)
| POST {context}/transactions/reverse
Content-Type: application/json Authorization: dXNlcm5hbWU6cGFzc3dvcmQ= { “subscriberId”: “2348037119301”, “transactionId”: “1234567891”, “originalTransactionId “: “1234567890”, “macdata”: “sdjfggjnbtotfllbggbgrlbEHFnROoPCylN==” “paycode”: “1260763273”, } |
Reverse Transaction Response
The following describes the important data element required for Reverse Transaction response.
| S/N | Data Element (DE) | Description |
| 1 | responseCode | Response Code. See Response Code Table Below |
| 2 | responseDecription | Response Description. See Response Code Table Below |
Successful Response
| HTTP Status Code: 200
Content-Type: application/json { “responseCode”: “00”, “responseDescription”: “Approved“ } |
Unsuccessful Response
| HTTP Status Code: 401
Content-Type: application/json { “responseCode”: “63”, “responseDescription”: “Security Violation” } HTTP Status Code: 500 Content-Type: application/json { “responseCode”: “06”, “responseDescription”: “Unable to authorize due to some errors” } HTTP Status Code: 404 Content-Type: application/json { “responseCode”: “25”, “responseDescription”: “Transaction not found” } |
|