API de Notificaciones de Tarjeta

WS-Transit-API-OUT-transit-notif-oas2.yaml

Request to push a notification to enduser device

post

This method is used by TSH to request Wallet Server to send a push notification on the enduser device for a specific virtual card. Wallet server shall take care of the notification deivery to the device.

Parámetros de encabezado

x-podstring · máx: 128Requerido

HTTP header identifying the pod and corresponding DNS hostname of the load balancer from which traffic is coming. Subsequent API calls should be sent to this pod.

Cuerpo

application/json

walletCardIdstring · mín: 1 · máx: 64Requerido

The Wallet Card Identifier. Unique for each wallet card.

seIdstringRequerido

Secure Element Identifier

Pattern: ([0-9a-fA-F][0-9a-fA-F]){1,24}

Respuestas

200

pushNotification response payload

application/json

500

Internal Server Error

post

/pushNotification

HTTPcURLJavaScriptPython

POST /pushNotification HTTP/1.1
x-pod: text
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-06-17T17:31:28.568Z"
  },
  "walletCardId": "text",
  "seId": "text"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-06-17T17:31:28.568Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}