DragonPass API Developer Platform
v2
  • v2
  • v1
HomepageOfficial SiteContact Us
HomepageOfficial SiteContact Us
API Version
v2
  • v2
  • v1
  1. DragonPass API Push Event
  • Implementation Guide
    • DragonPass Modules
    • Get Started
    • Our API Solution
  • Development Guide
    • Response Format
    • Error Codes
    • Multiple Language Support and Fallback
    • UI Design Guidelines
    • Authentication
    • Sandbox Order Simulation
  • DragonPass API Push Event
    • Instructions
    • Lounge/Dining Walk-in Redemption Event
    • Prebooking Order Status Change Event
    • Resource Update Push Service
  • Using the API
    • Search for Resources
      • Search for Resources
      • Check Prebooking Resource & Option Availability
      • Pricing Query
      • Image Parameters
    • Order Lifecycle
      • Walk-in & Prebooking Order
      • Order Status Enumeration
    • E-pass
      • Querying E-pass Usage Orders and Details
      • Issuing, Querying, and Cancelling an E-pass
      • Utilizing The E-pass
        • Lounge
        • Fast Track
        • Dining
        • Fitness
        • eSIM
        • Cross Module
    • Membership
      • Manage Memberships & Entitlements
      • Querying Membership Usage Orders and Details
      • Utilizing DragonPass Membership
        • Lounge
        • Fast Track
        • Dining
        • Fitness
        • eSIM
    • User
      • User Management
  • Release Notes
    • 2026
    • 2025
  • Migration Guide
    • From V1 to V2
  • API Reference
    • Authentication
      • Generate Access Token
    • User Management
      • User Creation
      • Update User Information
      • Retrieve User Information
      • Retrieve User E-passes List
      • Retrieve User Memberships List
      • Delete A User
    • Search
      • Retrieve Available Modules by Location
      • Aggregated Search by Keyword
    • Transport Hubs
      • Retrieve Transport Hub
      • Retrieve Transport Hub Details
    • Resources
      • Retrieve Resource List
        • Retrieve Resources List
      • Search For Resources
        • Retrieve Resource Details
        • List Updated Resources
      • Check Resource Availability
        • Check Prebooking Resource Availability
        • Check Prebooking Option Availability
      • Fitness
        • Retrieve Fitness Resources Schedule
        • Retrieve Fitness Resource Option Details
      • eSIM
        • Retrieve eSIM Resouces Options
        • Retrieve eSIM Resource Option Details
      • Pricing
        • Retrieve Resource Pricing Information
        • Retrieve Prebooking Option Pricing Information
    • Entitlement Management
      • Update Membership Entitlements
      • Retrieve Membership Entitlement Information
    • Membership Management
      • Membership Registration
      • Update A Membership
      • Retrieve Membership Information
      • Generate Membership Dynamic QR Codes
      • Change Membership Program(Upgrade/Downgrade)
    • Orders Management
      • Preview Orders
        • Membership
          • Preview Membership Prebooking Order
      • Create Orders
        • E-pass
          • Issue An E-pass
            • Create E-pass Order
          • Lounge Prebooking
            • Create E-pass Prebooking Order - Lounge
            • Create E-pass with Prebooking Order - Lounge
          • Fast Track
            • Create E-pass Prebooking Order - Fast Track
            • Create E-pass with Prebooking Order - Fast Track
          • Fitness
            • Create E-pass Prebooking Order - Fitness
            • Create E-pass with Prebooking Order - Fitness
          • eSIM
            • Create E-pass Prebooking Order - eSIM
            • Create E-pass with Prebooking Order - eSIM
            • Top up eSIM data package - E-pass
        • Membership
          • Create Membership Prebooking Order - Lounge
          • Create Membership Prebooking Order - Fast Track
          • Create Membership Prebooking Order - Fitness
          • Create Membership Prebooking Order - eSIM
          • Top up eSIM data package - Membership
      • Retrieve Order List
        • Retrieve E-pass Order List
        • Retrieve Membership Order List
      • Cancel Orders
        • Cancel an Order
      • Retrieve Order Details
        • E-pass
          • Retrieve E-pass Details
          • Retrieve E-pass Usage Order Details
        • Membership
          • Retrieve Membership Usage Order Details
      • Module Specific APIs
        • Fitness
          • Fitness Order Check-In
        • eSIM
          • Retrieve eSIM Order Live Extended Details
          • Check eSIM Top-up Availability
          • Retrieve eSIM Data Packages
    • [Sandbox Only] Simulation
      • Lounge
        • Simulate Lounge Redemption - Walk in
        • Simulate Lounge Redemption - Prebooking
        • Simulate Lounge Order Cancellation
      • Fast Track
        • Simulate Fast Track Redemption - Prebooking
        • Simulate Fast Track Order Cancellation
    • Push Event Recovery
      • Push Event Recovery
  • Our Team
  1. DragonPass API Push Event

Prebooking Order Status Change Event

Description#

Event Name: prebooking.statusChanged
Payload Focus:
Order ID
Previous and current status
Timestamp of the change
Trigger Condition: When the status of a prebooking order changes (e.g., confirmed, cancelled, modified, redeemed).

Supported Modules#

1.
Lounge Prebooking
2.
Fast Track Prebooking
3.
Fitness
4.
eSIM

Message Example#

{
  "eventType":"prebooking.statusChanged",
  "orderId": "PB00000000000001",
  "programId": "1888000000000001",
  "dpId": "8888000066668888",
  "module": 1,
  "previousStatus": 0,
  "currentStatus": 1,
  "statusChangedDate": "2025-01-01T10:00:00+00:00",
  "remarks": null
}

Field Descriptions#

ColumnDescriptionExample
eventTypeSpecifies the type of push event. Used to distinguish between different kinds of notifications, e.g., walkin.redemption, prebooking.statusChanged.prebooking.statusChanged
orderIdUnique identifier of the usage order, generated by DragonPass each time a user utilizes their Membership or E-pass.DP00000000000001
programIdUnique identifier of the program. Assigned by DragonPass when a new program was onboarded.1888000000000001
dpIdUnique ID for the DragonPass Membership or E-pass.8888000066668888
moduleSpecifies the module associated with the order(s), e.g. "Lounge", "Fast Track".1
previousStatusThe status of the prebooking order before the change occurred.5
currentStatusThe status of the prebooking order after the change occurred.2
statusChangedDateThe timestamp when the prebooking order status transition took place (in UTC+0).2024-12-31T00:00:00+00:00
remarksAdditional information provided only in special cases, initiated by DragonPass. For example, this field may contain details when certain resources become unavailable due to unexpected circumstances.string
status

Event Logic#

After the necessary steps are completed within DragonPass system, and the prebooking order status is updated, a status change notification will be sent to the client.
📌
In some cases, status change notifications may arrive out of sequence due to network latency or other unforeseen issues. To ensure consistency, clients must handle idempotency based on the combination of Order Id and Status Changed Date.

Response#

A push is considered successfully received only if the client returns HTTP status code 200 OK along with following JSON response:
{
  "status": "success"
}
Modified at 2025-12-19 08:26:02
Previous
Lounge/Dining Walk-in Redemption Event
Next
Resource Update Push Service