cancelTransaction

The cancelTransaction method is used to cancel a transaction that has already been approved and is registered in the database.

🚧
Such a transaction can be canceled as long as it is stored in the AEA database, which is cleared after the end-of-day batch when doPeriodic is called.

The client can also implement this action by calling doTransactionPhase1 with the appropriate tranCode.

Request

📘
JSON-RPC 2.0
All methods in TweezerComm follow a JSON-RPC 2.0 structure. See Integration for more details on how the requests are structured and sent.

In the request, ensure to configure the following:

The method field must be set to cancelTransaction .
The service must be set to ashrait in the params.

The request includes a list of parameters, with the first being the service name, which is currently fixed as ashrait, and the second being a dictionary containing all other transaction-specific details.

{
    "jsonrpc": "2.0",
    "method": "cancelTransaction",
    "params": [
        "ashrait",
        {
            "originalUID": "24071711552508830122539",
            "vuid": "1234567"
        }
    ],
    "id": "123454352"
}

Request Parameters

The table below describes the request parameters for this method.

Name	Type	Description
`originalUID`	string	The original UID of the transaction to be canceled.
`vuid`	string	Vendor (client) unique transaction identifier.

Response

A successful request will return the following response:

{  
   "jsonrpc":"2.0",
   "result":{  
    "statusCode": 0,
    "statusMessage": "׳”׳¢׳¡׳§׳” ׳׳•׳©׳¨׳”",
    "appVersion": "01.05.22",
    "retailerId": "0883012013",
    "ecrNo": "1",
    "vuid": "ee5e7af5-7719-4726-992f-0eb2915b992a",
    "tranCode": 1,
    "currency": "376",
    "amount": 100,
    "mutag": 1,
    "mutagName": "Mastercard",
    "manpik": 2,
    "solek": 2,
    "cardNumber": "*********",
    "cardNumberOriginalLength": "************************",
    "expDate": "2305",
    "cardName": "Mastercard",
    "tokenizedCardNumber": "c8ae19356dd1d7e946165fab67a14516",
    "tranType": 1,
    "posEntryMode": 5,
    "isClub": false,
    "isPrepaid": false,
    "creditTerms": 1,
    "uid": "23031212432508830123729",
    "rrn": "948767075   ",
    "authCodeManpik": 1,
    "issuerAuthNum": "0652073",
    "acquirerMerchantID": "6543505",
    "sysTraceNumber": "01001001",
    "authorizationCommStat": "{\"connectRetries\":0,\"connectTotalTime\":555,\"authorizationTotalTime\":744,\"smallBlockedTotalTime\":0}",
    "merchantReceipt":[  
         {"fieldName":"׳¡׳›׳•׳","fieldValue":"1000"},
         {"fieldName":"ATC","fieldValue":"0289"}
      ],
      "customerReceipt":[  
         {"fieldName":"׳¡׳›׳•׳","fieldValue":"1000"},
         {"fieldName":"ATC","fieldValue":"0289"}
      ]
   },
   "id":1
}

Response Parameters

The table below describes the response parameters for this method.

Name	Type	Description
`statusCode`	integer	Transaction status. A value of `0` indicates a successful (approved) transaction.
`statusMessage`	string	Transaction message (e.g., `ok`)
`mutag`	integer	Card brand
`solek`	integer	Acquirer
`manpik`	integer	Card Issuer
`uid`	string	Transaction unique identifier
`posEntryMode`	integer	POS Entry Mode, type of card transaction. Values are: `0` (MSR), `5` (CTLS MSR), `40` (Contact EMV), `50` (Phone), `51` (Signature only), `80` (Fallback (err)), `81` (Fallback (no AID))
`cardNumber`	string	Masked personal account number (PAN)
`rrn`	string	Transaction authorization number from the authorized entity
`issuerAuthNum`	string	Issuer authorization number
`acquirerMerchantID`	string	Merchant ID in the acquirer system
`authCodeManpik`	integer	Code of authorization. Values are: `0` (Unauthorized transaction), `1` (Authorized by issuer), `2` (Declined by issuer), `3` (Stip approved ABS), `4` (Stip declined ABS), `5` (Voice approval), `6` (Voice declined), `7` (Approved by issuer pre-auth), `8` (Approved by card)
`gatewayToken`	string	Gateway token of the card
`appVersion`	string	Payment application version
`retailerId`	string	Terminal retailer Id
`ecrNo`	string	POS identifier
`vuid`	string	Vendor unique identifier
`tranCode`	string	Transaction Code
`merchantReceipt`	array of key/value	Merchant receipt to print or save
`customerReceipt`	array of key/value	Customer receipt to print