> 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/central-issuance/ja/wosuru/kdono.md).

# カード注文の追跡

D1 は実物カードの生産および出荷のリアルタイム更新をイシュアのバックエンドに送信します。

通知（ウェブフック）、オンデマンドのステータス、またはその両方を使用します。

### 大まかなフロー

<figure><img src="/files/1129bd0df6248f832dd6a32cace09a858d1614ea" alt=""><figcaption><p>実物カードの生産および出荷イベントの大まかなフロー。</p></figcaption></figure>

### ステータス遷移

この図はリクエストから出荷までの典型的な遷移を示しています。

また、例外および保留のパスも含まれます。

<figure><img src="/files/669535ff212192df9893a6c9f9d1d3c07bb86400" alt=""><figcaption><p>例外および保留状態を含むステータス遷移。</p></figcaption></figure>

<details>

<summary>さらに図表</summary>

<figure><img src="/files/3034fb0a8fc2ba0873db6a54cba8f63037ad9c9a" alt=""><figcaption><p>発行手順と状態変化の運用上のビュー。</p></figcaption></figure>

<figure><img src="/files/ea46ab4011f87075c4eda0b79663e9e13868e69d" alt=""><figcaption><p>実物カード発行中の通知とステータス変更のシーケンス図。</p></figcaption></figure>

</details>

### 仕組み

いずれか一方、または両方のアプローチを使用します。

{% tabs %}
{% tab title="通知（推奨）" %}

* 各生産ステップおよび出荷の更新について通知を受け取ります。
* 少なくとも一度配信（at-least-once）を前提として処理してください。再試行や重複が発生することを想定してください。
* 次に定義されたコールバックエンドポイントを実装してください [バックエンド通知](/central-issuance/ja/d1-wosuru/bakkuendo.md).
  {% endtab %}

{% tab title="オンデマンド" %}

* いつでも現在の生産/出荷ステータスを照会できます。
* 参照 [オンデマンドで注文を追跡する](/central-issuance/ja/wosuru/kdono/nijitewo.md).
  {% endtab %}
  {% endtabs %}

### 必要な API

<table><thead><tr><th width="140.79998779296875">API</th><th width="180.79998779296875">インバウンド/アウトバウンド</th><th>説明</th></tr></thead><tbody><tr><td><a href="/pages/a0da17fc2828bbeb3e08030f8edf54616fd09fb7#post-notifications-d1-v2-issuers-issuerid-cards">通知</a></td><td>イシュア &#x3C;- Thales D1</td><td>次の操作に関する通知を受け取ります <code>PRODUCE</code> 操作。</td></tr></tbody></table>

### API の内容

通知とオンデマンドのレスポンスは同じ operation オブジェクトを使用します。

それらは次を含めることができます：

<table><thead><tr><th width="153.5999755859375">フィールド</th><th width="420.7999267578125">説明</th><th>存在</th></tr></thead><tbody><tr><td><code>operationId</code></td><td>オペレーションインスタンスの一意の識別子。重複排除と相関のために使用します。</td><td>必須</td></tr><tr><td><code>operation</code></td><td>オペレーションタイプ。常に <code>PRODUCE</code> 実物カード発行の追跡用です。</td><td>必須</td></tr><tr><td><code>status</code></td><td>オペレーションのステータス： <code>PENDING</code>, <code>SUCCESSFUL</code>、または <code>FAILED</code>.</td><td>必須</td></tr><tr><td><code>startTime</code></td><td>オペレーションが開始された ISO 8601 タイムスタンプ。</td><td>必須</td></tr><tr><td><code>endTime</code></td><td>オペレーションが完了した ISO 8601 タイムスタンプ。</td><td>条件付き</td></tr><tr><td><code>cardId</code></td><td>D1 内の内部カード識別子。</td><td>必須</td></tr><tr><td><code>details</code></td><td><p>発行固有のペイロード。</p><p>参照 <a href="/spaces/10bY9AeJ5XJK5zO4Waum/pages/567e46cbd56a9839a8613e370b14576a2830f705">生産を追跡する</a> および <a href="/spaces/10bY9AeJ5XJK5zO4Waum/pages/9f9cf3033c93d009efd8a91d1cebd7f59830a420">出荷を追跡する</a>.</p></td><td>必須</td></tr><tr><td><code>errorCode</code></td><td>機械可読の失敗原因。</td><td>条件付き</td></tr><tr><td><code>error</code></td><td>短い人間可読の失敗説明。</td><td>条件付き</td></tr><tr><td><code>inputFileName</code></td><td>カード発行リクエストを含むファイル名。</td><td>条件付き</td></tr><tr><td><code>issuerRequestId</code></td><td>イシュアのバックエンドが提供する相関識別子。</td><td>条件付き</td></tr></tbody></table>

トップレベル `status` はオペレーションのステータスです。

`details.status` は実物カード発行のステータスです。

### 配信と冪等性

通知は順不同で到着したり、複数回届くことがあります。

* を使用して `operationId` イベントの重複排除と相関を行ってください。
* を使用して `startTime`/`endTime` を使用してどのイベントが最新かを判断してください。
* ギャップを検出した場合は、状態を照合するためにオンデマンド API を使用してください。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/central-issuance/ja/wosuru/kdono.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.