トラッキングハブ

Thales D1 外で製造された物理カードの製造、発送、または返却の更新を受け取るには、トラッキングハブを使用します。

フロー

1. イシュアのバックエンドによるカード追跡リクエスト

2. D1 は配送業者に接続して出荷情報を取得します

3. 配送業者は定期的に出荷状況を送信します

4. D1 は状況を整形してイシュアのバックエンドに送信します

シーケンス図

仕組み

製造

• 使用 trackingType = PRODUCTION 製造完了の更新を受け取ります。

• Thales D1 は次の内容を含む通知を1件送信します status = SUCCESSFUL.

• 通知には次が含まれます details.status = CARD_SHIPPED.

発送

返却

必要なAPI

API	受信/送信	説明
トラッキングハブ	イシュア -> Thales D1	物理カードの製造、発送、または返却の追跡を要求します。
通知	イシュア <- Thales D1	次の通知を受信します STANDALONE_TRACKING 操作。

API入力

必須の D1 API 入力:

• issuerId: イシュアの一意の識別子。

• cardId: カードの一意の識別子。

• trackingType：実行する追跡の種類。サポートされている値は 製造, 発送、および 返却.

例

追跡タイプ = PRODUCTION

{
  "trackingType": "PRODUCTION",
  "productionSite": "London"
}

追跡タイプ = SHIPMENT

{
  "trackingType": "SHIPMENT",
  "trackingNumber": "61293150000079650811",
  "shipmentDate": "2023-01-21T17:32:28Z",
  "productionSite": "London",
  "postalCode": "WC2N5DU",
  "countryCode": "GB"
}

追跡タイプ = RETURN

{
  "trackingType": "RETURN",
  "productionSite": "London"
}

結果を追跡する

通知を受信するのは STANDALONE_TRACKING 操作。

主要フィールド：

• operation：常に STANDALONE_TRACKING.

• status：オペレーションのステータス。値は PENDING, SUCCESSFUL、または FAILED.

• cardId：リクエストで使用されるカード識別子。

• details.trackingType: 製造, 発送、または 返却.

• details.productionSite：利用可能な場合の製造サイト識別子。

• details.status：次のような追跡結果： CARD_SHIPPED または CARD_RETURNED.

• details.shipment：次の配送追跡の詳細 発送 更新。参照 出荷を追跡.

最上位 status はオペレーションのステータスです。

details.status はビジネス追跡ステータスです。

通知は複数回届くことがあり、順不同で届くこともあります。 operationId 重複排除するために使用します。

追跡タイプ別の通知順序：

trackingType	送信される通知
製造	次を含む1件の通知 status = SUCCESSFUL と details.status = CARD_SHIPPED.
返却	次を含む1件の通知 status = SUCCESSFUL と details.status = CARD_RETURNED.
発送	次を含む1件の通知 status = PENDING、その後、次を含む1件以上の通知 status = SUCCESSFUL が、配送更新が利用可能になるたびに送信されます。

通知の例

追跡タイプ = PRODUCTION

{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "状態": "成功",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "タイムスタンプ": "2026-05-22T09:38:00Z",
  "詳細": {
    "trackingType": "PRODUCTION",
    "生産サイト": "PERSO-CENTER-FR-01",
    "状態": "カード発送済み"
  }
}

トラッキング種別 = SHIPMENT — 初回通知

{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "status": "PENDING",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T09:38:05Z",
  "詳細": {
    "trackingType": "SHIPMENT",
    "生産サイト": "PERSO-CENTER-FR-01",
    "状態": "カード発送済み"
  }
}

トラッキングタイプ = SHIPMENT — 後続の通知（出荷詳細付き）

{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "状態": "成功",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T14:12:33Z",
  "詳細": {
    "trackingType": "SHIPMENT",
    "生産サイト": "PERSO-CENTER-FR-01",
    "status": "CARD_SHIPPED",
    "shipment": {
      "carrier": "fedex",
      "trackingNumber": "1234567890",
      "status": "IN_TRANSIT",
      "message": "輸送中", 
      "trackingUrl": "https://www.fedex.com/track?trk=1234567890",
      "estimatedDeliveryDate": "2026-05-24T00:00:00Z",
      "lastUpdatedAt": "2026-05-22T13:55:00Z",
      "lastCheckpoint": {
        "checkpointTime": "2026-05-22T13:55:00Z",
        "city": "パリ",
        "countryName": "フランス",
        "message": "施設に到着しました"
      }
    }
  }
}

追跡タイプ = RETURN

{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "状態": "成功",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-25T10:02:11Z",
  "詳細": {
    "trackingType": "RETURN",
    "生産サイト": "PERSO-CENTER-FR-01",
    "status": "CARD_RETURNED"
  }
}