Cancel an Order

更新时间：2024/08/19 访问次数：6032

Scene
Requirements
Method to receive the interface called by Fliggy：
Request URL
Request parameters
Return result

Scene

The user cancels an order if the conditions listed in cancel rules are satisfied.
The vendor cancels the order through consultation between the user and the vendor if cancel conditions listed in rules are met.
If the result fails to be obtained for a long time due to abnormal order interface, the vendor cancels compensation after disabling the interface of the user.

Requirements

Carry out idempotence according to the order No. of Fliggy. That means the same result is called several times for the same order and no repeated booking is made in CRS.
It is not required that the booking result will be immediately returned. Asynchronous processing will be realized after successful feedback receiving.

The third-party system implements the order cancel method according to the definition of the interface and shifts it into service. The Fliggy system will cancel the order by calling the order cancel service from the third party in a real time manner.

Method to receive the interface called by Fliggy：

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.
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}/cancelOrder

Request parameters

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

Name	Type	O/R/SR	Limitation	Description	Example
TaoBaoOrderId	long	R		Taobao order id	123455
OrderId	String	O	64	OTA order id or order id in third party system	OTA21544874

XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CancelOrderRequest>
   <AuthenticationToken>
        <Username>taobao</Username>
        <RequestTimestamp>1499927639</RequestTimestamp>
        <Signature>8a52844e60f67107492d61453976c4c18a4db44e35d4ae9175359515ad0183e4</Signature>
    </AuthenticationToken>
       <TaoBaoOrderId>21544874</TaoBaoOrderId>
       <OrderId>21544874</OrderId>
</CancelOrderRequest>

Return result

Name	Type	O/R/SR	Limitation	Description	Example
OrderId	String	R	64	The order id in the OTA system or the third party system	OTA3245534
CancelFee	Decimal	O		The pennalty of the cancellation, if any-deprecated	23.34
CurrencyCode	String	O		The currency code of the penalty amount, if any-	CNY

XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CancelOrderResponse>
       <ResponseTimestamp>32423532523</ResponseTimestamp>
       <OrderId>21544874</OrderId>
       <CancelFee>34.56</CancelFee>
       <CurrencyCode>CNY</CurrencyCode>
</CancelOrderResponse>

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

International Hotel

Cancel an Order

Scene

Requirements

Method to receive the interface called by Fliggy：

Request URL

Request parameters

XML example:

Return result

XML example:

FAQ