1. Refund APIs
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
        POST
      • CheckRefundPricing
        POST
      • RefundRequest
        POST
      • CheckRefund
        POST
      • CheckReimbursed
        POST
      • DownloadAttachmentFile API
        POST
      • UploadAttachmentFile API
        POST
    • 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. Refund APIs

CheckRefund

POST
/json/refund-api/checkRefund

Function#

This API is used to inquire about the progress of the refund order refund. The purchaser initiates a request based on the refund order number. After the application and verification is successful, the refund progress information will be returned.

Error Code List#

error codeerror messagedescription
0oksuccess
S001System errorSystem error
P001xxx is illegalillegal parameter
P001xxx is missingmissing parameters
B002Partner is not existsPartner is not exists
B003Illegal signIllegal signature
B048Invalid buyerinvalid buyer
B035Concurrency limited. Please contact PKFARE API support team for assistant.Concurrency limited. Please contact PKFARE API support team for assistant.
B037Order is not existOrder is not exist
B141Order is not a refund order.Order is not a refund order.

Request

Body Params application/json

Example
{
    "authentication": {
        "partnerId": "",
        "sign": ""
    },
    "data": {
        "orderNum": "916783298501993902"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.pkfare.com/json/refund-api/checkRefund' \
--header 'Content-Type: application/json' \
--data '{
    "authentication": {
        "partnerId": "",
        "sign": ""
    },
    "data": {
        "orderNum": "916783298501993902"
    }
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "data": {
        "airPnr": "7C/Z4UPFY",
        "createTime": "2024-04-28 00:58:53",
        "journeys": [
            {
                "arrivalDate": "2024-05-04",
                "arrivalTime": "23:45",
                "departureDate": "2024-05-04",
                "departureTime": "21:10",
                "journeyTime": 275,
                "segments": [
                    {
                        "airline": "7C",
                        "arrival": "HAN",
                        "arrivalDate": "2024-05-04",
                        "arrivalTerminal": "1",
                        "arrivalTime": "23:45",
                        "bookingCode": "H",
                        "cabinClass": "Economy",
                        "codeShare": "0",
                        "departure": "ICN",
                        "departureDate": "2024-05-04",
                        "departureTerminal": "1",
                        "departureTime": "21:10",
                        "equipment": "7M8",
                        "flightNum": "2803",
                        "flightTime": 275,
                        "opFltAirline": ""
                    }
                ]
            }
        ],
        "orderNum": "917141403397252302",
        "orderStatus": "REFD_RQ",
        "parentOrderNum": "917141403397252301",
        "passengerPriceList": [
            {
                "birthday": "1994-06-30",
                "cardType": "",
                "firstName": "quang ninh",
                "lastName": "Pham",
                "nationality": "VN",
                "psgType": "ADT",
                "segmentList": [
                    {
                        "airPnr": "7C/Z4UPFY",
                        "arrival": "HAN",
                        "bookingCode": "H",
                        "cabinClass": "Economy",
                        "departure": "ICN",
                        "flightNum": "7C2803",
                        "pnr": "5KAK9C",
                        "segmentNo": 1,
                        "ticketNum": "8062022260623"
                    }
                ],
                "sex": "M"
            }
        ],
        "platingCarrier": "7C",
        "pnr": "5KAK9C",
        "refOrderNum": "9171414033972523",
        "refundReason": 0,
        "refundType": 0
    },
    "errorCode": "0",
    "errorMsg": "ok"
}
🟢200Error
Modified at 2025-02-24 02:21:21
Previous
RefundRequest
Next
CheckReimbursed