通知 API

OpenAPI仕様をダウンロード

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...)

パスパラメータ

eventTypestring必須

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 · 最大: 10必須

Issuer unique identifier. Assigned by Thales during onboarding.

walletIndicatornumber必須

Indicates which digital wallet is involved in the use case.

Value	Description
1	Apple
2	Google
3	Samsung

本文

application/json

digitalCardIdstring · 最大: 64オプション

Digital card unique identifier

Example: DGGLSW8D8AC610566D4EF09C22186B2A5ED756

cardAccountIdstring · 最大: 64必須

Card account unique identifier

Example: FAPLSW8D8AC610566D4EF09C22186B2A5ED793

eventTimestring · date-time必須

The event time

レスポンス

200成功

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-08-07T21:32:47.767Z"
}

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