Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

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

Emisor -> Thales D1

Obtén un token de acceso OAuth 2.0 para llamar al backend de D1.

Emisor -> Thales D1

Pedir una tarjeta física

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:

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.

Última actualización

¿Te fue útil?