# Apple Wallet Order Tracking

## Overview

With this integration, you can offer customers a fully branded experience to track the status of their orders, seamlessly embedded in Apple Wallet. Shoppers can track their orders, view product details, and receive real-time updates through push notifications.

It’s straightforward to implement. Simply send the necessary event data along with the relevant Apple Wallet details (see [below](#configuring-the-apple-wallet-order-tracking-integration)) to parcelLab and a digital pass is automatically created and updated in the customer’s Apple Wallet, making it simple to monitor the order status at a glance. This in turn helps reduce support inquiries, improve customer satisfaction, and drive stronger engagement after purchase.                                                            

<figure><img src="/files/EZocKaYyWsvUQbnRxKGo" alt="Apple Wallet notification, order placed and order on its way status images"><figcaption></figcaption></figure>

### Key Benefits

Using parcelLab’s Apple Wallet Order Tracking integration leads to a number of benefits, including:

* Enhanced customer experience with order tracking information available directly in their Apple Wallet
* Real-time updates to keep customers informed of order status changes via push notifications
* Seamless integration with your existing parcelLab tracking solution
* Reduced support inquiries through proactive status updates
* Increased brand engagement with your logo and contact information shown directly in the customer’s Apple Wallet

## Configuring the Apple Wallet Order Tracking Integration

The following sections describe the configuration required for the Apple Wallet Order Tracking integration with parcelLab.

### Customer Requirements

For successful configuration of the Apple Wallet Order Tracking integration, the following requirements must be met:

* Apple Developer account with Admin or Account Holder access
* Apple Wallet support (iOS 15 devices and above)
* Active parcelLab account
* You must provide tracking data with required metadata (for example: order status and tracking URL)
* Branded assets (for example: logo)

### Enabling the Apple Wallet Order Tracking Integration

This section describes how you can enable the Apple Wallet Order Tracking integration with parcelLab.

{% stepper %}
{% step %}

### Enroll in Apple Developer Program

* Make sure your organization has an active Apple Developer Program membership, and that you have Admin or Account Holder access.
  {% endstep %}

{% step %}

### Register an Order Type Identifier

1. Sign into [developer.apple.com](https://developer.apple.com/) and open **Certificates, Identifiers & Profiles**.
2. In the sidebar, select **Identifiers**, and then click **+**.
3. Select **Order Type IDs**, and then click **Continue**.
4. Do the following:
   1. Enter a name for the order type ID in the **Name** field (for example: "YourBrand Order Pass").
   2. Enter the unique identifier in reverse-DNS format in the **Identifier** field (for example: `order.com.yourbrand.store`).
5. Click **Register**.
   {% endstep %}

{% step %}

### Create an Order Type ID Certificate

1. Under **Certificates**, click **+**.
2. Select **Order Type ID Certificate**, and then click **Continue**.
3. Upload your Certificate Signing Request (CSR).
4. Download the generated .cer file (this is your order type ID certificate).
   {% endstep %}

{% step %}

### Export the Private Key

1. Open **Keychain Access** on macOS.
2. Under **My Certificates**, find your new order type ID certificate and expand it to reveal its private key.
3. Select both the order type ID certificate and the corresponding private key, and then click **File → Export Items**.
4. Select .**p12** format, set an export password, and then click **Save**.
5. If needed, convert the .p12 to PEM format using `openssl pkcs12`.
   {% endstep %}

{% step %}

### Register a Merchant Identifier for Apple Pay

1. In **Certificates, Identifiers & Profiles → Identifiers**, click **+**.
2. Select **Merchant IDs**, and then click **Continue**.
3. Do the following:
   1. Enter a name for the merchant identifier in the **Name** field (for example: "YourBrand Apple Pay").
   2. Enter the unique identifier (for example: `merchant.com.yourbrand.applepay`).
4. Click **Register**.
   {% endstep %}

{% step %}

### Create an Apple Pay Payment Processing Certificate

1. Under **Certificates**, click **+**.
2. Select **Apple Pay Payment Processing Certificate** for your merchant ID.
3. Upload a new CSR.
4. Download the resulting .cer file.
   {% endstep %}

{% step %}

### Provide Assets to parcelLab

Provide your parcelLab integration lead with:

* Order Type Identifier (for example: `order.com.yourbrand.store`)
* Order Type ID Certificate (.cer)
* Private Key (.p12 or PEM)
* Merchant ID (for example: `merchant.com.yourbrand.applepay`)
* Apple Pay Payment Processing Certificate (.cer)

{% hint style="info" %}
Handle all sensitive files securely (for example: via encrypted file transfer).
{% endhint %}
{% endstep %}

{% step %}

### Checkout Integration Snippet

Your shop system will have to call the parcelLab API during the Apple Pay payment completion process. As part of the payment completion, information about the wallet pass has to be sent back to the client. To retrieve the information from the parcelLab API, use the [Fetch Apple Wallet Order Tracking API request](/docs/developers/v2/status-updates/apple-wallet.md#fetch-apple-wallet-order-data) detailed in our developer documentation.

{% hint style="info" %}
For further details on Apple Pay, please refer to [Apple's documentation](https://developer.apple.com/documentation/applepayontheweb/applepaysession/completepayment).
{% endhint %}
{% endstep %}
{% endstepper %}

Apple Wallet Order Tracking is built for seamless integration via API. When you send the relevant tracking data to parcelLab, including specific identifiers for Apple Wallet, parcelLab generates and updates a pass in the customer’s Apple Wallet automatically, allowing them to easily keep track of their order.

{% hint style="info" %}
For more information on the technical requirements of this integration, please see our [API reference](/docs/developers/v2/status-updates/apple-wallet.md).
{% endhint %}


---

# Agent Instructions: 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.parcellab.com/docs/platform/app-store/apple-wallet.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.