Scenario

A customer submits check-in information on Fliggy which will trigger booking an order to external vendor’s system.

Requirements

1. Carry out idempotence according to the order No. of Fliggy which means that the same result is returned even the interface is called several times for the same order request and no repeated booking is made in CRS.
2. It is not required that the booking result will be immediately returned. Asynchronous processing will be realized after successful feedback receiving.
3. The processing capacity should be reasonably evaluated and disclosed. Fliggy will launch flow according to performance requirements.
   The third-party system implements the trial order method according to the definition of the interface and shifts it into service. The Fliggy system will create an order by calling the third party booking request service when the user places an order.

Method to receive the interface called by Fliggy

1. The third party provides a service address for receiving request from Fliggy (notes: all interface requests share the same address) and the user name and password for the purpose of validation.
2. Kindly to distinguish different request types through root element of xml request structure, and handle request/response according to criteria belowed.

Request URL

POST https://{vendor's host}/createOrder

Request parameters

O: Optional; R: Required; SR: Special Required

XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CreateOrderRequest>
	<AuthenticationToken>
		<Username>taobao</Username>
		<RequestTimestamp>1499927639</RequestTimestamp>
		<Signature>8a52844e60f67107492d61453976c4c18a4db44e35d4ae9175359515ad0183e4</Signature>
	</AuthenticationToken>
	<CheckIn>2017-08-06</CheckIn>
	<CheckOut>2017-08-07</CheckOut>
	<RateKey>W</RateKey>
	<RateCode>20170807</RateCode>
	<RateCategory>1</RateCategory>
	<RoomTypeCode>20170806</RoomTypeCode>
	<HotelCode>sell</HotelCode>
	<PaymentType>1</PaymentType>
	<PaxNameRooms>
		<PaxNameRoom>
			<RoomIndex>1</RoomIndex>
			<Adults>2</Adults>
			<Children>0</Children>
			<PaxNames>
				<PaxName>
					<Surname>YE</Surname>
					<Name>ZHENMIING</Name>
					<Type>Adults</Type>
                                        <UserCountry>CN</UserCountry>
				</PaxName>
				<PaxName>
					<Surname>FU</Surname>
					<Name>GUIJIN</Name>
					<Type>Adults</Type>
                                        <UserCountry>CN</UserCountry>
				</PaxName>
			</PaxNames>
		</PaxNameRoom>
	</PaxNameRooms>
	<TaoBaoHotelId>15240016320</TaoBaoHotelId>
	<TaoBaoRoomTypeId>38661148784</TaoBaoRoomTypeId>
	<TaoBaoOrderId>26521149070581666</TaoBaoOrderId>
	<specialRequest>Two Single Beds</specialRequest>
        <CurrencyCode>USD</CurrencyCode>
	<TotalPrice>77.21</TotalPrice>
        <PaidPrice>77.21</PaidPrice>
	<ContactSurname>YE</ContactSurname>
	<ContactName>ZHENMIING</ContactName>
	<ContactEmail>957218821@qq.com</ContactEmail>
	<ContactPhone>15324233331</ContactPhone>
        <Country>CN</Country>
</CreateOrderRequest>

Return result

XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CreateOrderResponse>
	<ResponseTimestamp>32423532523</ResponseTimestamp>
	<TaoBaoOrderId>3236564218054628</TaoBaoOrderId>
</CreateOrderResponse>

FAQ