API de notificaciones

TES-IN-v1-notificaciones-de-tránsito.yaml

Request to send a message to enduser device

post

This method is used by TES to request TSH to send a message on the enduser device targeting a virtual card.

Cuerpo

application/json

issuerIdstring · mín: 1 · máx: 16Requerido

The Card Issuer Identifier. Unique for each card issuer.

cardIdstring · mín: 1 · máx: 48Requerido

The Card Identifier. Unique for each card.

messageDateTimestring · date-timeRequerido

Date time representing when the message has been generated.RFC3339 format. Examples:"2018-12-24T17:32:28Z""2019-10-02T10:00:00-05:00"

expirationDateTimestring · date-timeRequerido

Date time representing when the message is no longer valid and should be removed.RFC3339 format. Examples:"2018-12-24T17:32:28Z""2019-10-02T10:00:00-05:00"

contentstring · mín: 1 · máx: 128Requerido

Plain text message to be displayed to the user.

allowDeepLinkbooleanRequerido

A flag indicating if the message should "deep link" to the issuer's mobile application

Respuestas

200

sendMessage response payload

application/json

500

Internal Server Error

post/sendMessage

HTTPcURLJavaScriptPython

POST /tsh/ttnapi/1/0/sendMessage HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 270

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-07-11T15:48:19.035Z"
  },
  "issuerId": "text",
  "cardId": "text",
  "messageDateTime": "2026-07-11T15:48:19.035Z",
  "expirationDateTime": "2026-07-11T15:48:19.035Z",
  "content": "text",
  "allowDeepLink": true
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-07-11T15:48:19.035Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}