Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

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.

  • 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.

APIs requeridas

API
Entrante/Saliente
Descripción

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.

Última actualización

¿Te fue útil?