HK Ramble
  1. Booking
HK Ramble
  • Booking Flow
  • Booking
    • Search
      POST
    • Verify
      POST
    • Order
      POST
    • Pay
      POST
    • Confirm
      POST
    • SSR
      POST
    • OrderDetail
      POST
  • Change
    • ChangePricePush
      POST
    • ChangeResultPush
      POST
  • IssueNofity
    • IssueNotify
      POST
  1. Booking

Pay

POST
/json/pay
erroCode erroMsg Description
0 ok Request has been processed successfully.
P001 - Wrong parameter
S001 System error System error
310 Retrieve PNR failed, please try again. Retrieve PNR failed
B002 Partner is not exists PartnerID does not exist
B003 Illegal sign Illegal sign. Please check your signature
B009 Order status is invalid Order status is invalid
B010 The order was not found The order was not found.
B026 Latest_tkt_time will be expired within 1 hour. Latest ticketing time will be expired within 1 hour.
B101 supplier status is invalid Supplier is offline.
B102 Segment status is invalid. Segment status is invalid.
B103 No airline PNR existed, please try again. No airline PNR exist.
B104 Flight No. in PNR is not match with the one in the order Flight No. in PNR is not match with the one in the order .
B105 Passenger No. in PNR is not match with the one in the order Passenger No. in PNR is not match with the one in the order.
B106 No price PNR has no filed fare.
B107 Fare changed, and update order failed. Please try again. Fare changed, and update order failed.
B108 Supplier has cross the day, fare is not guaranteed. Supplier had crossed the day, fare is not guaranteed.
B109 Supplier has cross the day, and price has changed Supplier had crossed the day, and price has changed.
B112 The order has been paid before, please update status accordingly. The order had been paid before.
B113 Filed fare in PNR is not match with the price in the order, and price has changed. Filed fare in PNR is not match with the price in the order, and price had changed.
B114 Flight changed Flight changed
B115 Latest_tkt_time has expired. Latest ticketing time is expired.
B116 Price changed Price had changed
B117 Order Pricing failed Caused by other reasons, please connect administrator
B118 PNR status is invalid PNR status is invalid
B119 Order Pricing failed, please try again LCC content: Pre-check before payment failed. Please try again
B120 Order Pricing failed Supplier saved booking failed.

Request

Body Params application/json
authentication
object 
required
partnerId
string 
required
sign
string 
required
orderPricing
object 
required
orderNum
string 
required
currency
string 
required
totalPrice
number 
required
Example
{
    "authentication": {
        "partnerId": "9y1hYW6AQv4QcCs95wsuMNSzHwc=",
        "sign": "0d83b8d315788029b979d10b67192b31"
    },
    "orderPricing": {
        "orderNum": "11032504410312",
        "currency": "USD",
        "totalPrice" : 312.99
    }
}

Request 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 --request POST '/json/pay' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authentication": {
        "partnerId": "9y1hYW6AQv4QcCs95wsuMNSzHwc=",
        "sign": "0d83b8d315788029b979d10b67192b31"
    },
    "orderPricing": {
        "orderNum": "11032504410312",
        "currency": "USD",
        "totalPrice" : 312.99
    }
}'

Responses

🟢200Success
application/json
Body
java.lang.Object
errorCode
string 
required
Example:
0
errorMsg
string 
required
Example:
ok
data
object (OrderPricingResp) 
optional
java.lang.Object
orderResult
object (OrderResult) 
required
java.lang.Object
pricingResult
object (PricingResult) 
required
java.lang.Object
Examples
{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": {
        "pricingResult": {
            "solution": {
                "fareType": "PRIVATE",
                "currency": "CNY",
                "adtFare": 2862,
                "adtTax": 1211,
                "chdFare": 0,
                "chdTax": 0,
                "qCharge": 0,
                "tktFee": 0,
                "platformServiceFee": 0,
                "journeys": {
                    "journey_0": [
                        "f5deaeeae1538fb6c45901d524ee2f98"
                    ]
                },
                "merchantFee": 0,
                "adults": 1,
                "children": 0,
                "infants": 0
            },
            "flights": [
                {
                    "flightId": "f5deaeeae1538fb6c45901d524ee2f98",
                    "journeyTime": 360,
                    "transferCount": 1,
                    "lastTktTime": "2023-11-09 13:47:00",
                    "segmengtIds": [
                        "def32e56f53ad461c6437c0d237ae6db",
                        "4abffb5c6b36b9a366075d4726460a66"
                    ]
                }
            ],
            "segments": [
                {
                    "segmentId": "def32e56f53ad461c6437c0d237ae6db",
                    "airline": "VJ",
                    "flightNum": "896",
                    "cabinClass": "ECONOMY",
                    "bookingCode": "I",
                    "availabilityCount": 3,
                    "departure": "DEL",
                    "arrival": "SGN",
                    "departureDate": 1701273900000,
                    "arrivalDate": 1701296400000,
                    "flightTime": 285,
                    "codeShare": "N",
                    "strDepartureDate": "2023-11-30",
                    "strDepartureTime": "00:05",
                    "strArrivalDate": "2023-11-30",
                    "strArrivalTime": "06:20"
                },
                {
                    "segmentId": "4abffb5c6b36b9a366075d4726460a66",
                    "airline": "VJ",
                    "flightNum": "632",
                    "cabinClass": "ECONOMY",
                    "bookingCode": "I",
                    "availabilityCount": 3,
                    "departure": "SGN",
                    "arrival": "DAD",
                    "departureDate": 1701336000000,
                    "arrivalDate": 1701340500000,
                    "flightTime": 75,
                    "codeShare": "N",
                    "strDepartureDate": "2023-11-30",
                    "strDepartureTime": "17:20",
                    "strArrivalDate": "2023-11-30",
                    "strArrivalTime": "18:35"
                }
            ],
            "ancillary": [
                {
                    "lastName": "WANG",
                    "firstName": "ZI",
                    "psgType": "ADT",
                    "ancillaries": {
                        "baggage": [
                            {
                                "ancillaryType": 1,
                                "payBaggageType": 1,
                                "baggagePiece": 2,
                                "baggageWeight": "36KG",
                                "baggageCurrency": "CNY",
                                "baggagePrice": 95,
                                "journeys": [
                                    {
                                        "airline": "VJ",
                                        "flightNum": "896",
                                        "departure": "DEL",
                                        "departureDate": "2023-11-30",
                                        "departureTime": "00:05",
                                        "arrival": "SGN",
                                        "arrivalDate": "2023-11-30",
                                        "arrivalTime": "06:20",
                                        "bookingCode": "I"
                                    },
                                    {
                                        "airline": "VJ",
                                        "flightNum": "632",
                                        "departure": "SGN",
                                        "departureDate": "2023-11-30",
                                        "departureTime": "17:20",
                                        "arrival": "DAD",
                                        "arrivalDate": "2023-11-30",
                                        "arrivalTime": "18:35",
                                        "bookingCode": "I"
                                    }
                                ]
                            }
                        ]
                    }
                },
                {
                    "lastName": "WANG",
                    "firstName": "ZI",
                    "psgType": "ADT",
                    "ancillaries": {
                        "seat": [
                            {
                                "ancillaryType": 2,
                                "seatName": "46A",
                                "column": "A",
                                "row": "46",
                                "seatCurrency": "CNY",
                                "seatPrice": "40.00",
                                "characteristics": [
                                    "middle"
                                ],
                                "segment": [
                                    {
                                        "airline": "VJ",
                                        "departure": "DEL",
                                        "departureDate": "2023-11-30",
                                        "departureTime": "00:05",
                                        "arrival": "SGN",
                                        "arrivalDate": "2023-11-30",
                                        "arrivalTime": "06:20",
                                        "flightNum": "896",
                                        "bookingCode": "I"
                                    }
                                ],
                                "buyerOrder": "23146"
                            },
                            {
                                "ancillaryType": 2,
                                "seatName": "15A",
                                "column": "A",
                                "row": "15",
                                "seatCurrency": "CNY",
                                "seatPrice": "40.00",
                                "characteristics": [
                                    "middle"
                                ],
                                "segment": [
                                    {
                                        "airline": "VJ",
                                        "departure": "SGN",
                                        "departureDate": "2023-11-30",
                                        "departureTime": "17:20",
                                        "arrival": "DAD",
                                        "arrivalDate": "2023-11-30",
                                        "arrivalTime": "18:35",
                                        "flightNum": "632",
                                        "bookingCode": "I"
                                    }
                                ],
                                "buyerOrder": "23147"
                            }
                        ]
                    }
                }
            ]
        },
        "orderResult": {
            "orderNum": "10972501310072",
            "pnr": "A8GS1Q"
        }
    }
}
Modified at 2025-02-13 08:15:08
Previous
Order
Next
Confirm
Built with