Lounge

Lounge Walk-in

After registering an DragonPass Membership, clients can generate a QR code for this membership and display it in their own application.

Users can present this QR code to access DragonPass lounges. DragonPass will verify the membership validity and deduct the entitlements accordingly.

For guidance on how to display membership information in your application, please refer to the UI Design Guidelines section.

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

Preview Prebooking

→ /orders/lounges/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": 1,
    "membershipId": "8888000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "cashPaymentApplied": false,
        "toUseEntitlementCount": 1,
        "toUseEntitlementDetail": {
            "cardholder": 1,
            "guest": 0
        }
    }
}

Response

Preview Membership Prebooking Order - Response

{
    "code": 0,
    "data": {
        "module": 1,
        "category": 2,
        "membershipId": "8888000066668888",
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0
            },
            "cashPaymentApplied": false,
            "resourceId": "N00001",
            "resourceName": "DragonPass Lounge"
        }
    }
}

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/lounges/memberships/prebooking to make a prebooking for DragonPass Lounge 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 - Lounge - 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": 1,
    "membershipId": "8888000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "cashPaymentApplied": false,
        "toUseEntitlementCount": 1,
        "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 - Lounge - Response

For the lounge module, each order includes only 1 voucher, regardless of the number of passengers in the order.

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 1,
        "category": 2,
        "membershipId": "8888000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "cashPaymentApplied": false,
            "usedEntitlementDetails": {
                "cardholderExclusiveEntitlements": 1,
                "guestsExclusiveEntitlements": 0,
                "sharedEntitlements": 0
            },
            "resourceId": "N00001",
            "resourceName": "DragonPass Lounge",
            "iata": "MAN",
            "transportHubName": "Manchester Airport",
            "terminal": "Terminal 1",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "vouchersList": [
                {
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "email": "developer@dragonpass.com",
                "phoneNumber": "8081966002",
                "callingCode": "44",
                "flightNumber": "EK0001"
            },
            "passengerCounts": {
                "cardholder": 1,
                "guests": 0
            }
        }
    }
}

Cancel Prebooking

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

Prebooking order cancellation policy
A prebooking order can be cancelled in accordance with the cancellation policy. Once cancelled, the corresponding entitlements will be refunded to the membership.

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.

Lounge Walk-in#

Lounge Prebooking#

Preview Prebooking#

Create Prebooking#

Cancel Prebooking#

Lounge Walk-in

Lounge Prebooking

Preview Prebooking

Create Prebooking

Cancel Prebooking