> 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/implement-central-issuance/card-order-tracking/track-production.md).

# Track production

Production tracking data is returned in `details` for the `PRODUCE` operation.

### Physical card issuance statuses

<figure><img src="/files/HHkzA3N5OvwtgkrLxgYG" alt=""><figcaption><p>Status transition diagram for physical card issuance.</p></figcaption></figure>

| Status code           | Description                                                                                  |
| --------------------- | -------------------------------------------------------------------------------------------- |
| `CARD_PROD_REQUESTED` | Card personalization has been requested via the D1 APIs.                                     |
| `DATA_PREPARED`       | Data has been successfully processed.                                                        |
| `DATA_EXCEPTION`      | An error occurred during data processing.                                                    |
| `CARD_PROD_READY`     | Data has been sent to the personalization center, and the card is ready for personalization. |
| `CARD_PROD_ONGOING`   | Card personalization is in progress.                                                         |
| `CARD_PROD_DONE`      | Card has been personalized and is ready to be prepares for shipment.                         |
| `CARD_SHIPPED`        | The card has been handed over to the carrier.                                                |
| `CARD_PROD_CANCELED`  | Card personalization was canceled by the issuer.                                             |

{% hint style="info" %}
Treat unknown `details.status` values as forward-compatible.
{% endhint %}

### `details` fields

| Field             | Description                                                                                                                                          | Presence    |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| `reason`          | Provides extra details for data processing or production exceptions.                                                                                 | Conditional |
| `consumerId`      | Deprecated. Do not use. Use your internal end user identifier.                                                                                       | Deprecated  |
| `dueDate`         | Estimated shipment date, calculated when D1 processes the order.                                                                                     | Conditional |
| `productionSite`  | Personalization center that handles card personalization.                                                                                            | Conditional |
| `shipment`        | Shipment tracking details, when available. See [Track shipment](/central-issuance/implement-central-issuance/card-order-tracking/track-shipment.md). | Conditional |
| `inputFileName`   | File name containing card issuance requests.                                                                                                         | Conditional |
| `issuerRequestId` | Correlation identifier from your input file.                                                                                                         | Conditional |

### Examples

#### Card requested

```json
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_PROD_REQUESTED"
      }
    }
  ]
}
```

#### Data processing done and successful

```json
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_PREPARED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos"
      }
    }
  ]
}
```

#### Data processing in error, card is rejected

```json
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "FAILED",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_EXCEPTION"
      },
      "errorCode": "FIELD_INVALID_FORMAT",
      "error": "pan"
    }
  ]
}
```

#### Card shipped — first notification

```json
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "SUCCESSFUL",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_SHIPPED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos",
        "shipment": {
          "estimatedDeliveryDate": "2025-01-21T17:32:28Z"
        }
      }
    }
  ]
}
```

#### Card shipped — subsequent notification

```json
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "SUCCESSFUL",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_SHIPPED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos",
        "shipment": {
          "carrier": "fedex",
          "trackingNumber": "1234567890",
          "status": "IN_TRANSIT",
          "message": "In transit",
          "trackingUrl": "https://www.fedex.com/track?trk=1234567890",
          "estimatedDeliveryDate": "2026-05-24T00:00:00Z",
          "lastUpdatedAt": "2026-05-22T13:55:00Z",
          "lastCheckpoint": {
            "checkpointTime": "2026-05-22T13:55:00Z",
            "city": "Paris",
            "countryName": "France",
            "message": "Arrived at facility"
          }
        }
      }
    }
  ]
}
```

#### Bulk notification

```jsonl
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_PROD_REQUESTED"
      }
    },
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_PREPARED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos"
      }
    },
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "FAILED",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_EXCEPTION"
      },
      "errorCode": "FIELD_INVALID_FORMAT",
      "error": "pan"
    }        
  ]
}
```


---

# 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/implement-central-issuance/card-order-tracking/track-production.md?ask=<question>
```

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.
