v1
latestOpenAPI 3.0.02026-07-2352269214.0 KBHandle Event
API used by Transit Issuer to trigger events:
<li>notify transactions (purchase, rides...) <li>balance updates <li>count updates <li>fare products updates <li>update and retrieve bundle data <li>notify messages (alerts, promotions...)post/issuers/{issuerId}/wallets/{walletIndicator}/events/{eventType}/handleEvent
Path parameters
eventTypestring required
Indicates the type of event to be handled.<br/>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 required
Issuer unique identifier. Assigned by Thales during onboarding.
walletIndicatornumber required
Indicates which digital wallet is involved in the use case.
| Value | Description |
|---|---|
| 1 | Apple |
| 2 | |
| 3 | Samsung |