Card Notification API

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

Request to fetch messages for a specific virtual card

post

This method is used by Wallet Server to fetch messages for a specific virtual card.

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.

lastUpdatedTimestampstring · date-timeOptional

Timestamp used for filtering messages. Messages already provided to wallet server before this timestamp will not be returned. Its format is as specified in RFC 3339

Responses

200

getMessages response payload

application/json

lastUpdatedTimestampstring · date-timeOptional

Timestamp used for filtering messages. Messages already provided to wallet server before this timestamp will not be returned. Its format is as specified in RFC 3339

500

Internal Server Error

post

/getMessages

HTTPcURLJavaScriptPython

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

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-06-17T17:28:37.282Z"
  },
  "walletCardId": "text",
  "lastUpdatedTimestamp": "2026-06-17T17:28:37.282Z"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-06-17T17:28:37.282Z",
    "statusCode": 1,
    "statusMessage": "text"
  },
  "lastUpdatedTimestamp": "2026-06-17T17:28:37.282Z",
  "messages": [
    {
      "identifier": "text",
      "messageDate": "2026-06-17T17:28:37.282Z",
      "expirationDate": "2026-06-17T17:28:37.282Z",
      "content": "text",
      "allowDeepLink": true
    }
  ]
}