Apple Wallet Order Tracking

parcelLab offers Apple Wallet Order Tracking integration to allow your customers to easily track their orders directly through Apple Wallet.

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) 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.

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.

1

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.

2

Register an Order Type Identifier

1. Sign into 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.

3

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).

4

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.

5

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.

6

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.

7

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)

Handle all sensitive files securely (for example: via encrypted file transfer).

8

Checkout Integration Snippet

Ensure your frontend checkout code passes these parameters to parcelLab’s API after payment.

const passRequest = {
    orderTypeIdentifier: "order.com.yourbrand.store",
    orderIdentifier: "<YOUR_ORDER_ID>",
    webServiceURL: "https://api.parcellab.com/apple-wallet/order",
    authenticationToken: "<SIGNED_AUTH_TOKEN>"
 };

// Example: call parcelLab’s endpoint to push the pass fetch(passRequest.webServiceURL, {
    method: "POST",
    headers: { "Authorization": `Bearer ${passRequest.authenticationToken}` },
    body: JSON.stringify(passRequest)
})
    .then(res => res.json()
    .then(console.log)
    .catch(console.error);

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.

For more information on the technical requirements of this integration, please see our API reference.