Penalty V4

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

Version	Sandbox Invoking Address	Update
Penalty	https://api.pkfare.com/penalty
Penalty_V2	https://api.pkfare.com/penaltyV2	Add solutionId to enhance tracebility and visibility
Penalty_V2(json format)	https://api.pkfare.com/json/penaltyV2	Add solutionId to enhance tracebility and visibility; Support json formatted requesting strcuture
Penalty_V3(json format)	https://api.pkfare.com/json/penaltyV3	Add fare rules for different product tags, including PKFARE-defined special product types and airline-standard branded fares, etc.
Penalty_V4(json format)	https://api.pkfare.com/json/penaltyV4	Retrieves applicable penalty information using the Brand Fare and MultiTag information associated with the selected priced solution.

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

Example

{
	"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

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

Examples

Success response with remarkSuccess response with penalty text

{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": {
        "penalties": [
            "Refer to structured rules."
        ]
    }
}

Function#

Versioning#

Error Code List#

Request

Request Code Samples

Responses

Function

Versioning

Error Code List