Pull & change

Use pull and change to request updates to a physical card order that D1 has received through the API but has not yet been shipped.

This feature is available only for cards ordered by API.

Flow

Pull and change flow for physical card orders.

Sequence diagram

How it works

1. The issuer backend submits a pull and change request. Common change types:

   • CANCEL: Cancel the card order and destroy the card.
   • ACCELERATE: Produce the card as soon as possible and ship it with an express carrier.
   • REDIRECT: Change the shipment delivery address.
   • ACCELERATE_AND_REDIRECT: Expedite production and change the shipment delivery address.
2. D1 forwards the request to the personalization center producing the card.
3. The personalization center accepts or rejects the request based on the production stage.
4. D1 returns the outcome asynchronously via notifications.

Required APIs

API	Inbound/Outbound	Description
Pull & Change	Issuer -> Thales D1	Pull a card and request to apply a change
Notifications	Issuer <- Thales D1	Receive notifications for the operation UPDATE_ORDER

API Inputs

Required D1 API inputs:

• issuerId: Unique identifier of the issuer
• cardId: Unique identifier of the card.
• type: Type of change to apply to the card order.

Conditional D1 API inputs, when type is REDIRECTor ACCELERATE_AND_REDIRECT.

• newDeliveryAddress fields:

  • title: Name prefix (for example, Mr).
  • firstName: First name.
  • lastName: Last name.
  • companyName: Company name.
  • line1: Address line 1.
  • line2: Address line 2.
  • line3: Address line 3.
  • city: City.
  • state: State or region.
  • zipCode: Postal code.
  • countryCode: Country code (ISO 3166-1 alpha-2, for example US).
  • mobilePhoneNumber: International phone number used for shipment contact.

Examples

Example - CANCEL

{
  "type": "CANCEL"
}

Example - ACCELERATE

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

Example - REDIRECT

{
  "type": "REDIRECT",
  "newDeliveryAddress": {
    "title": "Ms",
    "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]"
  }
}

Example - ACCELERATE_AND_REDIRECT

{
  "type": "ACCELERATE_AND_REDIRECT",
  "newDueDate": "2025-01-15",
  "newDeliveryAddress": {
    "title": "Ms",
    "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]"
  }
}

Track the result

• Consume notifications to get the accepted or rejected outcome.