> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta.md). # Pedido de tarjeta 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 {% stepper %} {% step %} ### 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](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/seleccionar-servicios-de-pedido-de-tarjetas.md). * Entradas de personalización (impresión, banda magnética y chip). Consulta: * [Pistas de la banda magnética](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/pistas-de-banda-magnetica.md) * [Personalización gráfica](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/personalizacion-grafica.md) * [Personalización del chip](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/personalizacion-del-chip.md) * [Personalización del portador de la tarjeta](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/embalaje.md) * [Embalaje](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/embalaje.md) * [Envío](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/envio.md) {% endstep %} {% step %} ### Enviar el pedido Llama a la [API de pedido de tarjeta](/central-issuance/es/integrar-la-api-de-d1/referencia-de-la-api-de-d1/api-entrante-hacia-d1/api-de-pedido-de-tarjetas.md#post-issuers-issuerid-physicalcards-cardid-operations-production) 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. {% endstep %} {% step %} ### 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](/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas.md). {% endstep %} {% endstepper %} ### APIs requeridas
APIEntrada/SalidaDescripción
Obtener token de autorizaciónEmisor -> Thales D1Obtén un token de acceso OAuth 2.0 para llamar al backend de D1.
Pedido de tarjetaEmisor -> Thales D1Pedir una tarjeta física
NotificacionesEmisor <- Thales D1Recibir 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](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/seleccionar-servicios-de-pedido-de-tarjetas.md) * [Pistas de la banda magnética](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/pistas-de-banda-magnetica.md) * [Personalización gráfica](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/personalizacion-grafica.md) * [Personalización del chip](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/personalizacion-del-chip.md) * [Personalización del portador de la tarjeta](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/embalaje.md) * [Embalaje](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/embalaje.md) * [Envío](/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta/envio.md) 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](/central-issuance/es/integrar-la-api-de-d1/conectividad-de-d1/cifrar-datos-confidenciales.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.payments.thalescloud.io/central-issuance/es/implementar-la-emision-centralizada/pedido-de-tarjeta.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.