DragonPass API Developer Platform
v2
  • v2
  • v1
HomepageOfficial SiteContact Us
HomepageOfficial SiteContact Us
API Version
v2
  • v2
  • v1
  1. Development Guide
  • 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. Development Guide

Sandbox Order Simulation

DragonPass provides a set of simulation APIs that allow clients to simulate order redemption and cancellation in the sandbox environment. These APIs are useful for validating business logic and access control before committing to production transactions.

Lounge (Walk-in & Prebooking)#

All simulations(Walk-in & Prebooking) will be processed with N00012 - Plaza Premium Lounge, Hong Kong International Airport, Hong Kong.

1. Simulate Walk-in Order Redemption#

Use /simulations/lounges/redemptions to simulate the redemption of a lounge service using either an E-pass or Membership.
Request
Simulate Lounge Redemption - Request

{
    "dpId": "1788000066668888",
    "adultCount": 1,
    "childCount": 0
}
Response
Simulate Lounge Redemption - Response

{
    "code": 0,
    "data": {
        "dpId": "1788000066668888",
        "transactionId": "DPSL00001",
        "message": "Order Created"
    }
}

2. Simulate Prebooking Order Redemption#

Use /simulations/lounges/prebookings/redemptions to simulate the redemption of a lounge prebooking order.
The prebooked order can only be redeemed from 1 hour before to 3 hours after the prebooking time, please confirm that time in your test order. N00012 is located in Hong Kong (UTC+8).
Request
Simulate Lounge Prebooking Order Redemption - Request

{
    "voucher": "668800008888",
    "adultCount": 1,
    "childCount": 0
}
Response
Simulate Fast Track Order Redemption - Prebooking - Response

{
    "code": 0,
    "data": {
        "voucher": "668800008888",
        "transactionId": "DPSL00001",
        "message": "Order Created"
    }
}

3. Simulate Order Cancellation#

Use /simulations/lounges/cancellation to simulate the order cancellation.
This API can cancel both Walk-in orders and Prebooking orders.
Request
Simulate Fast Track Order Cancellation - Request

{
    "dpId": "1788000066668888",
    "transactionId": "DPSL00001"
}
Response
Simulate Lounge Order Cancellation - Response

{
  "code": 0,
  "data": {
    "dpId": "1788000066668888",
    "transactionId": "DPSL00001",
    "message": "Order Cancelled"
  }
}

Fast Track (Prebooking)#

All simulations will be processed with C10826 - Suvarnabhumi Airport(BKK) International Departure, Bangkok, Thailand.

1. Simulate Prebooking Order Redemption#

Use /simulations/fastTrack/prebookings/redemptions to simulate the redemption of a Fast Track prebooking order.
The prebooked order can only be redeemed from 1 hour before to 3 hours after the prebooking time, please confirm that time in your test order. N10826 is located in Thailand (UTC+7).
Request
Simulate Fast Track Order Redemption - Prebooking - Request

{
    "voucher": "668800008888",
    "adultCount": 1,
    "childCount": 0
}
Response
Simulate Fast Track Order Redemption - Prebooking - Response

{
    "code": 0,
    "data": {
        "voucher": "668800008888",
        "transactionId": "DPFT00001",
        "message": "Order Created"
    }
}

2. Simulate Order Cancellation#

Use /simulations/fastTrack/cancellation to simulate the order cancellation.
Request
Simulate Fast Track Order Cancellation - Request

{
    "voucher": "668800008888",
    "transactionId": "DPFT00001"
}
Response
Simulate Fast Track Order Cancellation - Response

{
    "code": 0,
    "data": {
        "voucher": "668800008888",
        "transactionId": "DPFT00001",
        "message": "Order Cancelled"
    }
}
Modified at 2026-02-03 06:05:23
Previous
Authentication
Next
Instructions