Webhook Event Codes

Use the Webhook Event Codes pages to understand and configure the webhook notifications available through Thredd's Event Delivery Service.

Webhook Event Codes

Thredd’s Event Delivery Service uses event codes to identify the type of webhook notification being sent. Each event code has its own payload structure, example request, example notification response, and field descriptions.

Use this page to find the event code you want to configure or understand.

Available event codes

Event codeEvent nameDescription
101Fraud Rule Triggered by a TransactionSent when a fraud rule is triggered by a transaction.
102Fraud Acknowledgement NotificationSent when a fraud alert is closed, acknowledged, or times out.
103Card Status ChangeSent when a card status changes.
104Custom PAN CreationSent when a card with a custom PAN has been created.
105Payment Manual Review OutcomeSent when a pending payment has been reviewed in Scam Transaction Monitoring.
106Tokenisation Authorisation Request (TAR)Sent when a Tokenisation Authorisation Request is received.
107Activation Code Notification (ACN)Sent when an activation code notification is generated.
108Tokenisation Complete Notification (TCN)Sent when tokenisation has completed.
109Tokenisation Event Notification (TEN)Sent when a tokenisation lifecycle event occurs.
110Tokenisation Status Update Failure Notification (TFN)Sent when a token status update fails.
111Apata Finalised EventSent when Apata sends a finalised 3D Secure event.
112Transaction Confirmation EventSent for transaction confirmation notifications.
115FTM Alert CreationSent when a new alert is created in Fraud Transaction Monitoring.
117Open Banking RegistrationSent when a customer interacts with an Open Banking registration session.
119Card Lifecycle NotificationSent when a card is created or activated, allowing clients to receive asynchronous card lifecycle updates.
121Card Creation FailureSent when there is a card creation failure during the customised card creation process.
📘

Note

Event Code 103 (Card Status Change) sends notifications asynchronously only, as messages are processed in batches. Clients will not receive notifications in a specific order. If a client requires ordered processing, you must use the notification timestamp provided in the payload to ensure proper sequencing.

How webhook event pages are structured

Each event code page includes:

  • when the event is sent
  • any onboarding or configuration requirements
  • an example webhook configuration request
  • an example notification response
  • field descriptions for the response payload

Did this page help you?