Tracking hub

Use tracking hub to receive production, shipment, or return updates for a physical card produced outside Thales D1.

Flow

1. Issuer back-end request to track the card

2. D1 Connects to carriers to retrieve shipment information

3. Carriers sends regular shipment statuses

4. D1 formats and sends the statuses to Issuer back-end

Sequence diagram

How it works

PRODUCTION

• Use trackingType = PRODUCTION to receive a production completion update.

• Thales D1 sends one notification with status = SUCCESSFUL.

• The notification includes details.status = CARD_SHIPPED.

SHIPMENT

RETURN

Required APIs

API	Inbound/Outbound	Description
Tracking hub	Issuer -> Thales D1	Request production, shipment, or return tracking for a physical card.
Notifications	Issuer <- Thales D1	Receive notifications for the STANDALONE_TRACKING operation.

API Inputs

Required D1 API inputs:

• issuerId: Unique identifier of the issuer.

• cardId: Unique identifier of the card.

• trackingType: Type of tracking to perform. Supported values are PRODUCTION, SHIPMENT, and RETURN.

Examples

Tracking type = PRODUCTION

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

Tracking type = SHIPMENT

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

Tracking type = RETURN

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

Track the result

Consume notifications on the STANDALONE_TRACKING operation.

Key fields:

• operation: Always STANDALONE_TRACKING.

• status: Operation status. Values are PENDING, SUCCESSFUL, or FAILED.

• cardId: Card identifier used in the request.

• details.trackingType: PRODUCTION, SHIPMENT, or RETURN.

• details.productionSite: Production site identifier, when available.

• details.status: Tracking result, such as CARD_SHIPPED or CARD_RETURNED.

• details.shipment: Shipment tracking details for SHIPMENT updates. See Track shipment.

Top-level status is the operation status.

details.status is the business tracking status.

Notifications can arrive more than once, and they can arrive out of order. Use operationId to de-duplicate events.

Notification sequence by tracking type:

trackingType	Notifications sent
PRODUCTION	One notification with status = SUCCESSFUL and details.status = CARD_SHIPPED.
RETURN	One notification with status = SUCCESSFUL and details.status = CARD_RETURNED.
SHIPMENT	One notification with status = PENDING, then one or more notifications with status = SUCCESSFUL as shipment updates become available.

Notification examples

Tracking type = PRODUCTION

{
  "operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "operation": "STANDALONE_TRACKING",
  "status": "SUCCESSFUL",
  "issuerId": "issuer-001",
  "cardId": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T09:38:00Z",
  "details": {
    "trackingType": "PRODUCTION",
    "productionSite": "PERSO-CENTER-FR-01",
    "status": "CARD_SHIPPED"
  }
}

Tracking type = SHIPMENT — first notification

{
  "operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "operation": "STANDALONE_TRACKING",
  "status": "PENDING",
  "issuerId": "issuer-001",
  "cardId": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T09:38:05Z",
  "details": {
    "trackingType": "SHIPMENT",
    "productionSite": "PERSO-CENTER-FR-01",
    "status": "CARD_SHIPPED"
  }
}

Tracking type = SHIPMENT — subsequent notification (with shipment details)

{
  "operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "operation": "STANDALONE_TRACKING",
  "status": "SUCCESSFUL",
  "issuerId": "issuer-001",
  "cardId": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T14:12:33Z",
  "details": {
    "trackingType": "SHIPMENT",
    "productionSite": "PERSO-CENTER-FR-01",
    "status": "CARD_SHIPPED",
    "shipment": {
      "carrier": "fedex",
      "trackingNumber": "1234567890",
      "status": "IN_TRANSIT",
      "message": "In transit",
      "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": "Paris",
        "countryName": "France",
        "message": "Arrived at facility"
      }
    }
  }
}

Tracking type = RETURN

{
  "operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "operation": "STANDALONE_TRACKING",
  "status": "SUCCESSFUL",
  "issuerId": "issuer-001",
  "cardId": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-25T10:02:11Z",
  "details": {
    "trackingType": "RETURN",
    "productionSite": "PERSO-CENTER-FR-01",
    "status": "CARD_RETURNED"
  }
}