Request Method :: POST

Description: The Reversal API is used to cancel or reverse a previously authorized transaction,typically incases where the transaction could not be completed or needs to be voided before settlement.

Headers

requestTimestamp : 123432553255

transactionid: 100170

merchantId:1234

orderId:100156
clientId:  To be shared during integration by ISU Team
hmacSecret::  To be shared during integration by ISU Team
Content-Type: application/json

Header Parameters

Parameters Max Length Data types Mandatory/Optional Parameter Description
requestTimestamp 13 String Mandatory Epoch timestamp in milliseconds
transactionid 20 String Mandatory Unique Transaction ID
merchantId 15 String Mandatory Merchant identifier
orderId 20 String Mandatory Order Reference ID
clientId 64 String Mandatory Client authentication key
hmacSecret 64 String Mandatory HMAC Signature key
Content-Type - String Mandatory Must be application/json

Request Body Parameters

Parameters Max Length Data types Mandatory/Optional/conditional Parameter Description with samples
apiOperation 10 String Mandatory Must be "reversal"
pTxnId 20 String Mandatory Original payment transaction ID.E.g.-100170
authzTxnId 19 String Conditional Original authorization ID.E.g.-43252
amount - String Optional Amount to refund(partial/full).E.g.-100
rrn 12 String Mandatory Original RRN from purchase.E.g-516611899351
stan 6 String Mandatory Original STAN from purchase.E.g.906917

Sample Request Body

Response Body Parameters

Parameters Data Type Parameter description
processingDateTime String Date and time of operation
apiOperation String Confirms operation("reversal")
status String Transaction status
merchantId String Merchant identifier
pTxnId String Original transaction ID voided
rrn String New RRN for voided record
stan String New STAN for voided record

Sample Response Body