Booking APIS
Ticket Processing

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-request

Process Flow

  1. Submit ticket request with BookingTransactionRef
  2. Status changes to "TICKET IN PROCESS"
  3. Admin processes within 20 minutes
  4. Monitor status using flight-details API
  5. 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-details

Key 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