Void Ticket

Void issued flight tickets and optionally cancel the associated booking. This endpoint handles ticket voiding operations for both individual tickets and complete bookings.

---

Endpoint

• URL: /api/v1/flight/voidticket
• Method: POST
• Auth Required: Yes (Bearer Token/X-API-KEY)
• Content-Type: application/json

---

Authentication

This endpoint requires a valid JWT Bearer token in the Authorization header:

Authorization: Bearer <access_token>

Obtain tokens via /api/v1/sign-in (POST) with your credentials.

---

Request Structure

Field	Type	Required	Description
system	string	No	Booking system code (e.g., VN, VJ, 1A)
bookingCode	string	No	Booking code (PNR)
isCancelBooking	boolean	No	Whether to cancel booking after voiding tickets (True: Cancel PNR, False: Don't cancel PNR)
isVoidAllTicket	boolean	No	Whether to void all tickets in the booking (True: Void all tickets, False: Void specific tickets)
ticketNumbers	array	No	List of specific ticket numbers to void
orderInfo	object	No	NDC order information (see NdcOrderInfoVoid)

NdcOrderInfoVoid Object

Field	Type	Required	Description
orderItemInfos	array	No	List of NDC order item information (see NdcOrderItemInfo)

NdcOrderItemInfo Object

Field	Type	Required	Description
orderItemRefID	string	No	NDC order item reference ID

Example Request:

{
  "system": "VN",
  "bookingCode": "ABC123",
  "isCancelBooking": false,
  "isVoidAllTicket": true,
  "ticketNumbers": [
    "2389876543210",
    "2389876543211"
  ]
}

---

Request Constraints & Business Rules

• Tickets must be in a voidable status (typically issued within 24 hours).
• If isVoidAllTicket is true, all tickets in the booking will be voided.
• If isCancelBooking is true, the booking will be cancelled after ticket voiding.
• Specific ticket numbers can be provided to void only certain tickets.
• Void operations must comply with airline-specific time limits.
• NDC bookings require additional order information.
• Voided tickets cannot be used for travel and may be eligible for refund.

---

Response Structure

Field	Type	Nullable	Description
system	string	Yes	System name (e.g., VN, VJ, 1A)
status	boolean	No	true if successful, false if failed
error	object	Yes	Error details (if any)
description	string	Yes	Error description (if any)
trackingId	string	Yes	Tracking ID for request logs
trackingTime	string	Yes	Time for request tracking (ISO 8601 format)
voidedTickets	array	Yes	List of voided tickets
refundInformation	object	Yes	Refund information for voided tickets

Voided Ticket Object

Field	Type	Nullable	Description
ticketNumber	string	Yes	Voided ticket number
ticketStatus	string	Yes	Status of the voided ticket

Refund Information Object

Field	Type	Nullable	Description
offerID	string	Yes	Offer ID for refund
ownerCode	string	Yes	Owner airline code
description	string	Yes	Refund description
refundDetails	array	Yes	Detailed refund information

Example Response:

{
  "system": "VN",
  "status": true,
  "error": null,
  "description": null,
  "trackingId": "abc-123",
  "trackingTime": "2024-06-01T12:00:00Z",
  "voidedTickets": [
    {
      "ticketNumber": "2389876543210",
      "ticketStatus": "VOIDED"
    },
    {
      "ticketNumber": "2389876543211",
      "ticketStatus": "VOIDED"
    }
  ],
  "refundInformation": {
    "offerID": "OFFER-001",
    "ownerCode": "VN",
    "description": "Ticket void refund",
    "refundDetails": [
      {
        "amount": 2350000,
        "currency": "VND",
        "refundType": "AUTOMATIC"
      }
    ]
  }
}

---

Error Codes

See Error Codes for details on possible error responses.

---

Security & Validation

• All input is validated for type and required fields.
• Only authenticated users can access this endpoint.
• Booking codes are verified against existing bookings.
• Ticket numbers are validated for void eligibility.
• Time limits for voiding are enforced based on airline policies.
• All void operations are logged and traceable.
• Refund calculations are performed according to fare rules.

---

Validation Questions

• What are the time limits for voiding tickets after issuance?
• How are refund amounts calculated for voided tickets?
• Can partially used tickets be voided?
• What happens to associated services (seats, baggage) when tickets are voided?

---

For integration support, see Contact Support.