Meeting Points

Point-to-point support: Not required

Update Date: 2025-06-04 Recommendatory Online test(Sandbox)

Summary

  1. This interface is used by suppliers to set the location where your driver will meet the customer.
  2. 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 Y 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.If there is text on the image, it should be in English. https://example.com/arrival_hall.jpg Limited to 1000 characters. 
description String Y A caption to be displayed alongside the image, it should be in English 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"
}

results matching ""

    No results matching ""