Track shipment

D1 can provide shipment tracking after a physical card ships.

You receive shipment updates:

• In notifications sent to your issuer backend.
• In on-demand status responses, when available.

When shipment tracking is available

Shipment tracking is usually available after details.status = CARD_SHIPPED.

See Card order tracking for the end-to-end flow.

Carrier tracking fields are optional. Availability depends on the carrier integration.

Carriers supported

Carrier code	Carrier name
chronopost-france	Chronopost France
dhl	DHL Express
dhl-global-mail	DHL eCommerce
deutsch-post	Deutsche Post Mail
estafeta	Etafeta
fedex	FedEx®
la-poste-colissimo	La Poste
nacex	NACEX
spanish-seur	Spanish Seur
singapore-post	Singapore Post
spain-correos-es	Correos de España
ups	UPS
usps-iv-api	USPS Informed Visibility

Shipment object

When present, details.shipment can include:

• carrier: Carrier code (for example, fedex).
• trackingNumber: Carrier tracking reference.
• status: Carrier shipment status.
• message: Normalized carrier message for display.
• trackingUrl: Direct URL to carrier tracking.
• redirectUrl: Carrier landing page URL for delivery actions.
• pickupDate: ISO 8601 timestamp when the carrier collected the parcel.
• estimatedDeliveryDate: ISO 8601 estimated delivery timestamp.
• lastUpdatedAt: ISO 8601 timestamp of the last event.
• deliveryDate: ISO 8601 timestamp of delivery, when provided.
• signedBy: Signature recipient, when provided.
• failedDeliveryAttempts: Number of failed delivery attempts, when provided.
• lastCheckpoint:

  • checkpointTime: The date and time of the checkpoint event, provided by the carrier. It uses the timezone of the checkpoint. The format may differ depending on how the carrier provides it.
  • city: City info provided by carrier.
  • countryName: Country name of the checkpoint, may also contain other location info.
  • message: Checkpoint message.

Example

{
  "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": {
          "pickupDate": "2025-01-21T17:32:28Z",
          "carrier": "fedex",
          "trackingNumber": "61293150000079650811",
          "status": "IN_TRANSIT",
          "message": "In transit",
          "trackingUrl": "https://www.fedex.com/apps/fedextrack/?tracknumbers=61293150000079650811&cntry_code=US",
          "redirectUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=61293150000079650811&cntry_code=US",
          "estimatedDeliveryDate": "2025-01-21T17:32:28Z",
          "lastUpdatedAt": "2025-01-21T17:32:28Z",
          "lastCheckpoint": {
            "checkpointTime": "2025-01-21T17:32:28Z",
            "city": "New York",
            "countryName": "United States",
            "message": "Arrived at facility"
          }
        }
      }
    }
  ]
}

Shipment statuses

Status code	Description
INFO_RECEIVED	Carrier received the shipping request and will collect the parcel.
IN_TRANSIT	Parcel is moving through the carrier network.
OUT_FOR_DELIVERY	Parcel is out for delivery or ready for pickup.
FAILED_ATTEMPT	Carrier attempted delivery and will typically retry.
DELIVERED	Parcel was delivered.
AVAILABLE_FOR_PICKUP	Parcel is available at a pickup point.
EXCEPTION	Parcel is on hold, undelivered, or returned.
EXPIRED	No tracking information for 30 days since added.
PENDING	Tracking information is not available yet.

Shipment messages (sub-status)

message is a normalized display string. Values can vary over time. It provides additional details about the shipment status.

Example message values

Shipment status	Message (sub-status)	Description
DELIVERED	Delivered	Confirm delivery.
DELIVERED	Picked up by the customer	Confirm pickup.
DELIVERED	Sign by customer	Confirm signature delivery.
DELIVERED	Delivered and received cash on delivery	Confirm COD delivery.
AVAILABLE_FOR_PICKUP	Available for pickup	Indicate pickup availability.
EXCEPTION	Exception	Indicate a delivery exception.
EXCEPTION	Customer moved	Indicate recipient relocation.
EXCEPTION	Customer refused delivery	Indicate a refusal.
EXCEPTION	Delayed (Customs clearance)	Indicate customs delay.
EXCEPTION	Delayed (External factors)	Indicate external delay.
EXCEPTION	Held for payment	Indicate payment hold.
EXCEPTION	Incorrect Address	Indicate address issue.
EXCEPTION	Pick up missed	Indicate pickup missed.
EXCEPTION	Rejected by carrier	Indicate carrier rejection.
EXCEPTION	Returning to sender	Indicate return in progress.
EXCEPTION	Returned to sender	Confirm return completed.
EXCEPTION	Shipment damage	Indicate damaged parcel.
EXCEPTION	Shipment lost	Indicate lost parcel.
EXCEPTION	Carrier pickup failed	Indicate carrier pickup failed.
FAILED_ATTEMPT	Failed Attempt	Indicate failed delivery attempt.
FAILED_ATTEMPT	Addressee not available	Indicate recipient unavailable.
FAILED_ATTEMPT	Business Closed	Indicate business closed.
IN_TRANSIT	In Transit	Indicate in-transit movement.
IN_TRANSIT	Acceptance scan	Confirm carrier acceptance.
IN_TRANSIT	Arrival scan	Confirm hub arrival.
IN_TRANSIT	Arrived at the destination country/region	Confirm destination arrival.
IN_TRANSIT	Customs clearance completed	Confirm customs completed.
IN_TRANSIT	Customs clearance started	Confirm customs started.
IN_TRANSIT	Departure Scan	Confirm facility departure.
IN_TRANSIT	Problem resolved	Confirm issue resolution.
IN_TRANSIT	Forwarded to a different delivery address	Indicate forwarding.
INFO_RECEIVED	Info Received	Confirm shipping information received.
OUT_FOR_DELIVERY	Out for Delivery	Indicate out for delivery.
OUT_FOR_DELIVERY	Customer contacted	Indicate carrier contact attempt.
OUT_FOR_DELIVERY	Delivery appointment scheduled	Indicate appointment scheduled.
PENDING	Pending	Indicate no tracking available.
PENDING	Carrier account not connected	Indicate missing carrier connection.
PENDING	Label created, no updates yet	Indicate label created.
PENDING	Wrong carrier	Indicate carrier mismatch.
PENDING	No recent updates	Indicate stale tracking.
PENDING	Unrecognized carrier	Indicate unsupported carrier.
EXPIRED	Expired	Indicate tracking expired.