Ctrip Create/Reply Event Interface

Point-to-point support: Optional

Update Date: 2026-07-01 mandatory Online test(Sandbox)

Summary

  1. This interface is used for Ctrip to initiate event tickets to partners, including customer service events and penalty events.
  2. Customer service events only support one request and one reply, not multi-round communication. That is, Ctrip initiates event → partner replies to event, partner initiates event → Ctrip replies to event, and the event is closed after reply
  3. Penalty events support multi-round communication, such as: Ctrip initiates penalty → partner initiates appeal → Ctrip replies to appeal → partner continues to appeal until reaching the maximum number → penalty execution result notification

API Address

Address Format:  {Domain}/JNT/createorderevent/2.0/{timeStamp}/{sign}

Request Payload

CancelOrderRequest

Parameter Type Required Description Example Note
ctripPurchaseOrderID Long Y Ctrip Purchase Order ID 881823967638342968 18 digits
masterOrderId Long Y Ctrip User Order ID 12744251457  
vendorOrderId String N Vendor Order ID Required for customer service event, may be empty for penalty event  
parentCategoryCode String N Product line: Airport-Station jnt, Coach day, Taxi rtn May be empty for penalty without order  
serviceProviderId Long Y Service Provider ID    
ctripEventId Long Y Ctrip Event unique ID or Penalty unique ID, new id for each event interaction, fixed id for penalty    
ctripOldEventId Long N Used for event reply scenario, indicating which event is being replied to    
eventSource Integer Y Event Source: 1-Customer Service Event, 2-Penalty Event    
content String Y Event ticket notification or reply content, or penalty ticket content (max 1200 characters), supports HTML syntax    
eventSubject String N Event subject, automatic summary of content by system for quick preview, only has value when eventSource=1 Multiple tags separated by \ ; e.g., "Driver Late\ Poor Service Attitude\ Hard to Find Transfer Point"  
deadLine String Y Reply deadline or appeal deadline under penalty, format "yyyy-MM-dd HH:mm:ss", empty if penalty is not appealable    
eventDetail EventDetailDTO N Customer service event details, required when eventSource=1    
punishDetail PunishDetailDTO N Penalty details, required when eventSource=2    
enclosure List<EnclosureDTO> N Attachment, penalty does not include attachments    

EventDetailDTO

Parameter Type Required Description Example Note
eventTypeId Integer Y Event Type ID    
eventTypeName String N Event Type Name, e.g., Driver Late    
operator String N Handler ID, e.g., S60805    
singleCallBack Bool N Receipt result, usually used for verification events, true=confirmed/agree, false=not confirmed/disagree    

PunishDetailDTO

Parameter Type Required Description Example Note
noticeType Integer Y 1 for penalty change, 2 for penalty appeal reply    
appealId long N Appeal ID, not empty when appealable=1, need to carry this id when appealing    
punishCreateTime string Y Penalty creation time, yyyy-MM-dd HH:mm:ss    
maxAppealTime Integer Y Maximum appeal times    
appealTime Integer Y Already appealed times    
punishContentDetail List<PunishContent> Y Penalty details    
appealReplyContent string N Content of appeal reply, max 500 characters    
surplusAppealCount Integer Y Remaining appealable times    
appealable Integer Y Appeal status: 0-not appealable, 1-appealable    
appealStatus string Y appealing-awaiting appeal object processing, auditing-awaiting appeal specialist reply, failed-appeal failed, passed-appeal succeeded    
appealResult String Y Appeal result    
firstFoulReasonCode String Y Primary violation reason code    
firstFoulReasonName String Y Primary violation reason name    
secondFoulReasonCode String Y Secondary violation reason code    
secondFoulReasonName String Y Secondary violation reason name    
appealReason List<AppealLabelDTO> Y Optional appeal reasons and codes    
punishOrderStatus Integer Y Penalty order status: 0-pending execution, 1-executed, 2-cancelled    
punishObjectType Integer Y Penalty object type: 1-driver, 2-supplier, 3-both    
punishTargetId String Y Penalty object ID    

EnclosureDTO

Parameter Type Required Description Example Note
fileType String Y File type (lowercase), see file type tab    
fileName String Y File name    
fileUrl string N File address    

PunishContent

Parameter Type Required Description Example Note
punishWeight String Y Penalty weight, numeric string    
punishWeightUnit String Y Penalty weight unit, time unit: point points, hour hours, day days; currency unit: CNY Chinese Yuan, USD US Dollar, etc.    
punishWeightUnitType String Y Penalty weight unit type: point, time, currency, percent (percentage of order amount penalty)    
punishWay String Y Penalty method: 1-fine, 2-offline, 3-freeze; latter two methods are time-based    

AppealLabelDTO

Parameter Type Required Description Example Note
labelCode String Y Label code    
labelName String Y Label name    
needAppealCertificate bool Y Whether certificate is required    
appealCertificateRequirement String Y Material requirement description    
tips list<String> N Other tips    

Response Payload

CancelOrderResponse

Parameter Type Required Description Example Note
msgCode String Y Response Code OK Response Code
message String N Response Detail Success Response Code
vendorEventId String Y Vendor's Event ID (for troubleshooting only)    

Request Example

{
    "ctripPurchaseOrderId": 145904152397791301,
    "masterOrderId": 29111813706,
    "vendorOrderId": "23C4Q5K9SKWTW32",
    "parentCategoryCode": "jnt",
    "serviceProviderId": "1000009",
    "ctripEventId": 231943412,
    "eventSource": 1,
    "content": "Customer indicated: We will arrive at Shanghai Hongqiao Station at 7:45, and we should reach the parking lot by around 8:00. Please ask driver Wang to arrive on time at the parking lot location and tell us which parking lot. Don't be late as we have other matters afterward. Please notify the driver to provide timely service and contact the customer in advance. I couldn't reach the driver at our contact phone number. Thank you.",
    "deadLine": "2023-12-28 15:47:37",
    "eventDetail": {
        "eventTypeId": 8892,
        "eventTypeName": "Driver Service Feedback",
        "operator": "N14604"
    },
    "ctripParentEventId": "231943412"
}

Response Example

{
    "msgCode": "OK",
    "massage": "Success",
    "vendorEventId":"21139262"
}

Error Example

{
    "msgCode": "Error",
    "massage": ""
}

results matching ""

    No results matching ""