---
title: "Status Transaction"
method: POST
path: "/public/statusTransaction"
tags: ["Merchant Portal services API"]
---

# Status Transaction

`POST /public/statusTransaction`

Returns status of a transaction searched by: <b>transactionSeqNumber</b> or by combination of: <b>transactionId + terminalId + sourceId</b><br>
Create MPauditlog table record with event type : StatusTransaction.<br>
Required role: BO_TE_TRANSACTION_HISTORY<br>
Supports authentication with the following types of tokens:<br>
* <b>Bearer</b> &lt;token&gt;, 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> &lt;credentials&gt;, 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> &lt;token&gt;, 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>

## Request body

- StatusTransactionRequest
  - `transactionSeqNumber` integer
  - `transactionId` string
  - `terminalId` integer
  - `sourceId` integer
  - `clientId` integer

## Response `200`

Successful operation

- StatusTransactionResponse
  - `responseCode` integer
  - `responseMessage` string
  - `transactionSeqNumber` integer
  - `transactionId` string
  - `transactionType` string
  - `merchantNumber` string
  - `merchantName` string
  - `terminalId` integer
  - `originalTerminalId` integer
  - `acquirerTerminalId` string
  - `acquirerName` string
  - `amount` integer
  - `currency` string
  - `transactionDate` string, date-time
  - `transactionServerDate` string, date-time
  - `authorizationDate` string, date-time
  - `transactionClearingDate` string, date-time
  - `authorizationCode` string, nullable — Authorization code returned by the acquirer; null when not available
  - `tecsengineResponseCode` integer
  - `tecsengineResponseText` string
  - `responseCodeFromAS` string
  - `receiptNumber` string
  - `cardNumber` string
  - `cardExpiration` string
  - `paymentReason` string
  - `cardBrand` string
  - `retrievalReferenceNumber` string
  - `traceNumber` integer
  - `clientId` integer
  - `originalClientId` string
  - `emvApplicationId` string
  - `emvApplicationLabel` string
  - `cvm` string
  - `applicationCryptogram` string
  - `serviceCode` string
  - `transactionSource` string
  - `cardEntry` string
  - `terminalLocation` string
  - `originalTransactionId` string
  - `clearingStatus` string
  - `clearingAmount` integer
  - `clearingCurrency` string
  - `clearingProcessedDate` string, date-time
  - `clearingBatchId` string
  - `clearingDate` string, date-time
  - `tipAmount` integer
  - `settlementStatus` string
  - `terminalEndOfDayDate` string, date-time
  - `ecrData` string

## Other responses

- `400` — * Transaction not found * Mandator not found * MandatorConfig not found
- `401` — Unauthorized - Authentication failed: * Authorization header was not provided * MandatorId does not match
- `403` — Forbidden - Missing role: BO_TE_TRANSACTION_HISTORY
- `500` — Internal server error

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) · [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluefin-com/merchant-services/revisions/84e973bef72c/schema)