v1

latestOpenAPI 3.1.02026-07-24153164.0 KB
Merchant Portal services API

Refund Transaction

Searches for a transaction by given parameters: <b>originalTransactionId + terminalId + sourceId</b><br> and sends a Refund via TecsXml Interface.<br> Required role for operation: BO_TRANSACTIONMANAGEMENT_REFUND.<br> Create MPauditlog table record with event type : RefundTransaction.<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/refundTransaction

Request body

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

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