Seguimiento de pedidos de tarjetas

D1 envía actualizaciones en tiempo real sobre la producción y el envío de tarjetas físicas al backend de su emisor.

Use notificaciones (webhooks), estado a demanda o ambos.

Flujo a alto nivel

Flujo a alto nivel de los eventos de producción y envío de tarjetas físicas.

Transiciones de estado

Este diagrama muestra las transiciones típicas desde la solicitud hasta el envío.

También incluye rutas de excepción y en espera.

Transiciones de estado que incluyen excepciones y estados en espera.

Más diagramas

Vista operativa de los pasos de emisión y cambios de estado.

Diagrama de secuencia para notificaciones y cambios de estado durante la emisión de tarjetas físicas.

Cómo funciona

Use uno o ambos enfoques.

Notificaciones (recomendado)

• Reciba notificaciones por cada paso de producción y actualización de envío.
• Gestione la entrega al menos una vez. Espere reintentos y duplicados.
• Implemente el endpoint de callback definido en Notificaciones de backend.

A demanda

• Consulte el estado actual de producción/envío en cualquier momento.
• Vea Rastrear pedidos a demanda.

APIs requeridas

API	Entrante/Saliente	Descripción
Notificaciones	Emisor <- Thales D1	Reciba notificaciones para la PRODUCE operación.

Contenido de la API

Las notificaciones y las respuestas a demanda utilizan el mismo objeto de operación.

Pueden incluir:

Campo	Descripción	Presencia
operationId	Identificador único para la instancia de la operación. Úselo para desduplicar y correlacionar.	Requerido
operation	Tipo de operación. Siempre PRODUCE para el seguimiento de la emisión de tarjetas físicas.	Requerido
status	Estado de la operación: PENDIENTE, EXITOSO, o FALLIDO.	Requerido
startTime	Marca de tiempo ISO 8601 cuando la operación comenzó.	Requerido
endTime	Marca de tiempo ISO 8601 cuando la operación se completó.	Condicional
cardId	Identificador interno de la tarjeta en D1.	Requerido
details	Carga útil específica de la emisión. Vea Rastrear producción y Rastrear envío.	Requerido
errorCode	Causa de fallo legible por máquina.	Condicional
error	Descripción corta legible por humanos del fallo.	Condicional
inputFileName	Nombre del archivo que contiene las solicitudes de emisión de tarjetas.	Condicional
issuerRequestId	Identificador de correlación proporcionado por el backend de su emisor.	Condicional

Nivel superior status es el estado de la operación.

details.status es el estado de la emisión de la tarjeta física.

Entrega e idempotencia

Las notificaciones pueden llegar fuera de orden y más de una vez.

• Use operationId para desduplicar y correlacionar eventos.
• Use startTime/endTime para decidir qué evento es el más reciente.
• Use la API a demanda para reconciliar el estado si detecta brechas.