Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

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

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.

Last updated

Was this helpful?