Event Code 119 - Card Lifecycle Notification

Use the Card Lifecycle Notification webhook to receive a notification when a new card is activated.

The 119 event code is an issuer-level webhook that sends near real-time notifications when a card is created or activated, allowing clients to receive asynchronous card lifecycle updates through Thredd Webhooks.

{
  "productId": 12345,
  "events": [119],
  "webhookStatus": "active",  
  "config": {
    "url": "https://client_domain.com/webhook",
    "customHeaders": {
      "header1": "value_1",
      "header2": "value_2"
    }
  }
}

After the webhook has been successfully set up, when a card is created or activated, a notification response is sent asynchronously from the Event Delivery Service to the URL specified in the webhook. See the below example of a response.

{
  "context": {
    "notificationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "eventCode": 119,
    "eventVersion": "v1",
    "notificationTime": "2026-07-29T13:20:00Z"
  },
  "payload": {
    "programManagerCode": "THREDD",
    "publicToken": 123456789,
    "customerCode": "CUST001234",
    "productId": 123,
    "cardCreationTimestamp": "2026-07-29T13:19:45Z",
    "cardActivationDate": "2026-07-29T13:20:00Z",
    "cardStatusAtCreation": "00",
    "cardType": "virtual",
    "cardScheme": "VISA",
    "maskedPan": "47617345********",
    "countryOfResidence": "GBR",
    "environment": "PRD2",
    "trackingId": "80b83f64-526e-4d25-84c7-32b6e47c02f8"
  }
}

The below table describes each of the fields included in the notification response.

Field	Description
context	Object that contains the context of the notification, such as the event code.
notificationId	Unique identifier of the notification.
eventCode	The event code. In this case, the event code is 119.
eventVersion	The event version.
notificationTime	When the notification was created. Time in the UTC format of 'yyyy-MM-ddTHH:mm:ssZ'.
payload	Object that contains the payload of the notification, which is specific to the event code.
programManagerCode	The program manager code associated with the card programme.
publicToken	The Thredd public token representing the card.
customerCode	The customer identifier associated with the cardholder or client record.
productId	The Thredd product identifier used to derive issuer-level routing for the notification.
cardCreationTimestamp	The UTC timestamp for when the card record was created.
cardActivationDate	The UTC timestamp for when the card became activated or available.
cardStatusAtCreation	The card status value present when the notification is created.
cardType	The type of card. For example, `virtual` or `physical`.
cardScheme	The card scheme or network. For example, `VISA` or `MCRD`.
maskedPan	The masked PAN presented in a non-sensitive format for client reference.
countryOfResidence	The ISO 3166-1 alpha-3 country code for the cardholder's country of residence. For example, `USA`.
environment	The Thredd environment that produced the notification.
trackingId	The correlation identifier used for tracing and operational support.

Updated about 24 hours ago

Did this page help you?