订单API> 订单验证 Order verification

接口说明 Interface description

提供方:供应商

调用方: 携程

下单验证接口在客人下单时提前将下单信息提交给供应商系统进行校验,及时告知客人是否可以预定成功,有助于提高订单预定成功率和提升客人预定体验。

注:涉及用户下单实时响应,接口性能要求较高, 接口响应速度需 3s 内返回验证结果。

供应商接口返回码:务必优先匹配携程提供的标准错误码,并返回真实的失败原因(重要)。

Provider: supplier

Caller: ctrip

The order verification interface submits the order information to supplier system in advance for verification when the order is placed, and promptly informs customer whether the reservation is successful, it improves the order reservation success rate and enhances the booking experience of the customer.

Note: When it comes to the real-time order placing response, the higher performance requirement isneeded for the interface, which is suppose to be responded within 3 seconds to return the verification result.

The returne code of supplier's interface: Be sure to match the standard error code provided by Ctrip first, and return the real failure reason (Important).

{
	"header": {
		"accountId": "xiecheng",
		"serviceName": "VerifyOrder",
		"requestTime": "2017-01-05 10:00:00",
		"version": "1.0",
		"sign": "374d95774f17c3e354e73f7aaf21b5ec"
	},
	"body": {
		"sequenceId": "20171010abcd95774f17c3e354e73f7aaf21b5ec",
		"contacts": [{
			"name": "联系人",
			"mobile": "13000000000",
			"intlCode": "",
			"optionalMobile": "13000000000",
			"optionalIntlCode": "",
			"email": ""
		}],
		"items": [{
			"PLU": "test-plu-1",
			"useStartDate": "2017-02-04",
			"useEndDate": "2017-02-04",
			"price": 100,
			"priceCurrency": "",
			"cost": 90,
			"costCurrency": "",
			"quantity": 1,
			"passengers": [{
				"name": "出行人",
				"firstName": "",
				"lastName": "",
				"mobile": "13100000000",
				"intlCode": "",
				"cardType": "",
				"cardNo": "",
				"birthDate": "",
				"ageType": "",
				"gender": "",
				"nationalityCode": "CN",
				"nationalityName": "中国",
				"cardIssueCountry": "中国",
				"cardIssuePlace": "上海",
				"cardIssueDate": "2016-12-12",
				"cardValidDate": "2020-12-12",
				"birthPlace": "上海",
				"height": 175,
				"weight": 80,
				"myopiaDegreeL": 200,
				"myopiaDegreeR": 200,
				"shoeSize": 42
			}],
			"adjunctions": [{
				"name": "取件点",
				"nameCode": "name-qjd",
				"content": "虹桥机场",
				"contentCode": "content-123"
			}]
		}]
	}
}
          
{
	"header": {
		"resultCode": "0000",
		"resultMessage": "验证成功"
	},
	"body": {
		"items": [{
			"PLU": "test-plu-1",
			"inventorys": [{
				"useDate": "2017-02-04",
				"quantity": 0
			}]
		}]
	}
}
          

供应商接口返回码The returne code of supplier's interface

证件类型Identification document type