Fast Track

Fast Track Prebooking

For transport hub–related services, including lounge and Fast Track prebooking, each service point (e.g., a specific lounge or Fast Track lane) is treated as an individual resource. The prebooking process is resource-specific and follows these main steps:

Availability Check

Query the availability of a specific resource for the desired date and time.

Prebooking Creation

If available, a prebooking order can be created. The order remains cancellable within the applicable cancellation policy window.

Service Access

At the prebooking time, the user can access the service by presenting the credential provided in the order confirmation.

Create Prebooking Orders

→ Use /orders/fastTrack/ePasses/prebooking to place a Fast Track prebooking order with an E-pass.

Request

In our API body, we separate basic information and order specific information using the extra object.

Create E-pass Prebooking Order - Fast Track - Request

As required by airports and partners, certain resource prebooking orders will need the passenger's name, email, phone number, or flight number for booking information.
For the required information at specific locations, please refer to theprebookingRequiredInfoprovided in the /resources/{resourceId} response.

According to the requirements of the service resources, DragonPass only collects the necessary personally identifiable information (PII) for each order.

Even if clients provide additional or unnecessary PII, we will not store it. Such data will be discarded and displayed as null in the order details.

{
    "module": 2,
    "ePassId": "1788000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "passengers": [
            {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "passengersType": 1,
                "leadPassenger": true
            }
        ],
        "prebookingRequiredInfo": {
            "firstName": "DragonPass",
            "lastName": "DragonPass",
            "email": "developer@dragonpass.com",
            "phoneNumber": "8081966002",
            "callingCode": "44",
            "transportNumber": "EK0001"
        }
    }
}

Response

Create E-pass Prebooking Order - Fast Track - Response

For the Fast Track module, each passenger will receive an individual voucher. Depending on the Fast Track lane, vouchers may either be unique per person or identical across all passengers.

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 2,
        "ePassId": "1788000066668888",
        "category": 2,
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": "",
            "usedUsages": 1,
            "resourceId": "C00001",
            "resourceName": "DragonPass Fast Track Service",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "passengers": [
                {
                    "firstName": "DragonPass",
                    "lastName": "DragonPass",
                    "passengersType": 1,
                    "leadPassenger": true
                }
            ],
            "vouchersList": [
                {
                    "firstName": "DragonPass",
                    "lastName": "DragonPass",
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "email": "developer@dragonpass.com",
                "phoneNumber": "8081966002",
                "callingCode": "44",
                "flightNumber": "EK0001"
            }
        }
    }
}

Voucher Generation & Presentation

After a prebooking order is successfully created and the order status becomes Confirmed, clients must generate and display the voucher based on the vouchersList returned in the order response.

Users must present the rendered voucher at the service point to access the service

Lounge: typically 1 voucher per order

Fast Track/Fitness: may include per-passenger vouchers

For prebooking orders, always use the voucher value from vouchersList.
Using the E-pass ID may lead to service denial.

Voucher Source Example:

"vouchersList": [
    {
        "voucher": "668800008888",
        "voucherType": 1
    }
]

Different resources may return different voucher types, the way to present the voucher depends on voucherType:

voucherType	Type	Instruction
1	QR Code	Convert the voucher into a QR code and display
2	Barcode	Convert the voucher into a barcode and display
3	Image	Display the image directly
4	Verification Code	Show the code directly to staff

You may also refer to the UI Design Guidelines for voucher rendering.

Cancel Prebooking Orders

→ Use the /orders endpoint to cancel a prebooking order by order ID.

A prebooking order can be cancelled in accordance with the cancellation policy. Once cancelled, the corresponding usages will be refunded to the E-pass.

Whether a prebooking order can be canceled depends on the cancellation policy provided in the /resources/{resourceId} response, usually:

24-72 hours before the service time.

Please note that once a prebooking order is cancelled, it cannot be recovered.

Fast Track Prebooking#

Create Prebooking Orders#

Voucher Generation & Presentation#

Cancel Prebooking Orders#

Fast Track Prebooking

Create Prebooking Orders

Voucher Generation & Presentation

Cancel Prebooking Orders