DragonPass supports two main order business types:Pre-booking (Reservation Before Usage)
Order Status Enumeration#
| Enum | Status | Description |
|---|
| 1 | Confirmed | The order has been confirmed and is ready to be used. |
| 2 | Used | The order has been used to access the service. |
| 3 | Cancelled | The order has been cancelled and cannot be used. |
| 4 | Expired | The order was not used before its validity period and has expired. |
| 5 | Pending | The order has been created and is awaiting confirmation. This may include waiting for availability checks, or third-party responses. |
| 10 | Failed | The order failed to be created or processed due to errors or unavailability. |
Walk-in Orders (Instant Usage)#
How It Works#
Services that do not require advance prebooking. Users access the service directly on-site (e.g. lounge walk-in)The user presents one of the following at the service point:Once validation is completed successfully, the system immediately records this usage. Walk-in orders are created directly in Used status.Order Status Behavior#
For walk-in orders, only two order statuses are applicable:| Status | Name | Description |
|---|
| 2 | Used | The service has been accessed and the usage is recorded successfully. |
| 3 | Cancelled | The usage has been cancelled after it was recorded, and the related entitlement has been refunded. |
Walk-in orders do not go through Pending or Confirmed statuses.
Cancellation After Usage#
In certain exceptional cases, a walk-in usage may be cancelled after it has already been marked as Used. For example:The user successfully enters the lounge, and the usage is recorded as a walk-in order with status Used.
If the user is dissatisfied with the lounge experience, they may request the lounge staff to cancel the usage.
Upon initiation by the lounge staff, the order status is updated from Used to Cancelled, and the corresponding entitlement is fully refunded to the user.
Cancellation is subject to resource operational rules and approval.
Prebooking Orders (Reservation Before Usage)#
How It Works#
Some services require advance reservation before the service can be used(e.g. Fast Track).For these services, users need to create an order first, and the service can only be used after the order has been successfully confirmed.Order Status Behavior#
Prebooking orders go through multiple statuses to reflect whether the service has been successfully reserved, is ready to be used, or has already been consumed.Unlike walk-in usage, creating a prebooking order does not immediately guarantee service availability. The order status should always be checked before attempting to use the service.| Status | Name | Description |
|---|
| 5 | Pending | The order has been created and is awaiting confirmation. The service is not yet available for use. |
| 1 | Confirmed | The order has been successfully confirmed. The service is ready to be used. |
| 2 | Used | The service has been successfully used and the order is completed. |
| 3 | Cancelled | The order has been cancelled and can no longer be used. |
| 10 | Failed | The order could not be confirmed due to errors or resource unavailability. |
Order Flow#
Monitoring Order Status Changes#
Option 1: Webhook Notifications (Recommended)
Option 2: Query Order Details API
