Driver Info Push
Update Date: 2021-05-20 Mandatory Online test(Sandbox)
Summary
- This interface is used to confirm the driver's information of the corresponding order. If the Vendor does not receive the return message from Ctrip, the vendor should retry 3 times in 5 seconds. This interface can also be used to change the driver's information before the service start.
- Ctrip will verify the correctness of the country code, phone number, car model, and car plate number in the request content.
API address
API address Format: {Domain}/JNT-{vendorID}/driver/push/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}
Request Payload
PushDriverRequest
| Parameter | Type | Required | Description | Example | Note |
|---|---|---|---|---|---|
| ctripPurchaseOrderID | Long | Y | Ctrip Purchase Order ID | 881823967638342968 | 18 digital |
| vendorOrderID | String | Y | Vendor's Order ID | Provide by Vendor | |
| driverName | String | Y | Driver Name | Jason Wang | |
| driverPhone | String | Y | Real Driver Phone Number | 13161453199 | |
| driverPhoneCode | String | Y | Driver phone country calling Code | +86 | |
| vehicleNumber | String | Y | Vehicle Plate Number | 沪A501Z9 | |
| vehicleBrand | String | Y | Vehicle Brand Name | Buick | |
| vehicleBrandDetail | String | N | Vehicle Brand Series | GL8 | |
| vehicleColor | String | Y | Vehicle Color | Black | |
| dispatcher | Boolean | N | Real Driver or Customer Service Specialist | True | True:Customer Service Specialist; False:Driver |
Response Payload
PushDriverResponse
| Parameter | Type | Required | Description | Example | Note |
|---|---|---|---|---|---|
| msgCode | String | Y | Response Code | OK | Response Code |
| message | String | N | Response Detail | Success | Response Code |
Request Example
{
"ctripPurchaseOrderID": 881824251234566368,
"vendorOrderID": "42434223",
"driverName": "黎师傅",
"driverPhone": "17817123456",
"driverPhoneCode": "+86",
"driverPhoneLangauge": "中文",
"vehicleNumber": "沪A888888",
"vehicleBrand": "别克",
"vehicleBrandDetail": "君威",
"vehicleColor": "白色"
}
Response Example
{
"msgCode": "OK",
"massage": "成功"
}
Error Example
{
"msgCode": "ERROR_ORDER_NOT_FOUND",
"massage": "找不到携程单号"
}