Extracción y cambio

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 funcionalidad 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 de 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 etapa de producción.

4. D1 devuelve el resultado de forma asíncrona mediante notificaciones.

APIs requeridas

API	Entrada/Salida	Descripción
Pull & Change	Emisor -> Thales D1	Solicitar una tarjeta y aplicar un cambio
Notificaciones	Emisor <- Thales D1	Recibir notificaciones para la operación UPDATE_ORDER

Entradas de API

Entradas requeridas de la API de 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 de D1, cuando type es REDIRECTo ACCELERATE_AND_REDIRECT.

• newDeliveryAddress campos:

  • title: Prefijo del nombre (por ejemplo, Sr.).

  • firstName: Nombre.

  • lastName: Apellido.

  • companyName: Nombre de la empresa.

  • line1: Línea de dirección 1.

  • line2: Línea de dirección 2.

  • line3: Línea de dirección 3.

  • city: Ciudad.

  • state: Estado o región.

  • zipCode: Código postal.

  • countryCode: Código de país (ISO 3166-1 alpha-2, por ejemplo EE. UU.).

  • mobilePhoneNumber: Número de teléfono internacional utilizado para el contacto del envío.

Ejemplo (redirigir)

{
  "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]"
  }
}

Rastrear el resultado

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