Dragonpass API Developer Platform
v2
  • v2
  • v1
API Doc
PlaygroundShare FeedbackDragonPassContact Us
API Doc
PlaygroundShare FeedbackDragonPassContact 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
        • Cross Module
        • Lounge
        • Fast Track
        • Dining
        • Fitness
        • eSIM
        • Local Offer
    • Membership
      • Manage Memberships & Entitlements
      • Querying Membership Usage Orders and Details
      • Utilizing Dragonpass Membership
        • Lounge
        • Dining
        • Fast Track
        • Fitness
        • eSIM
    • User
      • User Management
  • Push Event
    • Instructions
    • Lounge/Dining Walk-in Redemption Event
    • Prebooking Order Status Change Event
    • Resource Update Push Service
  • Release Notes
    • 2026
    • 2025
  • 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 Resources Options
        • Retrieve eSIM Resource Option Details
      • Local Offer
        • Retrieve Local Offer Resouces Options
        • Retrieve Local Offer Resource Option Details
    • 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
          • Local Offer
            • Create E-pass Prebooking Order - Local Offer
            • Create E-pass with Prebooking Order - Local Offer
          • 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
        • Usage Details
          • Retrieve E-pass Usage Order Details
        • 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
    • 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
          • Create Membership Prebooking Order - Local Offer
        • 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
      • Set Meal
        • Simulate Set Meal Redemption - Walk in
        • Simulate Set Meal Order Cancellation
      • Coupon
        • Simulate Dining Coupon Redemption - Walk in
        • Simulate Dining Coupon Order Cancellation
    • SSO
      • Create SSO Link
    • Payment
      • Order Payment
  • FAQ
  • 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. 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. 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. 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. 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. 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"
    }
}

Set Meal#

All simulations will be processed with N04091 - Crystal Jade Go - Set Meal, SIN, Singapore International Airport.

1. Walk-in Order Redemption#

Use /v2/simulations/setMeals/redemptions to simulate the redemption of a Set Meal service using either an E-pass or Membership.
Request
Simulate Set Meal Redemption - Request

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

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

2. Order Cancellation#

Use /v2/simulations/setMeals/cancellation to simulate the order cancellation.
Request
Simulate Set Meal Order Cancellation - Request

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

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

Coupon#

All simulations will be processed with N04091 -N12078-GIRAFFE, MAN, Manchester Airport.

1. Walk-in Order Redemption#

Use /v2/simulations/coupons/redemptions to simulate the redemption of a Dining Coupon using either an E-pass or Membership.
Request
Simulate Coupon Redemption - Request

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

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

2. Order Cancellation#

Use /v2/simulations/coupons/cancellation to simulate the order cancellation.
Request
Simulate Coupon Order Cancellation - Request

{
    "dpId": "1788000066668888",
    "transactionId": "DPMV00001"
}
Response
Simulate Coupon Cancellation - Response

{
    "code": 0,
    "data": {
        "dpId": "1788000066668888",
        "transactionId": "DPSL00001"
        "message": "Order Cancelled"
    }
}
Modified at 2026-09-01 08:20:19
Previous
Multiple Language Support and Fallback
Next
UI Design Guidelines