Pedido de tarjeta

Solicite la producción y el envío de tarjetas físicas usando D1.

D1 permite que el backend de tu emisor solicite la producción de tarjetas físicas. Puedes enviar tarjetas al usuario final. También puedes realizar envíos masivos a sucursales o centros.

Usa esta sección para elegir las opciones de personalización y envío. Luego llama a la API de emisión física para enviar el pedido.

Antes de empezar

• Completa la incorporación a D1 y obtén las credenciales de la API de D1.

• Configura productos de tarjeta, perfiles de personalización y plantillas de carta.

• Carga artículos de inventario y variantes de producto para tu programa/BIN.

• Configura la dirección de devolución y los métodos de envío.

• Define los países de destino permitidos por programa.

Flujo

Flujo de extremo a extremo desde la solicitud del backend del emisor hasta un centro de personalización de Thales.

Cómo funciona

1

Elegir opciones del pedido

Selecciona:

• Tipo de emisión, envío, embalaje y ajustes del portador de la tarjeta. Consulta Seleccionar servicios del pedido de tarjeta.

• Entradas de personalización (impresión, banda magnética y chip). Consulta:

  • Pistas de la banda magnética

  • Personalización gráfica

  • Personalización del chip

  • Personalización del portador de la tarjeta

  • Embalaje

  • Envío

2

Enviar el pedido

Llama a la API de pedido de tarjeta para pedir una tarjeta física.

Haz que las solicitudes sean idempotentes. Reutiliza una clave estable de tu backend de emisor (por ejemplo, issuerRequestId) para que los reintentos no creen duplicados.

3

Rastrear la producción y el envío

Usa el endpoint de estado y las notificaciones para mantener tu sistema sincronizado.

Consulta Seguimiento del pedido de tarjeta.

APIs requeridas

API	Entrada/Salida	Descripción
Obtener token de autorización	Emisor -> Thales D1	Obtén un token de acceso OAuth 2.0 para llamar al backend de D1.
Pedido de tarjeta	Emisor -> Thales D1	Pedir una tarjeta física
Notificaciones	Emisor <- Thales D1	Recibir notificaciones con el estado del pedido de tarjeta para la operación PRODUCE

Entradas de la API

Entradas requeridas de la API de D1:

• issuerId: Identificador único del emisor

• cardId: Identificador único de la tarjeta.

• consumerId: Identificador único del consumidor.

Entradas condicionales de la API de D1:

• issuerRequestId: Identificador único proporcionado por el emisor para identificar la solicitud de producción de la tarjeta. Se usa para correlacionar el pedido con las notificaciones.

Otras entradas de la API de D1; consulta las distintas secciones que describen las entradas requeridas:

• Seleccionar servicios del pedido de tarjeta

• Pistas de la banda magnética

• Personalización gráfica

• Personalización del chip

• Personalización del portador de la tarjeta

• Embalaje

• Envío

Entradas obsoletas de la API de D1:

• state: El estado de la tarjeta. Si no se proporciona, la tarjeta se considera ACTIVE.

• oldCardId: Identificador único de la tarjeta anterior. Se proporciona en caso de que la tarjeta reemplace a otra tarjeta.

Gestión de errores y reintentos

Gestiona los errores en dos capas:

• Errores síncronos de la API (HTTP 4xx/5xx). Valida las cargas útiles. Reintenta de forma segura con idempotencia ante fallos transitorios.

• Errores asíncronos de producción (por ejemplo, falta de stock o problemas de plantilla). Haz un seguimiento del estado de la última operación en el backend de tu emisor.

Seguridad y manejo de datos

Trata el PAN, los valores de las pistas de la banda magnética y el código de seguridad de la tarjeta (CSC) como datos sensibles.

• No registres campos sensibles.

• Cifra los campos sensibles cuando lo requiera el endpoint. Consulta Cifrar datos sensibles.