BLbluefin-com
Merchant Portal services API

Payment Manual - Process card payment via TECS XML gateway

Changed on

Processes a card payment via TECS XML gateway.<br> Collects data from request, transforms it to TecsXML message, and sends it for processing.<br> Response from TecsXML is extracted and mapped to JSON response.<br>

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

Transaction ID is generated automatically as YYYYMMDDhhmmss.<br> TX-Origin is set to 2 for SALE, 5 for PRE-AUTH.<br>

Card number must pass Luhn validation.<br> Expiry date must not be in the past (end-of-month check).<br>

Supports authentication with Bearer token.<br>

post/public/paymentManual

Request

  • Base URL
    https://test.tecs.at/merchantservices
  • URL
    https://test.tecs.at/merchantservices/public/paymentManual
  • 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

cardNumberstring required

Card number - 12 to 19 digits, must pass Luhn validation

expDatestring required

Card expiry date in MMYY format

cvcstring

Card verification code - 3-4 digits (optional)

passwordstring

Terminal password sent as Kennwort in TECS XML (optional)

Example request

{
  "terminalId": "88092010",
  "currency": "EUR",
  "amount": 1234,
  "txtype": "SALE",
  "cardNumber": "5413330056003537",
  "expDate": "1027",
  "cvc": "123",
  "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"
}

Changes