1. Guides
PKFARE Flight Buyer API
  • Guides
    • Quick Start
    • Tricks for Playing with PKFARE API
    • Book air tickets with ancillaries
    • Raise refund requests
    • Raise change requests
    • Receive flight rescheduled notification
    • Add Paid Bags after the Booking
    • Branded Fare Integration Guide
  • API Reference
    • Air ticket booking APIs
      • TicketIssuanceNotify_V2
      • Shopping V10
      • PrecisePricing V12
      • Penalty V4
      • PreciseBooking V8
      • CancelOrder
      • OrderPricing V6
      • Ticketing
      • OrderDetail V14
      • RequestTicketing
      • ModifyOrderStatus
    • Ancillary booking APIs
      • AncillaryStatusPush
      • AncillaryPricing V6
      • AncillaryBooking
      • CancelAncillaryOrder
      • AncillaryTicketing
      • AncillaryOrderDetail
    • Flight schedule change APIs
      • ScheduleChangeNotify
      • GetScheduleChangeReply
      • GetScheduleChangeList
      • AcknowledgeScheduleChange
      • AcceptScheduleChange
    • Refund APIs
      • RefundResultNotify
      • ReimbursedResultNotify
      • Refund Pricing
      • CheckRefundPricing
      • RefundRequest
      • CheckRefund
      • CheckReimbursed
      • DownloadAttachmentFile API
      • UploadAttachmentFile API
    • Change APIs
      • ChangeResultPush
      • Change Reshop
      • Change Request
      • Change Passenger Info
      • Change Reprice
      • ChangeRepricePush
    • Void APIs
      • ReimbursedResultPush
      • VoidRequest
    • Cache APIs
      • CacheShopping
      • ValidateItinerary API
    • APIs with all versions
      • CheckInInfoPush
      • Raise change requests Copy
      • Shopping
        • Shopping
        • Shopping_V2
        • Shopping_V4
        • Shopping V7
        • Shopping V9
        • Shopping V8
      • PrecisePricing
        • PrecisePricing
        • PrecisePricing_V2
        • PrecisePricing_V6
        • PrecisePricing V9
        • PrecisePricing V10
        • PrecisePricing V11
      • Penalty
        • Penalty
        • Penalty V2
        • Penalty V3
      • PreciseBooking
        • PreciseBooking
        • PreciseBooking_V2
        • PreciseBooking_V5
        • PreciseBooking V6
        • PreciseBooking V7
      • OrderPricing
        • OrderPricing_V2
        • OrderPricing V4
        • OrderPricing V5
      • Ticketing
        • Ticketing
      • TicketNumPush
        • TicketingNumPush
        • TicketingNumPush_V2
        • TicketingNumPush_V3
        • TicketIssuanceNotify
      • CancelOrder
        • CancelOrder
      • OrderDetail
        • OrderDetail_V2
        • OrderDetail_V3
        • OrderDetail_V4
        • OrderDetail_V5
        • Json_OrderDetail_V7
        • Json_OrderDetail_V8
        • OrderDetail V9
        • OrderDetail V13
      • AncillaryPricing
        • AncillaryPricing
        • AncillaryPricing V5
      • AncillaryBooking
        • AncillaryBooking
      • CancelAncillaryOrder
        • CancelAncillaryOrder
      • AncillaryTicketing
        • AncillaryTicketing_V2
      • AncillaryStatusPush
        • AncillaryStatusPush
      • AncillaryOrderDetail
        • AncillaryOrderDetail
      • RequestTicketing
        • RequestTicketing
      • ScheduleChangeNotify
        • ScheduleChangeNotify
      • GetScheduleChangeList
        • GetScheduleChangeList
      • AcknowledgeScheduleChange
        • AcknowledgeScheduleChange
      • AcceptScheduleChange
        • AcceptScheduleChange
      • GetScheduleChangeReply
        • GetScheduleChangeReply
      • RefundPricing
        • RefundPricing
      • CheckRefundPricing
        • CheckRefundPricing
      • RefundRequest
        • RefundRequest
      • RefundResultNotify
        • RefundResultNotify
      • CheckRefund
        • CheckRefund
      • ReimbursedResultNotify
        • ReimbursedResultNotify
      • CheckReimbursed
        • CheckReimbursed
      • UploadAttachmentFile
        • UploadAttachmentFile
      • DownloadAttachmentFile
        • DownloadAttachmentFile
      • ChangeReshop
        • ChangeReshop
      • ChangeRequest
        • ChangeRequest
      • ChangePassengerInfo
        • ChangePassengerInfo
      • VoidRequest
        • VoidRequest
        • VoidRequest_V2
      • ReimbursedResultPush
        • ReimburseResultPush_V2
  • Development Instructions
    • Signature
    • Order Status Explanation
    • Booking errors explanation and suggestions
    • Price Breakdown Explanation
    • Airlines available from PKFARE
    • PKFARE Operation Notice
    • How to retrieve airlines'PNR and ticket numbers
    • PKFARE Buyer API solutionId Usage Guide
  • Notice
    • Release Note
  • Schemas
    • Schemas
      • ShoppingReq
      • Result«ShoppingResult»
      • Authentication
      • SearchDTO
      • JourneysDTO_1
      • PassengersDTO
      • ShoppingResult
      • SegmentsDTO
      • SolutionsDTO
      • BaggageDTO
      • ConditionsDTO
      • ChangeDTO
      • OtherDTO
      • RefundDTO
      • JourneysDTO
      • SegmentInfoDTO
  1. Guides

Receive flight rescheduled notification

Overview#

💡
Mark had a return journey from HKG to DFW. One of flight get flight change. You have to notify him and check whether he accept the flight change.
To fullfill this, you need to
1.
Notify your customers
2.
Accept the flight changes

1. Notify your customers#

💡
Mark's flight, AA126, got flight changes.
There are two ways to get the flight rescheduled information or flight:
1/ Use ScheduleChangeNotify API: We will push you the notification automatically when flight changes occur.
2/ Use GetScheduleChangeList API: You can input a period of past time to get all the orders that encounter flight change issue; If you acknowledge a certain flight change, you can use AcknowledgeScheduleChange to remove this flight change.
ScheduleChangeNotify Example
{
    "messageId": "1234567",
    "messageCreateTime": "2023-02-22 15:07:10",
    "orderAirlinePnr": "CX/WCK5N6|AA/HMMRAK",
    "orderNum": "916727111389870001",
    "buyerOrder":"10387629"
    "orderPnr": "HMMRRJ",
    "sensitivityLevel": "1",
    "changeFlightList": [
        {
            "journeySeq": "1",
            "segments": [            
                {
                    "airline": "AA",
                    "arrival": "DFW",
                    "arrivalDate": "2023-12-03",
                    "arrivalTime": "16:50",
                    "bookingCode": "C5",
                    "cabinClass": "FIRST",
                    "codeShare": "N",
                    "departure": "HKG",
                    "departureDate": "2023-11-24",
                    "departureTime": "14:20",
                    "equipment": "77W",
                    "flightNum": "126",
                    "stayTime": 0,
                    "stopover": ""
                }
            ]
        }
    ],
    "originFlightList": [
        {
            "journeySeq": "1",
            "segments": [
                {
                    "airline": "AA",
                    "arrival": "DFW",
                    "arrivalDate": "2023-12-02",
                    "arrivalTime": "16:50",
                    "bookingCode": "C5",
                    "cabinClass": "FIRST",
                    "codeShare": "N",
                    "departure": "HKG",
                    "departureDate": "2023-11-26",
                    "departureTime": "14:20",
                    "equipment": "77W",
                    "flightNum": "126",
                    "messageType": "2",
                    "stayTime": 0,
                    "stopover": "",
                    "messageType":2
                }
            ]
        }
    ],
    "passengers": [
        {
            "birthday": "2003-02-12",
            "cardExpiredDate": "2025-02-05",
            "cardNum": "89374924",
            "cardType": "PP",
            "firstName": "MARK",
            "lastName": "ZUO",
            "nationality": "US",
            "psgType": "ADT",
            "sex": "M",
            "ticketNum": "0063742676484"
        },
        {
            "birthday": "2003-04-01",
            "cardExpiredDate": "2025-03-25",
            "cardNum": "293874123",
            "cardType": "PP",
            "firstName": "DARRYL",
            "lastName": "COX",
            "nationality": "US",
            "psgType": "ADT",
            "sex": "F",
            "ticketNum": "0063742676484"
        }
    ]
}
GetScheduleChangeList Example
{
    "data": {
        "messageCreateTimeStart": "2023-02-22 15:00:00",
        "messageCreateTimeEnd": "2023-02-22 16:00:00",
        "orderNum": "916727111389870001",
        "messageId":"1234567",
        "messageType":"2",
        "sensitivityLevel":"2"
    },
    "authentication": {
        "partnerId": "RksVSX7Pk9fZmWYsCD7M4=",
        "sign": "17e707b5d9dae8459k065dbb139e5f1bd"
    }
}

2. Accept the flight changes#

💡
Mark accepted the flight change.
Please use AcceptScheduleChange API to accept the flight change if acceptance is needed. Otherwise, the seat may be cancelled by airlines.
AcceptScheduleChange Request example
{
    "data": {
        "messageId": "1234567",
        "email": "jaylee.li@pkfare.com",
        "passengers": [
            {
                "birthday": "2003-04-20",
                "firstName": "MARK",
                "lastName": "ZUO",
                "nationality": "US",
                "psgType": "ADT", 
                "sex": "M",
                "cardType":"P",
                "cardNum":"P76541234",
                "cardExpiredDate":"2025-05-10"
            }
        ]
    },
    "authentication": {
        "partnerId": "RksVSX7PfyZmWYsCD7M4=",
        "sign": "17e707b5d9dae8e459065dbb139e5f1bd"
    }
}
Modified at 2024-05-10 07:53:49
Previous
Raise change requests
Next
Add Paid Bags after the Booking