Event Code 112 - Transaction Confirmation Event

The Transaction Confirmation (TC) events are a notification sent using Thredd's webhook service for transaction confirmations (Event Code = 112).

{
  "productId": 12345,
  "events": [112],
  "webhookStatus": "active",  
  "config": {
    "url": "https://client_domain.com/webhook",
    "customHeaders": {
      "header1": "value_1",
      "header2": "value_2"
    }
  }
}

After the webhook has been successfully set up, you will start to receive TC events based on the configuration of your webhook and a notification response is sent asynchronously from the Event Delivery Service to the URL specified in the webhook. See the below example of a response.

{
"context": {
"notificationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"eventCode": 112,
"eventVersion": "v1",
"notificationTime": "2024-01-24T23:20:28Z"
},
"payload": {
"network": "Visa",
"subnetwork": "STAR",
"programManagerCode": "FTX",
"programManagerName": "FintechX",
"programManagerResponse": "00",
"actualBalance": "1500.0000",
"additionalAmount": "50.0000",
"transactionFee": "2.00",
"processorAuthorisationCode": "134822",
"acquiringInstitutionId": "06003758",
"acquirerForwarderId": "000405700",
"availableBalance": "1480.0000",
"billingAmount": "100.0000",
"billingCurrency": "840",
"blockedAmount": "0.0000",
"customerAccount": "CUST123456",
"fxPadding": "1.25",
"fixedFee": "0.0000",
"rateFee": "0.0000",
"mcc": "5411",
"mccDescription": "Grocery Stores",
"mccPadding": "0.50",
"merchantId": "MID98765",
"merchantName": "Walmart NY",
"transactionNote": "Weekly grocery purchase",
"localTransactionTime": "010107",
"localTransactionDate": "20250626",
"processingCode": "000000",
"schemeResponseCode": "00",
"token": "123456789",
"transactionAmount": "100.0000",
"transactionCurrency": "840",
"acceptorCountryCode": "USA",
"transactionDescription": "POS Purchase",
"processorTransactionDateTime": "2025-05-28T10:15:17Z",
"transactionId": "789456123",
"transactionStatusCode": "A",
"transactionType": "A",
"isThreddAuthorised": "Y",
"avsResult": "Y",
"mtid": "0100",
"productId": "1234",
"velocityGroup": "VG01",
"posCapability": "0001000000000100000000000000000000100000000230000",
"posData": "58V9000900000Px100",
"transactionLifeCycleId": "VIS1-20160608-086160508692217",
"transLink": "250415787144555555",
"retrievalReferenceNumber": "510559697285",
"posTerminal": "ECOMM001",
"networkFraudData": "",
"paymentTokenId": "998877",
"paymentTokenWallet": "APPLE",
"schemeTransactionIdentifier": "SCM123456789012345",
"terminalCity": "London",
"processorResponseCode": "00"
}
}

The below table describes each of the fields included in the notification response.

Field	Description	Type	Required
context	The context object.
notificationId	Unique identifier of the notification.	String	Yes
eventCode	The event code of the event.	Integer	Yes
eventVersion	The version of the event.	String	Yes
notificationTime	Notification created time in the UTC format of 'yyyy-MM-ddTHH:mm:ssZ'.	String	Yes
subnetwork	Merchant routing network (STAR, Pulse, DGN), Value only present for MNE transactions.	String	No
payload	The payload object.
acceptorCountryCode	Transaction country (ISO 3-alpha). For example, "USA".	String	No
acquirerForwarderId	Identifies the acquiring institution forwarding a Request or Advice message.	String	No
acquiringInstitutionId	The Acquiring Bank ID as assigned by the network.	String	No
actualBalance	Actual balance after transaction (in the card account currency).	String	No
additionalAmount	The additional amount (DE54).	String	No
availableBalance	Available balance after transaction.	String	No
avsResult	The Address Verification System (AVS) result.	String	No
billingAmount	Settlement billing amount.	String	No
billingCurrency	Billing currency (ISO 3-digit numeric).	String	No
blockedAmount	Blocked amount after transaction.	String	No
customerAccount	The customer account reference.	String	No
fixedFee	Total fixed fee amount.	String	No
fxPadding	Foreign currency padding.	String	No
isThreddAuthorised	Indicates if the transaction is authorised by Thredd. "Y" or "N".	String	No
localTransactionDate	Terminal local date of transaction. MMDD with YYYY added by Thredd. YYYY='0000' if MMDD invalid.	String	No
localTransactionTime	Local merchant transaction time.	String	No
mcc	Merchant Category Code. 4-digit MCC.	String	No
mccDescription	MCC description.	String	No
mccPadding	MCC padding.	String	No
merchantId	Merchant ID.	String	No
merchantName	Merchant name and location.	String	No
mtid	The Message Type Identifier. For example, "0100" or "0400".	String	No
network	Primary card network (Visa, Mastercard, DGN).	String	Yes
networkFraudData	Fraud or Risk Indicators received from the card network. For example, Visa: '011099 1122 013099 33'	String	No
paymentTokenId	Payment token ID.	String	No
paymentTokenWallet	Wallet the payment token belongs to. For example, APPLE (For Apple Pay Wallet) or SAMSUNG (For Samsung Pay Wallet).	String	No
posCapability	POS capability codes.	String	No
posData	POS data codes.	String	No
posTerminal	POS Terminal ID.	String	No
processingCode	Processing code for transaction.	String	No
processorAuthorisationCode	Authorisation code generated by Thredd for approved and declined authorisation requests.	String	No
processorResponseCode	Response code sent by the processor (Thredd) to the scheme. For example, "00" or "05". For advice messages where a decline is received from the scheme, this field may contain "00" while schemeResponseCode reflects the actual decline code.	String	No
processorTransactionDateTime	Date and time of processing. Format: yyyy-MM-ddTHH:mm:ssZ	String	No
productId	The Product ID of the card.	String	Yes
programManagerCode	The Program Manager code.	String	Yes
programManagerName	The Program Manager name.	String	No
programManagerResponse	The Program Manager response. Empty for EHI mode 3 transactions, Thredd generated transactions and non-EHI transactions.	String	No
rateFee	Total percentage rate fee amount.	String	No
retrievalReferenceNumber	Retrieval Reference Number.	String	No
schemeResponseCode	Response code received from the scheme. For advice messages with a decline response code from the scheme, this field shows the actual scheme response code. For example, "00" or "05".	String	No
schemeTransactionIdentifier	Unique identifier assigned by the card scheme for the transaction. This value can be used to classify transaction types, such as peer-to-peer (P2P) and non-P2P transactions, and to support reconciliation and reporting.	String	No
subnetwork	Merchant routing network (STAR, Pulse, DGN), Value only present for MNE transactions.	String	No
terminalCity	City associated with the merchant terminal location. This value can be used for city-level transaction analysis, fraud detection, and risk monitoring.	String	No
token	Thredd public token of card.	String	Yes
transactionAmount	The transaction amount.	String	Yes
transactionCurrency	Transaction currency (ISO 3-digit). For example, "840".	String	Yes
transactionDescription	Description of the transaction.	String	No
transactionFee	The transaction fee (DE28).	String	No
transactionId	Unique transaction ID.	String	Yes
transactionLifeCycleId	Lifecycle Trace ID.	String	Yes
transactionNote	Note about the transaction.	String	No
transactionStatusCode	Transaction status code.	String	No
transactionType	The transaction type.	String	Yes
transLink	Identifier to link related transactions.	String	No
velocityGroup	Velocity group code.	String	No