> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-digitization/ja/apple-transit-wosuru/akauntobsunochikettingu-abt/qu-yin-tong-zhi.md).

# 取引通知

通知はTransit イシュアによってトリガーされ、ウォレット内に旅行イベントを表示できるようにします。トランジットカードが小売での購入に対応している場合は、購入も通知されることがあります。

このセクションでは、詳細な手順、シーケンス図、および潜在的なエラーシナリオを含むワークフローの概要を提供します。

### ワークフロー <a href="#workflow" id="workflow"></a>

以下はメッセージ通知ワークフローのハイレベルな手順です：

1. **通知の開始** : Transit イシュアがD1 Transitに対して、対象のデジタルカードへ取引通知を送信するよう指示します。
2. **デバイス通知**: D1 Transitは適切なデバイスにプッシュ通知を送信するためにAPNSを使用します。
3. **取引詳細の取得**: デバイスは取引詳細を取得するためにD1 Transitプラットフォームに接続します。

### シーケンス図 <a href="#sequence-diagram" id="sequence-diagram"></a>

#### 通知の開始 <a href="#notification-initiation" id="notification-initiation"></a>

Transit イシュアはhandleEvent APIを使用して、指定されたデジタルカードに取引通知を送信するようD1 Transitに指示します。

#### デバイス通知と取引詳細の取得 <a href="#device-notification-and-transaction-details-retrieval" id="device-notification-and-transaction-details-retrieval"></a>

D1 TransitプラットフォームはAPNSを使用してデバイスにプッシュ通知を送信します。デバイスは取引詳細を取得するためにD1 Transitに接続し、D1 Transitはそれらの詳細をTransit イシュアから取得します。

**エラーシナリオ**

**デバイスがオフライン**

デバイスがオフラインの場合、取引詳細を通知するリクエストはキューに入れられ、再接続され次第デバイスに送信されます。

<figure><img src="https://931441515-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZoFRCpZeaDWwcHYhJY7B%2Fuploads%2Fx3mBrFwsJqFzW578EZAA%2FSequence%20Diagram%20%E2%80%93%20%20Transaction%20Notification.svg?alt=media&amp;token=f4cda7f2-2ea0-4aee-983a-280589cadf1c" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.payments.thalescloud.io/transit-digitization/ja/apple-transit-wosuru/akauntobsunochikettingu-abt/qu-yin-tong-zhi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
