Transaction Notification API

TSP-API-IN-v1-Transaction-Notification-oas2.yaml

Submit token transaction details

put

This method is used by TSP to send the detailed result of a transaction from a token

Path parameters

transactionIdstring · min: 1 · max: 64Required

Transaction identifier

Header parameters

x-request-idstring · min: 1 · max: 64Required

Unique request identifier use to trace function calls across system

x-wallet-indicatornumberOptional

Indicator used to specify which wallet type performed the transaction.
Possible values are:

• 1 for Apple Pay
• 2 for Google Pay
• 3 for Samsung Pay
• 4 for Huawei Pay
• 5 for HCE Issuer Wallets

Body

application/json

issuerIdstring · min: 10 · max: 10Required

Unique Identifier of Issuer

tokenIdstring · min: 1 · max: 48Required

Unique token identifier.For Apple Pay International Card Scheme transactions, ICS DPANID shall be used.

Responses

204

successful

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter. Possible error codes are 111, 112, 113, 119, 911, 921

application/json

500

Internal Server Error

put

/token-transactions/{transactionId}

HTTPcURLJavaScriptPython

PUT /tns-dispatcher/tsh/tnapi/v1.0/token-transactions/{transactionId} HTTP/1.1
Host: api.dbp.thalescloud.io
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 446

{
  "issuerId": "text",
  "tokenId": "text",
  "transactionInfo": {
    "transactionType": "PURCHASE",
    "transactionResult": "APPROVED",
    "transactionResultReason": 1,
    "linkedTransactionId": "text",
    "transactionIdentifier": "text",
    "totalAmount": 1,
    "currency": "text",
    "merchant": "text",
    "rawMerchantName": "text",
    "merchantCity": "text",
    "merchantZip": "text",
    "merchantCountryCode": "text",
    "industryCategory": "text",
    "industryCode": "text",
    "transactionDate": "2026-06-08T16:36:40.510Z"
  }
}

No content

Submit card transaction details

put

This method is used by TSP to send the detailed result of a transaction from a funding card

Path parameters

transactionIdstring · min: 1 · max: 64Required

Transaction identifier

Header parameters

x-request-idstring · min: 1 · max: 64Required

Unique request identifier use to trace function calls across system

Body

application/json

issuerIdstring · min: 10 · max: 10Required

Unique Identifier of Issuer

cardIdstring · min: 1 · max: 64Required

Identifier of the funding card

Responses

204

successful

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter. Possible error codes are 111, 112, 113, 116, 911, 921

application/json

500

Internal Server Error

put

/card-transactions/{transactionId}

HTTPcURLJavaScriptPython

PUT /tns-dispatcher/tsh/tnapi/v1.0/card-transactions/{transactionId} HTTP/1.1
Host: api.dbp.thalescloud.io
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 385

{
  "issuerId": "text",
  "cardId": "text",
  "transactionInfo": {
    "transactionType": "PURCHASE",
    "transactionResult": "APPROVED",
    "transactionResultReason": 1,
    "totalAmount": 1,
    "currency": "text",
    "merchant": "text",
    "rawMerchantName": "text",
    "merchantCity": "text",
    "merchantZip": "text",
    "merchantCountryCode": "text",
    "industryCategory": "text",
    "industryCode": "text",
    "transactionDate": "2026-06-08T16:36:40.510Z"
  }
}

No content