Merchant Portal services API

PreAuthCompletion Transaction

Changed on

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

  • Base URL
    https://test.tecs.at/merchantservices
  • URL
    https://test.tecs.at/merchantservices/public/preAuthCompletionTransaction
  • Auth
    • HTTP bearer
    • or API key in header TecsWebToken

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

Changes

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status