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

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

Preview Prebooking(Optional)

Preview how entitlements will be deducted before creating an actual prebooking order.

Create Prebooking

Once availability is confirmed, clients can proceed to create a prebooking order. 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 voucher provided in the order confirmation.

Voucher Generation & Presentation

For Fast Track prebooking, voucher presentation is based on the vouchersList returned in the order response. A single order may share one voucher across all passengers, or it may include separate vouchers for each passenger, depending on the Fast Track lane and partner configuration.

Dragonpass will split and return the voucher information in a passenger-friendly structure. Clients do not need to determine whether the voucher is shared or unique by themselves. They only need to render each voucher object according to the returned vouchersList.

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

Example:

Shared Voucher Example

Separate Voucher Example

"vouchersList": [
    {
        "firstName": "Dragonpass",
        "lastName": "Dragonpass",
        "voucher": "668800008888",
        "voucherType": 1
    },
    {
        "firstName": "Dragonpass",
        "lastName": "Dragonpass",
        "voucher": "668800008888",
        "voucherType": 0
    }
]

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.

Asynchronous Order Processing

When creating an order, clients can enable asynchronous processing by setting the async parameter to true.

With asynchronous processing enabled, Dragonpass will first perform the required validations, such as entitlement/usage eligibility, available balance, pricing, and other mandatory checks. Once these validations are completed and the order has been successfully accepted, the API may return the order with a 5-Pending status.

"status": 5

A 5-Pending status means that the order request has been successfully received and accepted by Dragonpass for further processing. It does not mean that the service has been confirmed or is ready for use. Clients should not present the order to the end user as a confirmed notification while it remains in this status.

The order becomes valid for service usage only after the processing is completed successfully and the order status changes to 1-Confirmed.

For Fast Track Module, clients can use resources at Suvarnabhumi Airport(BKK) to test the Pending status flow. Orders created for these resources will initially remain in Pending status approximately 30 seconds.

Clients can obtain the latest order status using either of the following approaches:

Order Status Polling
Periodically call the Order Details API using the orderId until the order reaches a final or actionable status, such as 1-Confirmed or 10-Failed.
→ Retrieve E-pass Usage Order Details
→ Retrieve Membership Usage Order Details

Webhook Notification
Subscribe to DP webhook notifications. Dragonpass will send an order status update notification when the order status changes, allowing the client to update the order without continuously polling the API.
→ Prebooking Order Status Change Event

For the best integration experience, webhook notifications are recommended as the primary mechanism, while the Order Details API can be used as a fallback or for status reconciliation.

Preview Prebooking

→ /orders/fastTrack/memberships/prebooking/preview
Before placing a membership prebooking order, clients can call this API to:

Validate whether the requested entitlement usage is acceptable

Preview how many funded and purchaseed entitlements will be deducted

Ensure the entitlement deduction result matches business expectations

Clients may only specify how many entitlements are used by the cardholder and guests. The specific entitlement types to be deducted are determined by the system.

Request

Preview Membership Prebooking Order - Request

{
    "module": 2,
    "membershipId": "8888000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "cashPaymentApplied": false,
        "toUseEntitlementCount": 1,
        "toUseEntitlementDetail": {
            "cardholder": 1,
            "guest": 0
        }
    }
}

Response

Preview Membership Prebooking Order - Response

{
    "code": 0,
    "data": {
        "module": 2,
        "category": 2,
        "membershipId": "8888000066668888",
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0,
                "purchasedEntitlements": 0
            },
            "usedEntitlementBreakdown": [
                {
                    "sourceType": "module_exclusive",
                    "tier": 1,
                    "entitlements": {
                        "cardholderExclusiveEntitlements": 1,
                        "guestsExclusiveEntitlements": 0,
                        "sharedEntitlements": 0
                    }
                }
            ],
            "cashPaymentApplied": false,
            "resourceId": "C00001",
            "resourceName": "Dragonpass Fast Track Service"
        }
    }
}

Example	Declared Usage (Cardholder / Guest)	Available Entitlements (C / G / S)	Deduction Result (C / G / S)	Notes
1	1 / 0	1 / 1 / 1	1 / 0 / 0	Cardholder-exclusive entitlement is used
2	1 / 1	1 / 1 / 0	1 / 1 / 0	Cardholder and guest-exclusive entitlements are used
3	1 / 1	1 / 0 / 1	1 / 0 / 1	Shared entitlement is automatically used for guest
4	1 / 2	1 / 0 / 2	1 / 0 / 2	Multiple guests are covered by shared entitlements
5	1 / 1	1 / 0 / 0	❌ Validation Failed	Insufficient entitlements for guest usage

Create Prebooking

→ Use /orders/fastTrack/memberships/prebooking to make a prebooking for Dragonpass Fast Track service in advance by utilizing membership.

Request

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

Create Membership 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,
    "membershipId": "8888000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "cashPaymentApplied": false,
        "toUseEntitlementCount": 1,
        "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

A successful response returns the following information about the order

Create Membership 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,
        "category": 2,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": "2025-10-01T10:35:26+00:00",
            "cashPaymentApplied": false,
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0,
                "purchasedEntitlements": 0
            },
            "usedEntitlementBreakdown": [
                {
                    "sourceType": "module_exclusive",
                    "tier": 1,
                    "entitlements": {
                        "cardholderExclusiveEntitlements": 1,
                        "guestsExclusiveEntitlements": 0,
                        "sharedEntitlements": 0
                    }
                }
            ],
            "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",
                "transportNumber": "EK0001"
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 0
            }
        }
    }
}

Cancel Prebooking

→ 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#

Voucher Generation & Presentation#

Asynchronous Order Processing#

Preview Prebooking#

Create Prebooking#

Cancel Prebooking#

Fast Track Prebooking

Voucher Generation & Presentation

Asynchronous Order Processing

Preview Prebooking

Create Prebooking

Cancel Prebooking