v1

latestOpenAPI 3.1.02026-07-24153164.0 KB
Merchant Portal services API

Cancel Transaction

Searches for a transaction by given parameters: <b>originalTransactionId + terminalId + sourceId</b> <br> and cancels it via TecsXml Interface.<br> Required role for operation: BO_TRANSACTIONMANAGEMENT_CANCEL.<br> Create MPauditlog table record with event type : CancelTransaction.<br> Supports authentication with the following types of tokens:<br>

  • <b>Bearer</b> <token>, which is a Bearer token authentication. The bearer token is a cryptic string, usually generated by the server in response to a login request.
  • <b>Basic</b> <credentials>, where credentials is the Base64 encoding of username and password joined by a single colon :, CAS login service will be called for the given username and password for validating credentials.
  • <b>TecsWebToken</b> <token>, is used for verifying a TecsWeb signature. Token must be hashed with SHA-256 algorithm in HEX format and constructed in format: <pre>transactionId + | + terminalId + | + secretKey</pre>
post/public/cancelTransaction

Request body

transactionIdstring required
messageTypestring required
terminalIdinteger required
clientIdinteger required
originalTransactionIdstring required
cvcstring
amountinteger required
currencystring required
receiptNumberstring required
paymentReasonstring
terminalLocationstring
passwordstring
ecDatastring
ecrDatastring
emvDatastring
languageCodestring
receiptLayoutinteger
transactionDatestring required

Example request

{
  "transactionDate": "20230509114131"
}

Response

Successful operation

responseCodeinteger
responseMessagestring
transactionIdstring
messageTypestring
cardNumberstring
originalTransactionIdstring
amountinteger
ecrDatastring
emvDatastring
userDatastring
transactionDatestring date-time
authorizationCodestring
txTypestring
acquirerNamestring
acquirerIdstring
cardBrandstring
merchantNumberstring
serialNumberstring
traceNumberinteger
originalTraceNumberinteger
svcstring
balanceAmountstring
exchangeRatestring
merchantNamestring
merchantAddressstring
receiptHeaderstring
receiptFooterstring
actualBonusPointsstring
exchangeFeeinteger