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