v1

latestOpenAPI 3.1.02026-07-24153164.0 KB
Merchant Portal services API

PreAuthCompletion Transaction

Searches for a transaction by given parameters: <b>originalTransactionId + terminalId + sourceId</b><br> and sends a PreAuthCompletionTransaction via TecsXml Interface.<br> Send XML MessageType: 0013 and TransactionOriginId: 4<br> Required role for operation: BO_TRANSACTIONMANAGEMENT_COMPLETION.<br> Create MPauditlog table record with event type : CompleteTransaction.<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>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/preAuthCompletionTransaction

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