Centro de seguimiento

Utilice el hub de seguimiento para recibir actualizaciones de producción, envío o devolución de una tarjeta física producida fuera de Thales D1.

Flujo

1. Solicitud del back-end del emisor para rastrear la tarjeta

2. D1 se conecta con los transportistas para recuperar la información del envío

3. Los transportistas envían estados de envío periódicos

4. D1 da formato y envía los estados al back-end del emisor

Diagrama de secuencia

Cómo funciona

PRODUCCIÓN

• Utilice trackingType = PRODUCTION para recibir una actualización de finalización de producción.

• Thales D1 envía una notificación con status = SUCCESSFUL.

• La notificación incluye details.status = CARD_SHIPPED.

ENVÍO

DEVOLUCIÓN

APIs requeridas

API	Entrada/Salida	Descripción
Hub de seguimiento	Emisor -> Thales D1	Solicite seguimiento de producción, envío o devolución para una tarjeta física.
Notificaciones	Emisor <- Thales D1	Reciba notificaciones para la STANDALONE_TRACKING operación.

Entradas de la API

Entradas requeridas de la API de D1:

• issuerId: Identificador único del emisor.

• cardId: Identificador único de la tarjeta.

• trackingType: Tipo de seguimiento a realizar. Los valores admitidos son PRODUCCIÓN, ENVÍO, y DEVOLUCIÓN.

Ejemplos

Tipo de seguimiento = PRODUCCIÓN

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

Tipo de seguimiento = ENVÍO

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

Tipo de seguimiento = DEVOLUCIÓN

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

Seguimiento del resultado

Consuma las notificaciones en la STANDALONE_TRACKING operación.

Campos clave:

• operation: Siempre STANDALONE_TRACKING.

• status: Estado de la operación. Los valores son PENDING, SUCCESSFUL, o FAILED.

• cardId: Identificador de la tarjeta usado en la solicitud.

• details.trackingType: PRODUCCIÓN, ENVÍO, o DEVOLUCIÓN.

• details.productionSite: Identificador del sitio de producción, cuando esté disponible.

• details.status: Resultado del seguimiento, como CARD_SHIPPED o CARD_RETURNED.

• details.shipment: Detalles del seguimiento del envío para ENVÍO actualizaciones. Consulte Seguimiento del envío.

De nivel superior status es el estado de la operación.

details.status es el estado de seguimiento empresarial.

Las notificaciones pueden llegar más de una vez y pueden llegar fuera de orden. Utilice operationId para desduplicar eventos.

Secuencia de notificaciones por tipo de seguimiento:

trackingType	Notificaciones enviadas
PRODUCCIÓN	Una notificación con status = SUCCESSFUL y details.status = CARD_SHIPPED.
DEVOLUCIÓN	Una notificación con status = SUCCESSFUL y details.status = CARD_RETURNED.
ENVÍO	Una notificación con status = PENDING, luego una o más notificaciones con status = SUCCESSFUL a medida que estén disponibles las actualizaciones del envío.

Ejemplos de notificaciones

Tipo de seguimiento = PRODUCCIÓN

{
  "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"
  }
}

Tipo de seguimiento = ENVÍO — primera notificación

{
  "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"
  }
}

Tipo de seguimiento = ENVÍO — notificación posterior (con detalles del envío)

{
  "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": "En tránsito",
      "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": "París",
        "countryName": "Francia",
        "message": "Llegó a la instalación"
      }
    }
  }
}

Tipo de seguimiento = DEVOLUCIÓN

{
  "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"
  }
}