Card Notification API

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.

Header parameters

x-podstring · max: 128Required

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.

Body

application/json

walletCardIdstring · min: 1 · max: 64Required

The Wallet Card Identifier. Unique for each wallet card.

seIdstringRequired

Secure Element Identifier

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

Responses

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-13T15:56:42.831Z"
  },
  "walletCardId": "text",
  "seId": "text"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-06-13T15:56:42.831Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}