Notification API

Download OpenAPI specification

D1-Transit-API-IN-Notification-oas3.yaml

Handle Event

post

https://THALES-PROD/d1/transit/notification/api/v1https://THALES-STG/d1/transit/notification/api/v1

/issuers/{issuerId}/wallets/{walletIndicator}/events/{eventType}/handleEvent

API used by Transit Issuer to trigger events:

• notify transactions (purchase, rides...)
• balance updates
• count updates
• fare products updates
• update and retrieve bundle data
• notify messages (alerts, promotions...)

Path parameters

eventTypestringRequired

Indicates the type of event to be handled.Value can be:

Value	Description
transaction	Used to notify a transaction.
message	Used to notify a message.
update_balance	Used to notify balance update.
update_count	Used to notify count update of a count based fare product.
update_fare_products	Used to update fare products (e.g. purchase of a new product, removal or renewal).
update_bundle_data	Used to notify that a digital card bundle shall be updated.
retrieve_bundle_data	Used to notify that digital card bundle data shall be retrieved.

issuerIdstring · max: 10Required

Issuer unique identifier. Assigned by Thales during onboarding.

walletIndicatornumberRequired

Indicates which digital wallet is involved in the use case.

Value	Description
1	Apple
2	Google
3	Samsung

Body

application/json

digitalCardIdstring · max: 64Optional

Digital card unique identifier

Example: DGGLSW8D8AC610566D4EF09C22186B2A5ED756

cardAccountIdstring · max: 64Required

Card account unique identifier

Example: FAPLSW8D8AC610566D4EF09C22186B2A5ED793

eventTimestring · date-timeRequired

The event time

Responses

200Success

application/json

500

An unexpected error occurred while processing the request. The request cannot be retried. Only used in cases where it's not be possible to provide more information about what went wrong with the request (i.e. return HTTP 200 with 'responseContext').

503

Indicates that the system is unavailable. The request can be retried.

post/issuers/{issuerId}/wallets/{walletIndicator}/events/{eventType}/handleEvent

HTTPcURLJavaScriptPython

POST /d1/transit/notification/api/v1/issuers/{issuerId}/wallets/{walletIndicator}/events/{eventType}/handleEvent HTTP/1.1
Host: THALES-PROD
Content-Type: application/json
Accept: */*
Content-Length: 279

{
  "requestContext": {
    "requestId": "493f7686-93a0-494a-a44f-867fcd10ce22",
    "correlationId": "bfd8450f-a605-4427-9714-1d620f14dda1"
  },
  "digitalCardId": "DGGLSW8D8AC610566D4EF09C22186B2A5ED756",
  "cardAccountId": "FAPLSW8D8AC610566D4EF09C22186B2A5ED793",
  "eventTime": "2026-07-14T14:13:20.770Z"
}

{
  "responseContext": {
    "requestId": "a762c0a1-2ae7-42b1-a4d8-8d8ba09bdf30",
    "statusCode": 0,
    "statusMessage": "OK"
  }
}