Meeting Points
Update Date: 2025-06-04 Recommendatory
Online test(Sandbox)
Summary
- This interface is used by suppliers to set the location where your driver will meet the customer.
- If the Vendor does not receive the return message from Ctrip, the vendor should retry 3 times in 5 seconds.
API address
API address Format:
{Domain}/JNT-{vendorID}/order/meetingpoints/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}
Request Payload
MeetingPointsRequest
| 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 |
| name |
String |
N |
The name of the meeting point. |
Starbucks |
Limited to 255 characters. |
| location |
String |
N |
The location of the meeting point. |
Terminal 2A |
Limited to 255 characters. |
| language |
String |
Y |
Language of your description |
en-us |
support only zh-cn/en-us |
| latitude |
BigDecimal |
N |
Latitude |
31.221373 |
6 Decimal Places |
| longitude |
BigDecimal |
N |
Longitude |
121.351145 |
6 Decimal Places |
| pickupImages |
PickupImageDTO |
N |
If images are provided then refer to the below table for the required fields per image |
|
|
PickupImageDTO
| Parameter |
Type |
Required |
Description |
Example |
Note |
| imageUrl |
String |
Y |
The URL pointing to the photo. |
https://example.com/arrival_hall.jpg |
Limited to 1000 characters. |
| description |
String |
N |
A caption to be displayed alongside the image. |
Your driver will be waiting in the arrival hall. |
Limited to 1000 characters. |
Response Payload
MeetingPointsResponse
| 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": 881824212456774814,
"vendorOrderID": "1232423",
"name": "Starbucks",
"location": "Terminal 2A",
"latitude": 53.362414,
"longitude": -2.274370,
"pickupImages": [
{
"imageUrl": "https://example.com/arrival_hall.jpg",
"description": "Your driver will be waiting in the arrival hall."
},
{
"imageUrl": "https://example.com/starbucks.png",
"description": "You will find your driver opposite this Starbucks Coffee shop."
}
]
}
Response Example
{
"msgCode": "OK",
"massage": "Success"
}