Non-Real-Time Transaction Synchronization

The scheme can achieve synchronization of Alitrip orders to the merchant systems, while supporting the merchant to modify the Alitrip order statuses via APIs in order to promote the order procedure. The non-real-time transaction order synchronization and matchmaking scheme is illustrated as the following flow diagram. The dashed line box in the diagram refers to an optional procedure:

Order creation

The Alitrip system notifies a merchant of a new order; the merchant acquires order information and creates a corresponding order on the merchant system. A merchant acquires order information from the Alitrip platform through the following two steps:
Step 1, Acquire the transaction order id on the Alitrip platform.

• Recommended scheme: Subscribe message service on the Taobao open platform: alitrip_travel_OrderChanged. When there are new orders or payments on the Alitrip platform, the message service will actively notify the merchant system of the new orders and attach order ids on the Alitrip platform. Advantage of the scheme: real-time; disadvantage: message delay, loss or repetition may occur, which requires merchants to deal with these exceptions.
• Alternative scheme: the merchant system regularly invokes the order list search interface to acquire unprocessed orders: alitrip.travel.trades.search. Advantage of the scheme is that the merchant can actively acquire order lists; the disadvantage is that new orders cannot be promptly processed, which requires regular polling.

Step 2: Acquire order details according to Alitrip order ids The merchant can invoke the order details interface (alitrip.travel.trade.query) provided by Alitrip to acquire detailed information of Alitrip orders (such as information on buyers, sellers, and passengers), and create corresponding orders in the merchant system.

Note: Statement of the Message Service

Order delivery

After obtaining and creating corresponding order information, the merchant system needs to process the orders promptly:

• Case 1: Confirm to deliver If the merchant confirms that there are resources for delivering the order, the order delivery interface (alitrip.travel.trade.deliver) provided by the Alitrip platform is required to be invoked to achieve delivery of orders on the Alitrip platform. Particularly, for scenarios where orders are instantly confirmed, the seller does not need to deal with delivery, because orders generated for instantly confirmed items will be delivered automatically after payment by the buyer.
• Case 2: Refuse to deliver If the merchant confirms that there are no resources for delivering the order, the merchant needs to manually contact the buyer to apply for refund. Particularly, for scenarios where the orders are second time confirmed , the Alitrip platform provides the order close interface, i.e., quick refund initiated by the seller (alitrip.travel.trade.close), to achieve automatic close of orders unable to be delivered by the seller and quickly refund to the buyer.

Note: Statement of Instant Confirmation and Second Time Confirmation

Order cancellation by users

If a buyer initiates a refund for a paid order on the Alitrip platform, the Alitrip system will notify the merchant of this refund request, and then the merchant needs to initiate cancellation and deal with the order in his own system. There are also two schemes for this scenario:

• Recommended scheme: Subscribe message service on the Taobao open platform: alitrip_travel_OrderChanged. When there are orders applied for refund on the Alitrip platform, the message service will actively notice the merchant system.
• Alternative scheme: the merchant system regularly invokes the order list search interface (alitrip.travel.trades.search) to acquire and deal with refunded orders.

Alitrip vacation transaction API opens

Order message service - alitrip_travel_OrderChanged

• Alitrip vacation transaction order message notice service, if a merchant subscribes to the message service, then it will send a notice to the merchant app when Alitrip vacation order status changes. Currently supported message generating conditions: order generated, order paid, order closed.

Order search interface - alitrip.travel.trades.search

• Alitrip vacation transaction order search service performs search based on the time the orders were created, and supports filtering according to the order statuses. Extending fields are reserved to support more filter conditions.

Order detail interface - alitrip.travel.trade.query

• Acquire details of an order according to the main order id: main order details (base information + payment information + preferential information + buyer information + seller information) + suborder details (item information (including specific extended information of each transaction order) + passenger information + contact information). The order detail interface is a universal interface, it supports orders of transaction types such as vacation, tickets, visas (not supported yet), etc.
• Some user privacy information fields are obscured, safety conditions of the group needs to be satisfied to obtain cleartext data. For specific matchmaking safety improvement please refer to: (TBD)

Order delivery interface - alitrip.travel.trade.deliver

• Non-shipment virtual item delivery interface achieves confirmation of delivery of a suborder by the seller. The following transaction types are supported:

1. Second time confirmation of order: second time confirmation of orders are supported to do resource confirmation succeeded actions (the order triggers delivery automatically after resource confirmation succeeds)
2. Auto delivery orders of manual e-tickets, self pickup Wi-Fi/phone cards and traffic data top up by sellers are supported.
3. (Reserved, not supported yet) Delivery orders of mailed Wi-Fi/photo cards are supported (shipment is required)

Order close interface - alitrip.travel.trade.close

• A seller initiates to close an order, the following transaction types and cases are supported:

1. Order is paid (rapid refund by the seller): the seller actively closed a paid order, it is opened for specific transactions and individual credit sellers
2. Second time confirmation of order: second time confirmation of orders are supported to do resource confirmation failed actions (the order triggers auto refund after resource confirmation fails)

FAQ

关于此文档暂时还没有FAQ