Extraer y cambiar

Use Pull and Change para solicitar actualizaciones de un pedido de tarjeta física que D1 ha recibido a través de la API pero que aún no se ha enviado.

Esta función solo está disponible para tarjetas solicitadas por API.

Flujo

Flujo de Pull and Change para pedidos de tarjetas físicas.

Diagrama de secuencia

Cómo funciona

1. El backend del emisor envía una solicitud Pull and Change. Tipos de cambio comunes:

   • CANCEL: Cancela el pedido de la tarjeta y destruye la tarjeta.
   • ACCELERATE: Produce la tarjeta lo antes posible y envíala con un transportista exprés.
   • REDIRECT: Cambia la dirección de entrega del envío.
   • ACCELERATE_AND_REDIRECT: Acelera la producción y cambia la dirección de entrega del envío.
2. D1 reenvía la solicitud al centro de personalización que produce la tarjeta.
3. El centro de personalización acepta o rechaza la solicitud según la fase de producción.
4. D1 devuelve el resultado de forma asíncrona mediante notificaciones.

APIs requeridas

API	Entrada/Salida	Descripción
Pull and Change	Emisor -> Thales D1	Retira una tarjeta y solicita aplicar un cambio
Notificaciones	Emisor <- Thales D1	Recibe notificaciones para la operación UPDATE_ORDER

Entradas de la API

Entradas obligatorias de la API D1:

• issuerId: Identificador único del emisor
• cardId: Identificador único de la tarjeta.
• type: Tipo de cambio que se aplicará al pedido de la tarjeta.

Entradas condicionales de la API D1, cuando type es REDIRECTo ACCELERATE_AND_REDIRECT.

• newDeliveryAddress campos:

  • title: Prefijo de nombre (por ejemplo, Sr.).
  • firstName: Nombre.
  • lastName: Apellido.
  • companyName: Nombre de la empresa.
  • line1: Línea 1 de la dirección.
  • line2: Línea 2 de la dirección.
  • line3: Línea 3 de la dirección.
  • city: Ciudad.
  • state: Estado o región.
  • zipCode: Código postal.
  • countryCode: Código de país (ISO 3166-1 alpha-2, por ejemplo US).
  • mobilePhoneNumber: Número de teléfono internacional utilizado para el contacto del envío.

Ejemplos

Ejemplo - CANCEL

{
  "type": "CANCEL"
}

Ejemplo - ACCELERATE

{
  "type": "ACCELERATE",
  "newDueDate": "2025-01-15"
}

Ejemplo - REDIRECT

{
  "type": "REDIRECT",
  "newDeliveryAddress": {
    "title": "Sra.",
    "firstName": "Alex",
    "lastName": "Chen",
    "companyName": "Example Co",
    "line1": "10 Main St",
    "line2": "Apt 3B",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "countryCode": "US",
    "mobilePhoneNumber": "[phone]"
  }
}

Ejemplo - ACCELERATE_AND_REDIRECT

{
  "type": "ACCELERATE_AND_REDIRECT",
  "newDueDate": "2025-01-15",
  "newDeliveryAddress": {
    "title": "Sra.",
    "firstName": "Alex",
    "lastName": "Chen",
    "companyName": "Example Co",
    "line1": "10 Main St",
    "line2": "Apt 3B",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "countryCode": "US",
    "mobilePhoneNumber": "[phone]"
  }
}

Seguimiento del resultado

• Consume las notificaciones para obtener el resultado aceptado o rechazado.