BLbluefin-com
Merchant Portal services API

Payment SRED - Process card-present SRED payload via DecryptX and TECS XML gateway

Changed on

Processes a card-present SRED payload by decrypting device data via DecryptX API, then authorizing via TECS XML gateway.<br>

<b>Flow:</b><br>

  1. Decrypt device payload via DecryptX API (partnerId, partnerKey, deviceType, devicePayload)<br>
  2. Extract PAN (12-19 digits, Luhn-valid), EXPY (MMYY), ServiceCode<br>
  3. Build and send TECS XML authorization request<br>
  4. Parse and return response with SRED data<br>

Required role for operation: BO_VIRTUAL_TERMINAL or VIRTUAL_TERMINAL.<br> Create MPauditlog record with event type : PaymentSred (36).<br>

Transaction ID is generated automatically as YYYYMMDDhhmmss.<br> TX-Origin is set to 2 for SALE, 5 for PRE-AUTH.<br> CVC2 = ServiceCode from decrypted payload.<br>

Supports authentication with Bearer token.<br>

post/public/paymentSred

Request

  • Base URL
    https://test.tecs.at/merchantservices
  • URL
    https://test.tecs.at/merchantservices/public/paymentSred
  • Auth
    HTTP bearer

Request body

terminalIdstring required

Terminal ID - 8 digits

currencystring required

Currency code - 3 uppercase letters (ISO 4217)

amountinteger required

Transaction amount in minor units (cents)

txtype'SALE' | 'PRE-AUTH' required

Transaction type

devicePayloadstring required

SRED encrypted device payload from the device (minimum 32 characters)

passwordstring

Terminal password sent as Kennwort in TECS XML (optional)

Example request

{
  "terminalId": "88092010",
  "currency": "EUR",
  "amount": 1234,
  "txtype": "SALE",
  "devicePayload": "<SRED_PAYLOAD_FROM_DEVICE>",
  "password": "testPWD"
}

Response

Successful operation

responseCodestring

Response code - 00 for success, otherwise error code

responseMessagestring

Response message - 'Approved' for success, error description otherwise

transactionIdstring

Transaction ID generated by the backend

originalTransactionIdstring

Original transaction ID from gateway

terminalIdstring

Terminal ID used for the transaction

dateTimeTxstring

Date and time of the transaction

authorizationNumberstring

Authorization number from the gateway

merchantIdstring

Merchant ID (VU-NUMMER)

acquirerNamestring

Acquirer name parsed from KKG field

cardTypestring

Card type parsed from KKG field

Example response

{
  "responseCode": "00",
  "responseMessage": "Approved",
  "transactionId": "20251008160321",
  "terminalId": "88092010",
  "dateTimeTx": "20251008160321",
  "merchantId": "123456789012345",
  "acquirerName": "TECS Offline",
  "cardType": "MASTERCARD",
  "sred": {
    "panMasked": "541333******3537",
    "expDate": "1027",
    "serviceCode": "201",
    "device": "IDTECH",
    "serial": "1234567890",
    "mode": "SRED"
  }
}

Changes