Ticket Processing APIs
After successful booking, use these APIs to request ticket issuance and monitor the status of your bookings.
Ticket Request API
POST
Endpoint:[BaseUrl]/flight-ticket-requestProcess Flow
- Submit ticket request with BookingTransactionRef
- Status changes to "TICKET IN PROCESS"
- Admin processes within 20 minutes
- Monitor status using flight-details API
- Final status: "CONFIRMED" or "REJECTED"
Detailed Ticketing Process
Initial Request
- User submits ticket confirmation request
- Prerequisites:
- Valid PNR generated
- Sufficient balance available
- Within last ticketing time
Processing Phase
- Status updates to "TICKET IN PROCESS"
- Admin team begins processing
- Maximum processing time: 20 minutes
API Interaction
- System communicates with /flight-details API
- Attempts to confirm ticket
- Retrieves ticket number if successful
Final Outcome
Successful Scenario:
- Booking Status: "CONFIRMED"
- Ticket Status: "SUCCESS"
- Ticket number issued
Failed Scenario:
- Booking Status: "REJECTED"
- Automatic refund initiated
- User notified of failure
Ticket Request
{
"BookingTransactionRef": "NZ23479361030810773"
}Ticket Request Response
{
"flag": true,
"code": 200,
"message": "Success",
"data": {
"Warnings": [],
"TicketInfoes": [
{
"PassengerInfo": {
"NameElement": {
"Title": "MR",
"FirstName": "TEST",
"LastName": "TEST"
},
"ContactInfo": {
"Email": "TEST@GMAIL.COM",
"Phone": "7992453938",
"PhoneCountryCode": "+60",
"CountryCode": "MY"
},
"DocumentInfo": {
"DocumentType": "passport",
"DocumentNumber": "PASSPORT",
"ExpireDate": "2025-10-28",
"IssuingCountry": "MY",
"Nationality": "MY"
},
"PassengerType": "ADT",
"Gender": "Male",
"DateOfBirth": "1999-06-09"
}
}
],
"FlightInfo": {
"Directions": [[{
"Origin": "KUL",
"Destination": "DAC",
"PlatingCarrierCode": "BG",
"Segments": [{
"FlightNumber": "387",
"Departure": "2025-01-15 02:30:00",
"Arrival": "2025-01-15 04:20:00",
"Duration": ["3h 50m"],
"ServiceClass": "Economy"
}]
}]],
"BookingComponent": {
"TotalPrice": "16482.00",
"BasePrice": "13831.00",
"Taxes": "2602.00"
}
},
"BookingStatus": "TICKET IN PROCESS",
"PaymentStatus": "SUCCESS",
"TicketStatus": "PENDING",
"BookingTransactionRef": "NZ23479361030810773"
}
}Flight Details API
POST
Endpoint:[BaseUrl]/flight-detailsKey Features
- Retrieve current booking status
- Get ticket numbers when issued
- View passenger and flight details
- Check payment status
Detailed Information
The API allows users to retrieve booking details and updates after a booking operation.
Booking Status Types:
- TICKET IN PROCESS - Booking is being processed
- CONFIRMED - Booking has been confirmed
- REJECTED - Booking has been rejected
Ticket Status Types:
- CONFIRMED - Ticket has been successfully issued
- FAILED - Ticket issuance has failed
Real-time Monitoring Features:
- Live booking status updates
- Instant ticket status changes
- Payment status tracking
Flight Details Request
{
"BookingTransactionRef": "NZ23479523302253652"
}Flight Details Response
{
"flag": true,
"code": 200,
"message": "Success",
"data": {
"TicketInfoes": [{
"PassengerInfo": {
"NameElement": {
"Title": "MR",
"FirstName": "TEST",
"LastName": "TEST"
},
"ContactInfo": {
"Email": "TEST@GMAIL.COM",
"Phone": "7992453938"
}
}
}],
"FlightInfo": {
"Directions": [[{
"Origin": "KUL",
"Destination": "DAC",
"Segments": [{
"FlightNumber": "387",
"Departure": "2025-01-15 02:30:00",
"Arrival": "2025-01-15 04:20:00",
"ServiceClass": "Economy"
}]
}]]
},
"PNR": "9F162H",
"BookingStatus": "TICKET IN PROCESS",
"PaymentStatus": "SUCCESS",
"TicketStatus": "PENDING",
"BookingTransactionRef": "NZ23479523302253652"
}
}Important Notes:
- Monitor booking status regularly
- Keep track of lastTicketingTime
- Store BookingTransactionRef for reference
- Implement timeout handling for long processes
- Validate all responses for error messages