Refund
Modified on: 2026-10-13 10:45
TABLE OF CONTENTS
This section outlines the high-level workflow for submitting a refund request for an existing ticket. The API supports two distinct flows, depending on whether you need to check the estimated refund amount before proceeding.
Flow 1: Direct Refund
This is a straightforward process for immediately submitting a refund request:
Step 1: Retrieve Order Details (orderRetrieve)
- Fetch the latest order details
Step 2: Submit Refund Request (orderChange)
- Initiate the refund process directly. The final refundable amount and result are determined by the supplier during processing.
Step 3: Check Refund Status & Amount:
- The final result—including the approved refund amount and status— can be retrieved by:
- Polling: Calling the orderRetrieve operation to find the updated refund status in the order details.
- Webhook Notification: Receiving a push notification with the outcome once processing is complete.
Flow 2: Refund with Estimate
This two-step process allows you to check the estimated refund amount before formally submitting the request:
Note: The Refund with Estimate flow (which would involve a preliminary request to the airline for a refund calculation before formal submission) is currently under development and is not yet supported.

Step 1: Retrieve Order Details (orderRetrieve)
- Fetch the latest order details
Step 2: Get Refund Estimate (refundEstimate)
- Request a preliminary calculation of the refundable amount from suppliers
Step 3: Submit Refund Request (orderChange)
- After reviewing the estimate, formally submit the refund request.
Step 4: Check Refund Status & Amount
- The final result—including the approved refund amount and status— can be retrieved by:
- Polling: Calling the orderRetrieve operation to find the updated refund status in the order details.
- Webhook Notification: Receiving a push notification with the outcome once processing is complete.
AirAsia Refund Reason Mapping
The following table outlines the mapping between the standard refund reason codes used in the GDN API and the corresponding AirAsia (WANO) refund categories.
| Refund Type | GDN API Value | GDN API Refund Reason | AirAsia Mapping(GDN <> WANO) |
|---|---|---|---|
Voluntary Refund | 0 | Personal Reason | Airport Tax |
| 4 | Double Payment | Double Payment | |
| 5 | Duplicate Booking | Duplicate Booking | |
| 6 | Korea Voluntary Cancellation | Korea Voluntary Cancellation | |
| 7 | Indonesia Domestic Voluntary Cancellation | Indonesia Domestic Voluntary Cancellation | |
| 8 | United States Voluntary Cancellation | United States Voluntary Cancellation | |
| 12 | Other | Other Note: Use only for abnormal/exceptional refund. Incorrect usage may lead to manual review or refusal. | |
| Involuntary | 1 | Illness Reason | Medical |
| Refund | |||
| 2 | Schedule Change Reason | Flight Reschedule | |
| 3 | Visa Refusal | ❌ Not Supported | |
| 9 | Flight Cancellation | Flight Cancellation | |
| 10 | Deceased Guest | Deceased Guest | |
| 11 | Connecting Flight Affected | Connecting Flight Affected |
Did you find it helpful? Yes No
Send feedback