カード注文の追跡

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

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

大まかなフロー

実物カードの生産および出荷イベントの大まかなフロー。

ステータス遷移

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

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

例外および保留状態を含むステータス遷移。

さらに図表

発行手順と状態変化の運用上のビュー。

実物カード発行中の通知とステータス変更のシーケンス図。

仕組み

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

通知（推奨）

• 各生産ステップおよび出荷の更新について通知を受け取ります。

• 少なくとも一度配信（at-least-once）を前提として処理してください。再試行や重複が発生することを想定してください。

• 次に定義されたコールバックエンドポイントを実装してください バックエンド通知.

オンデマンド

必要な API

API	インバウンド/アウトバウンド	説明
通知	イシュア <- Thales D1	次の操作に関する通知を受け取ります PRODUCE 操作。

API の内容

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

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

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

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

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

配信と冪等性

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

• を使用して operationId イベントの重複排除と相関を行ってください。

• を使用して startTime/endTime を使用してどのイベントが最新かを判断してください。

• ギャップを検出した場合は、状態を照合するためにオンデマンド API を使用してください。