Local Offer

Kindly note that currently each Local Offer order allows only one person.

For lifestyle-related services, such as Fitness and eSIM, each resource (e.g., a specific fitness club or an eSIM for a certain region) may offer multiple options (e.g., different fitness classes or data plans). Orders are created at the option level under the corresponding resource.

Local Offer Prebooking

The prebooking process follows these main steps:

Retrieve Option List

Retrieve the list of available options for a specific resource.

Availability Check

Query the availability of a specific option within a given resource for the specified date and time.

Prebooking Creation

If available, a prebooking order can be created. The order remains cancellable within the applicable cancellation policy window.

Service Access

After an offer order is successfully created, clients must generate and display the voucher based on the vouchersList returned in the order response.
Users must present the voucher at the participating merchant to redeem the corresponding offer or discount.

Create Offer Orders

→ Use /v2/orders/{module}/ePasses/prebooking to place a Local Offer order with an E-pass.

Request

Create E-pass Prebooking Order - Local Offer - Request

As required by airports and partners, certain resource prebooking orders will need the passenger's name, email, phone number, or flight number for booking information.
For the required information at specific locations, please refer to theprebookingRequiredInfoprovided in the /resources/{resourceId} response.

According to the requirements of the service resources, Dragonpass only collects the necessary personally identifiable information (PII) for each order.

Even if clients provide additional or unnecessary PII, we will not store it. Such data will be discarded and displayed as null in the order details.

{
    "module": 11,
    "ePassId": "1788000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "prebookingRequiredInfo": {}
    }
}

Response

Create E-pass Prebooking Order - Local Offer - Response

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 11,
        "category": 2,
        "ePassId": "1788000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "usedUsages": 1,
            "resourceId": "GR0006118",
            "resourceName": "The Malayan Council, Dunlop",
            "vouchersList": [
                {
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {},
            "localOfferOptions": {
                "optionId": "LO00001",
                "optionName": "5% discount",
                "redemptionUrl": "https://dp.com/001",
                "voucherValidUntil": "2027-04-01T00:00:00+00:00"
            }
        }
    }
}

Voucher Generation & Presentation

After a prebooking order is successfully created and the order status becomes Confirmed, clients must generate and display the voucher based on the vouchersList returned in the order response.

Users must present the rendered voucher at the service point to access the service

Lounge: typically 1 voucher per order

Fast Track/Fitness/Local Offer: may include per-passenger vouchers

For prebooking orders, always use the voucher value from vouchersList. Using the E-pass ID may lead to service denial.

Voucher Source Example:

"vouchersList": [
    {
        "voucher": "668800008888",
        "voucherType": 1
    }
]

Different resources may return different voucher types, the way to present the voucher depends on voucherType:

voucherType	Type	Instruction
1	QR Code	Convert the voucher into a QR code and display it to the user, or direct the user to redeem it through the specified website when a `redemptionUrl` is provided.
2	Barcode	Convert the voucher into a barcode and display
3	Image	Display the image directly
4	Verification Code	Show the code directly to staff, or direct the user to redeem it through the specified website when a `redemptionUrl` is provided.
5	URL	Access the merchant's website using the URL returned in the response to enjoy the corresponding discount or promotional offer

redemptionUrl

For certain Local Offers, voucher types 1 (QR Code) and 4 (Redemption Code) may also be returned together with a redemptionUrl.

In these cases, the voucher cannot be redeemed directly at a physical location. Instead, users must access the specified website through the redemptionUrl and complete the redemption process using the provided voucher or redemption code.

Example:

"vouchersList": [
    {
        "voucher": "ABCD1234",
        "voucherType": 1
    }
],
"localOfferOptions": {
    "optionId": "LO00001",
    "optionName": "5% discount",
    "redemptionUrl": "https://dp.com/001",
    "voucherValidUntil": "2027-04-01T00:00:00+00:00"
}

In the above example, the user should visit the redemptionUrl and enter the redemption code ABCD1234 on the merchant's website to claim the offer.

When redemptionUrl is provided, clients should prominently display both the voucher and the URL, and guide users to complete redemption through the specified website.

Cancel Orders

→ Use the /orders endpoint to cancel a prebooking order by order ID.

A prebooking order can be cancelled in accordance with the cancellation policy. Once cancelled, the corresponding usages will be refunded to the E-pass.

Whether a prebooking order can be canceled depends on the cancellation policy provided in the /resources/{resourceId} response, usually:

Local Offer orders can be cancelled at any time before redemption, provided the offer is still within its validity period. Once redeemed or expired, the order can no longer be cancelled.

Please note that once a prebooking order is cancelled, it cannot be recovered.

Local Offer Prebooking#

Create Offer Orders#

Voucher Generation & Presentation#

redemptionUrl#

Cancel Orders#

Local Offer Prebooking

Create Offer Orders

Voucher Generation & Presentation

redemptionUrl

Cancel Orders