发起退票前,先调用退票手续费查询接口查询订单,每个乘车人的退票手续费。接口根据alitripOrderId+passengerCertificateNos幂等。可以每次退部分票、分多次退。退多张票时,要保证原子性,只允许全部成功或者全部失败。如果商家不能同步返回退票状态,则需要退票回填。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
agentOrderId | String | 必须 | 1893330565555 | 分销商订单Id | |
alitripOrderId | String | 必须 | 2000093330455 | 飞猪订单Id | |
passengerList | Passenger [] | 必须 |
|
乘客信息列表 | |
|
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
retDesc | String | success | 业务结果描述(是必填) |
success | Boolean | true | 业务结果(是必填) |
retCode | String | 0 | 业务结果编码(是必填) |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret); AlitripBusReturnConfirmRequest req = new AlitripBusReturnConfirmRequest(); req.setAgentOrderId( "1893330565555" ); req.setAlitripOrderId( "2000093330455" ); List<AlitripBusReturnConfirmRequest.Passenger> list2 = new ArrayList<AlitripBusReturnConfirmRequest.Passenger>(); AlitripBusReturnConfirmRequest.Passenger obj3 = new AlitripBusReturnConfirmRequest.Passenger(); list2.add(obj3); obj3.setPassengerName( "罗大佑" ); obj3.setPassengerCertificateNo( "212100198902171763" ); obj3.setPassengerCertificateType( "1" ); obj3.setRefundSurcharge(50L); obj3.setTicketId( "33330L" ); obj3.setPassengerId( "333k" ); req.setPassengerList(list2); AlitripBusReturnConfirmResponse rsp = client.execute(req); System.out.println(rsp.getBody()); |
1 2 3 | < retDesc >success</ retDesc > < success >true</ success > < retCode >0</ retCode > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|