Function# Through Penalty API, users can get the refund and reissue/revalidation penalty for specific flight. It needs to be invoked after using PrecisePricing API within 30 minutes (We suggest invoking this API 10 seconds after you get the response of PrecisePricing), and the corresponding fare rule will be responded. Versioning# Error Code List# errorCode errorMsg Description 0 ok request has been processed successfully S001 System error system error P001 - wrong parameter B002 Partner is not exists partnerID does not exist B003 Illegal sign illegal sign. Please check your signature B023 Penalty failed collecting fare rule failed
Request Body Params application/json
{
"authentication" : {
"partnerId" : "{{partnerId}}" ,
"sign" : "{{sign}}"
} ,
"penalty" : {
"solutionId" : "PzUCBPJcbjvM5wqPGyeWnPXeZ2GS3UqgaqwrjuL+2fEBlZeMkErCTwwvYiNazxsbvoqLgOOR356Z4//Z427LAzafqmJynNyOaM6n2toAOEdbnDJRcUmp9tXbkdPd2hWbM9bgS1m1cXJysep1MCoVkzPhWIEYO4ZnyQv+KmY3XlDHl6A/to+8pwEyyRONS7p9RFfrAkT1FRYRDQVh4uZM66xeojCRnfKsH8cwr1yaskW/K1WLaWD4qMiLCgYk6XyczNKCTidYkpCgEgHVpIrQITF26QXQyMhWJzLqXZLH1WUwemyaHD7Xz5tB7q4rsAlv" ,
"journeys" : {
"journey_0" : [ {
"airline" : "FD" ,
"arrival" : "DMK" ,
"arrivalDate" : "2024-12-16" ,
"arrivalTime" : "00:20" ,
"bookingCode" : "X" ,
"departure" : "HKG" ,
"departureDate" : "2024-12-15" ,
"departureTime" : "22:20" ,
"flightNum" : "503"
} ]
} ,
"tag" : "SAVER"
}
} Request Code Samples
curl --location 'https://api.pkfare.com/json/penaltyV3' \
--header 'Content-Type: application/json' \
--data '{
"authentication": {
"partnerId": "",
"sign": ""
},
"penalty":{
"solutionId": "PzUCBPJcbjvM5wqPGyeWnPXeZ2GS3UqgaqwrjuL+2fEBlZeMkErCTwwvYiNazxsbvoqLgOOR356Z4//Z427LAzafqmJynNyOaM6n2toAOEdbnDJRcUmp9tXbkdPd2hWbM9bgS1m1cXJysep1MCoVkzPhWIEYO4ZnyQv+KmY3XlDHl6A/to+8pwEyyRONS7p9RFfrAkT1FRYRDQVh4uZM66xeojCRnfKsH8cwr1yaskW/K1WLaWD4qMiLCgYk6XyczNKCTidYkpCgEgHVpIrQITF26QXQyMhWJzLqXZLH1WUwemyaHD7Xz5tB7q4rsAlv",
"journeys": {
"journey_0": [{
"airline": "FD",
"arrival": "DMK",
"arrivalDate": "2024-12-16",
"arrivalTime": "00:20",
"bookingCode": "X",
"departure": "HKG",
"departureDate": "2024-12-15",
"departureTime": "22:20",
"flightNum": "503"
}]
},
"tag": "SAVER"
}
}' Responses application/json
Generate Code
{
"errorCode" : "0" ,
"errorMsg" : "ok" ,
"data" : {
"penalties" : [
"Refer to structured rules."
]
}
}
Modified at 2026-08-13 06:33:40