Apple Wallet

Our API allows you to provide real-time order tracking updates directly into your customers’ Apple Wallet.

Overview

The Apple Wallet Order Tracking integration is designed to work via direct API calls after an order is placed. When the correct identifiers and tracking data are sent, the Apple Wallet pass is automatically created and updated. This implementation provides a flexible setup for retailers that require API-first solutions (that is: headless integrations) for order tracking and customer notifications.

Apple Wallet Order Tracking Integration

For more information on the requirements for configuring this integration, see our Apple Wallet Order Tracking documentation.

The following steps outline the process for the Apple Wallet Order Tracking integration.

1

Order completed

• Customer completes checkout and pays.

2

Send order data

• Retailer sends the required order metadata to the /apple-wallet/order endpoint.

3

Pass issued

• parcelLab creates or updates the Apple Wallet pass tied to the order.

4

Customer access

• The customer is notified via Apple Wallet and receives push updates as the order progresses.

Create or Update Apple Wallet Pass

Details of how the apple-wallet/order endpoint can be used to create or update an Apple Wallet pass for a given order are described below.

POST Create or Update an Apple Wallet Pass

You can create or update a digital pass with the apple-wallet/order endpoint. Each call results in a new or updated pass being issued to the customer’s Apple Wallet.

The details of the Create or Update Apple Wallet Pass API are described in the following section.

API Details

POST https://api.parcellab.com/apple-wallet/order

Authentication

Authentication is handled via a signed token generated using your Apple private key.

You must sign the token using the private key associated with your Apple Developer certificate. For more information on getting started with the apple-wallet/order endpoint, please contact your parcelLab representative.

Request Body

Name	Type	Description
orderTypeIdentifier	string	Unique identifier for your order pass (for example: order.com.yourbrand.store).
orderIdentifier	string	Unique identifier for the order (must match tracking events).
webServiceUrl	string	Fixed endpoint: https://api.parcellab.com/apple-wallet/order.
authenticationToken	string	Signed JWT token using your Apple private key.

An example payload is displayed below to show the format for creating or updating an Apple Wallet pass for an order.

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

Responses

• 200 - accepted