Create order

post

https://open.fusionconnectgroup.com/openapi/v1/glink/booking/createOrder

Overview

Create a G-Link hotel order after Trial booking confirms the selected product can be booked.

When to use

The traveler has supplied required guest and contact details.
Trial booking has just succeeded for the actual booking payload.

What you get

G-Link order identifiers and a pending-payment booking state when the order is created.

Required flow

Run Trial booking with the actual room quantity.
Create the order with business fields only.
After local payment succeeds, call Pay order.
Receive the primary confirmation through the order-status callback; use Query order details only as a low-frequency compensation path.

Integration notes

Preserve coOrderCode and fcOrderCode when returned. Do not treat successful HTTP status alone as a booking result; evaluate the response code and business data.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Pass the business request body directly. Do not wrap it in header / businessRequest.

language

string

Language. zh-CN for Chinese and en-US for English. Defaults to English.

requestId

string

Request ID

hotelId

integer

required

Hotel ID

roomId

integer

required

Room ID

ratePlanId

string

required

Rate plan ID

supplyCode

string

required

Supplier code

roomNum

integer

required

Number of rooms

checkInDate

string

required

Check-in date in yyyy-MM-dd format.

checkOutDate

string

required

Check-out date in yyyy-MM-dd format.

totalAmount

number

required

Total order amount returned by trial booking.

coOrderCode

string

required

Partner order number. The order number must be unique.

payAtHotelFlag

integer

Pay-at-hotel flag: 1 - yes; 0 - no. Returned by the real-time product query API and required when the product is pay-at-hotel. This field is not validated during order creation and must not be used to determine the actual settlement or payment method.

guaranteeFlag

integer

Guarantee flag: 1 - guaranteed; 0 - not guaranteed. Defaults to not guaranteed.

isVipOrder

integer

VIP order flag: 1 - VIP order; 0 - non-VIP order.

travelType

integer

Travel type: 1 - business; 2 - personal.

bedType

string

Bed type code. See dictionary item: Bed Type. Recommended when the rate plan returns bed type information. Join multiple values with commas.

breakfastNum

integer

required

Number of breakfasts. Must match the value returned by trial booking. See dictionary item: Breakfast Quantity.

payStatus

integer

required

Payment status: 0 - pending payment; 1 - paid.

numberOfAdults

integer

required

Adults per room

numberOfChildren

integer

Children per room

childrenAges

string

Children ages. Required when numberOfChildren is not empty, and the number of ages must match numberOfChildren. Separate multiple ages with commas. Example: numberOfChildren=2 and childrenAges="1,2" means two children aged 1 and 2. Use 0 for children younger than 1 year old.

priceItems

array of objects

required

Price details

priceItems*

guestInfos

array of objects

required

guestInfos*

linkMan

string

required

Contact name

linkPhone

string

required

Contact phone number

linkInterCode

string

Contact phone country code, for example 86.

linkEmail

string

Email. Required when the invoice type is electronic general VAT invoice or electronic special VAT invoice.

arriveTime

string

required

Arrival time in HH:mm format. For hourly rooms, this is the start time of the stay period, on the hour or half hour.

latestArriveTime

string

required

Latest arrival time in HH:mm format. For hourly rooms, this is the end time of the stay period, on the hour or half hour.

specialDemand

string

Special request from the guest to the hotel.

nationality

string

Country/region alpha-2 code. See ISO Country/Region Code in the dictionary.

serviceCharge

number

Service charge

channelName

string

Channel name

operator

string

Operator

remark

string

Remark. This is a reserved field and is blank by default. Also used as invoice remarks.

Responses

200The platform has completed authentication and downstream forwarding. When code=SUCCESS, data contains the Glink business response object. Supplier business failures may still return HTTP 200 with code=SUPPLIER_BIZ_ERROR.

401Unified authentication failed. May return APP_KEY_INVALID, SIGN_ERROR, TIMESTAMP_EXPIRED, NONCE_REPLAY.

403Application status, product entitlement, vendor mapping, or IP whitelist verification failed.

404The interface route does not exist. Usually indicates a request method or path mismatch.

500Platform internal error.

502The downstream supplier is unavailable, the return structure is illegal, or the platform runtime adaptation fails.

504Downstream supplier timed out.